> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# عمليات استعلام الجداول

> راجع توصيات مخاطر الاستعلام للجداول البطيئة وأكّد تحسينات قاعدة البيانات.

<Tip>متاحة لخطة Business ذاتية الاستضافة والخطط الأعلى</Tip>

المسار: لوحة الإدارة ← عمليات استعلام الجداول

استخدم **عمليات استعلام الجداول** عندما تصبح طرق العرض أو عوامل التصفية أو العلاقات أو عمليات البحث في جدول كبير بطيئة. يراقب محلل في الخلفية حمل الاستعلام ويحوّل ملاحظاته إلى توصيات. تسردها الصفحة حتى يراجع مسؤولو النسخة الأدلة ويحللوا جدولًا محددًا بعمق ويؤكدوا أي تغيير في قاعدة البيانات.

تلخص العدادات أعلى القائمة الوضع الحالي: نوافذ المراقبة والطلبات والاستعلامات البطيئة والمهل المنتهية والتوصيات المفتوحة والمقبولة والمهام الجارية والفاشلة وعدد مسارات الوصول للبحث الجاهزة أو المتدهورة.

## مراجعة التوصيات

تُفتح الصفحة على **التوصيات** مرتبة حسب الأولوية. يوازن المحلل بين مخاطر الاستعلام وكثافة استخدام الجدول، فتظهر أولًا الإدخالات الأجدر بالتنفيذ.

ابحث حسب معرّف الجدول أو قاعدة البيانات أو المساحة لتصفية جميع التوصيات؛ ويصفّي أي نص آخر ما يظهر على الشاشة. وتضيّق عوامل تصفية الحالة والمخاطر القائمة أكثر.

يسمي كل إدخال المساحة وقاعدة البيانات والجدول التابع لها. وسّع صفًا لقراءة الأدلة والتفسير وبيانات SQL التشخيصية:

| القسم              | ما يوضحه                                                                                                                                                          |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **المشغّل**        | مصدر التوصية: حركة استعلام مرصودة أو تهيئة طريقة عرض محفوظة أو تهيئة حقل علاقة. لا يعني مشغّل طريقة العرض المحفوظة رصد استعلام بطيء؛ فالتهيئة وحدها رفعت المخاطر. |
| **مسار الوصول**    | مرات الوصول إلى الجدول بالمسح التسلسلي مقارنة بمسح الفهرس.                                                                                                        |
| **الأسباب**        | أسباب مقروءة مثل كبر الجدول أو غياب فهرس مفيد لحقول التصفية أو الفرز أو ارتفاع تكلفة الفرز أو رصد انتهاء المهلة.                                                  |
| **شكل الاستعلام**  | الحقول المحددة التي تُصفّى وتُرتب ونوع المطابقة المستخدم لكل منها.                                                                                                |
| **الفهرس المقترح** | الحقول التي ستفهرسها التوصية والسبب.                                                                                                                              |

يفتح **التحليل المتعمق** مساحة عمل التحليل مع تعبئة ذلك الجدول مسبقًا.

عندما يرصد المحلل بحثًا كثيفًا بسلاسل فرعية عبر جدول، ينشئ توصية واحدة من نوع **GIN للنص المنشأ** للجدول كله بدل فهرس لكل حقل. يعرض هذا الصف **إنشاء مسار بحث** بدل **التحليل المتعمق**، ولا يظهر **إضافة فهرس** لأن مسار الوصول يُطبق من مساحة التحليل ويتطلب أولًا **نموذج بحث EXPLAIN**. وتُغلق التوصية تلقائيًا بعد حصول الجدول على المسار.

توجد علامتا تبويب إضافيتان بجوارها:

| علامة التبويب      | ما تعرضه                                                                                 |
| ------------------ | ---------------------------------------------------------------------------------------- |
| **الجداول النشطة** | أكثر الجداول انشغالًا مع الطلبات والاستعلامات البطيئة والمهل المنتهية وأطول مدة استعلام. |
| **المهام**         | مهام المعالجة التي أنشأها Teable، مع الحالة والمحاولات والعامل وآخر خطأ.                 |

يظهر شريط أعلى القائمة عندما تعوق مشكلة تهيئة العملية: قد تكون مسارات البحث مهيأة مع تعطيل علامة التشغيل، أو قد تملك بعض الجداول مسارًا قديمًا أو بانتظار إعادة البناء فعاد بحثها بصمت إلى مسح `ILIKE` الأبطأ، أو تكون أقدم مهمة منتظرة قد طال انتظارها بما يوحي بعدم وجود عامل يستهلكها. أصلح ما يورده الشريط قبل تنفيذ التوصيات.

### قراءة شارة القرار

تحمل كل توصية أحدث قرار اتخذه النظام بشأنها:

| الشارة                                        | المعنى                                                                       |
| --------------------------------------------- | ---------------------------------------------------------------------------- |
| **تحتاج إلى تأكيد يدوي**                      | لا يمكن تطبيقها إلا لمسؤول.                                                  |
| **ظل · ستعمل تلقائيًا**                       | تستوفي التوصية معايير القبول، لكن التنفيذ التلقائي غير مفعّل، فلم يتغير شيء. |
| **قيد التنفيذ التلقائي** / **نُفذت تلقائيًا** | قبل التنفيذ التلقائي التوصية وطبقها.                                         |
| **فشل التحقق اللاحق · تراجع مؤقت**            | لم يجتز تغيير تلقائي التحقق. ينتظر Teable مدة أطول قبل إعادة محاولة الجدول.  |
| **فترة تهدئة**                                | تغير النطاق نفسه مؤخرًا، لذا ينتظر النظام.                                   |
| **معلقة** / **لم يُطبق التنفيذ التلقائي**     | لم تبلغ أدلة الخطة أو حجم الجدول حد التنفيذ التلقائي.                        |

<Info>لا يسجل Teable افتراضيًا إلا القرارات وينشئ سجلات التوصيات والمهام، ولا يغير قاعدة بياناتك تلقائيًا. التنفيذ التلقائي اختياري عبر `V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`، وحتى عند تمكينه لا يطبق إلا على الجداول الصغيرة التي تُظهر خطة تنفيذها تحسنًا واضحًا في التكلفة. أما البقية فتنتظر مسؤولًا.</Info>

### إضافة الفهرس المقترح

عندما توافق على فهرس مقترح، انقر على **إضافة فهرس** في الصف. يؤدي التأكيد إلى قبول التوصية وتشغيل `CREATE INDEX CONCURRENTLY` على جدول PostgreSQL الأساسي؛ وإذا جرى تخطي التحقق من الخطة، يبني Teable الفهرس من الحقول الموصى بها. يكرر مربع الحوار الأدلة للمراجعة الأخيرة.

بالنسبة إلى جدول يُقدّر بأنه يضم 50,000 صف أو أكثر، يطلب مربع الحوار تأكيد وجود نافذة صيانة قبل إتاحة الزر. يستغرق البناء المتزامن لجدول كبير وقتًا ويضيف حملًا أثناء التنفيذ.

يعرض Teable بعدها **أُنشئ الفهرس** أو **قُبلت التوصية وأُدرجت في قائمة الانتظار**. في الحالة الثانية، تابع المهمة ضمن **المهام**. إذا لم يكن للتوصية عمود فعلي قابل للتنفيذ، يظل **إضافة فهرس** معطلًا ويوضح السبب؛ استخدم مساحة التحليل لمزيد من البحث.

## إجراء تحليل متعمق

افتح **مساحة عمل التحليل** لتحليل نطاق عند الطلب، مثل إبلاغ مستخدم عن جدول بطيء لا يملك توصية بعد.

| نوع التحليل              | الاستخدام                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **الاستعلامات والفهارس** | العثور على مخاطر الاستعلام وتحسينات الفهرس الممكنة.                                                        |
| **بحث السلسلة الفرعية**  | التحقق مما إذا كان مسار وصول للبحث بسلسلة فرعية يسرّع عمليات البحث «يحتوي على» من دون تغيير سلوك المطابقة. |

اختر **جدولًا** أو **قاعدة بيانات** أو **مساحة**، وأدخل المعرّف الموافق وحدد نوع التحليل. ابدأ بـ **جدول** عندما تعرف الجدول البطيء.

انقر على **إنشاء تقرير استعلام** أو **إنشاء تقرير بحث**. يلخص التقرير المخاطر والإجراءات التالية الموصى بها. في تقرير البحث، يكون **نموذج بحث EXPLAIN** اختياريًا. أضف نموذجًا للتحقق من توافق النتائج وخطط الاستعلام وتوقيت الاستعلام المتكرر لمسار البحث المقترح. لا يحفظ Teable قيمة النموذج.

<Info>لا يغير تقرير الاستعلام قاعدة البيانات. يتطلب تطبيق توصية بحث السلسلة الفرعية **نموذج بحث EXPLAIN** وتأكيد المسؤول.</Info>

بالنسبة إلى جدول كبير، راجع الأثر وجدول أي تغيير مؤكد ضمن نافذة صيانة مناسبة.