Skip to main content
متاحة لخطة Business ذاتية الاستضافة والخطط الأعلى
المسار: لوحة الإدارة ← عمليات استعلام الجداول استخدم بحث الجداول والفهارس عندما تصبح طرق العرض أو عوامل التصفية أو العلاقات أو عمليات البحث في جدول كبير بطيئة. يراقب Teable حمل الاستعلامات في الخلفية ويلخّص حالة كل جدول: كيف يجري البحث فيه حاليًا، وأي الحقول مشمولة بالتغطية، وأي فهارس فعلية موجودة، وكم عدد الاستعلامات البطيئة التي رُصدت مؤخرًا. ومن هنا يضبط مسؤولو النسخة تغطية البحث، وينشئون الفهارس، ويتابعون النتائج.
تكتفي الصفحة بإدراج المهام ولا تغيّر قاعدة البيانات مباشرةً أبدًا. ويُنفَّذ كل تغيير في الخلفية بشكل غير متزامن، لذا تحقق من النتيجة في المهام / السجل.
عمليات استعلام الجداول معطّلة افتراضيًا. اضبط V2_TABLE_QUERY_OPS_ENABLED على true في الخادم الخلفي وأعد التشغيل، عندئذٍ تبدأ الصفحة في جمع بيانات الرصد.

العثور على الجدول المطلوب

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

قراءة حالة الفهرس

تعرض قائمة الجداول وصفحة التفاصيل حالة فهرس الجدول بجوار طريقة البحث: وقد يظهر أسفل الحالة سطران: مضبوط: pg_bigm / pg_trgm يعني أن الموفر المحفوظ يختلف عن طريقة البحث المستخدمة حاليًا، ومفتاح تشغيل البحث المفهرس: مغلق يعني أن الفهرس جاهز لكن التشغيل موقوف، فيظل البحث يعتمد على ILIKE. عندما يُبلغ إشعار أعلى الصفحة عن جداول لا يعمل فهرس البحث المضبوط لها، يرجع البحث في هذه الجداول إلى ILIKE. وإذا أشار أيضًا إلى أن عامل المهام (task worker) متوقف، فاضبط V2_TABLE_QUERY_OPS_TASK_WORKER_ENABLED على true في الخادم الخلفي وأعد التشغيل حتى يمكن إعادة بناء الفهارس.
نشر الفهرس لا يعني أن كل عملية بحث تستخدمه: فنص البحث القصير جدًا أو الحقل خارج نطاق التغطية يرجع إلى ILIKE. تعرض هذه الصفحة حالة الفهرس، ولا تثبت أن الطلبات الأخيرة مرّت عبره.

ضبط تغطية البحث

تعرض علامة التبويب تغطية البحث طريقة البحث الحالية للجدول، وعدد الحقول المشمولة، والتغطية الفعلية لكل حقل. ويقصر خيار عرض الحقول غير المشمولة القائمة على الحقول التي لم تُضمَّن بعد؛ أما الحقول المعلَّمة بـ غير مؤهل فلا يمكنها المشاركة في فهرس البحث الجزئي.
تتطلب التغطية الفعلية بيانات فهرس وصفية منشورة وصالحة ومفتاح تشغيل مفعّلًا، ولا يُحتسب حفظ الإعداد وحده. والتغطية تحدَّد صراحةً، فالحقول التي تضيفها لاحقًا لا تُضمَّن تلقائيًا، ويلزم ضبط الجدول من جديد لإدراجها.
اختر ضبط البحث للجدول الذي لم يُضبط من قبل، أو تحديث التحديد / إعادة البناء للجدول المضبوط سابقًا، ويفتح هذا الخيار بالموفر واختيار الحقول المحفوظين في المرة السابقة. ويطلب مربع الحوار ما يلي: يشغّل التحليل والتشغيل التجريبي التغيير دون اعتماده، ويذكر عدد الحقول المشمولة، وعدد الصفوف التقديري، ووجود أدلة من خطة التنفيذ من عدمه، وأثر الإنشاء أو إعادة البناء. أما الجداول المقدّرة بـ 50,000 صف فأكثر، أو المجهولة الحجم، فتتطلب أيضًا تأكيد نافذة الصيانة. ثم اختر تأكيد وإدراج المهمة.
ينشئ إنشاء تغطية البحث أو إعادة بنائها عمود بحث وفهرس GIN. وقد يعيد ذلك كتابة الجدول بالكامل ويحتفظ بأقفال، وينقطع البحث المفهرس لفترة قصيرة أثناء التنفيذ. لذا خطّط لذلك ضمن نافذة صيانة.
ما يعيده مربع الحوار هو إيصال بإدراج المهمة، لا نتيجة تنفيذها. أغلقه وتابع المهمة في المهام / السجل. وإذا أرسلت التغيير نفسه مرة أخرى، تُعاد المهمة القائمة.

إدارة فهارس التصفية والفرز

تسرد علامة التبويب فهارس التصفية / الفرز الفهارس الفعلية التي تخدم شروط التصفية والفرز في هذا الجدول، مع صلاحية كل فهرس، وما إذا كان Teable يديره، وحجمه وتعريفه. وتُدار هذه الفهارس بمعزل عن فهارس البحث الجزئي. وتضم الإجراءات المعلّقة أدناه توصيات الفهارس الصادرة عن النظام، مع بيان ما إذا كانت مدعومة بأدلة من خطة التنفيذ. ويعرض مراجعة إنشاء الفهرس الفهرس المقترح وقاعدة البيانات التي سيُنفَّذ عليها والأدلة المتاحة؛ وبعد التأكيد ينفّذ Teable الأمر CREATE INDEX CONCURRENTLY بشكل غير متزامن. وتتطلب الجداول الكبيرة والمجهولة الحجم تأكيد نافذة الصيانة هنا أيضًا.
لا تحذف هذه الصفحة الفهارس. فالفهارس غير المُدارة وفهارس النظام قد تحمي قيودًا أو تخدم أحمال عمل أخرى، ولذلك تُترك كما هي.

تشخيص استعلامات بعينها

عندما يُبلَّغ عن بطء جدول ولا توجد توصية تغطيه، افتح علامة التبويب تشخيص الاستعلامات واختر تحليل الاستعلامات. ويكتفي التحليل بقراءة أشكال الاستعلامات المحفوظة وأدلة خطة التنفيذ المتاحة، ولا ينشئ شيئًا. وتكون النتيجة إحدى ثلاث: عُثر على فرص فهرسة مدعومة بخطة التنفيذ، أو لم تؤكد الخطط المتاحة أي فرصة فهرسة، أو أدلة غير كافية. ولا تعني الأدلة غير الكافية أن فحصًا تسلسليًا قد حدث، فرصد استعلام بطيء وحده لا يثبت أن مسار الوصول هو السبب. ويُدرج أسفل ذلك كل استعلام متأثر، مع بيان ما إذا كان واردًا من حركة فعلية أو من إعداد طريقة عرض محفوظة، وتكلفة الخطة التقديرية قبل الفهرس المقترح وبعده (تكلفة خطة، لا أجزاء من الثانية).

متابعة النتائج

تضم علامة التبويب المهام / السجل ثلاثة أقسام:
  • المهام: مهام الخلفية الخاصة بهذا الجدول، مع الحالة وعدد المحاولات ونوع المهمة وسبب الفشل. وإذا نجحت المهمة في النهاية بعد فشل سابق، يُعلَّم الخطأ بأنه محاولة سابقة.
  • سجل إعدادات البحث: المزوّد والحالة وقائمة الحقول لكل إعداد تغطية سابق.
  • سجل التوصيات: التوصيات المقبولة أو المتجاهَلة أو المستبدَلة.
لا يُحمَّل من السجل سوى أحدث الإدخالات. وإذا كان هناك المزيد، يذكر سطر أعلى القائمة العدد الإجمالي.
ما دامت للجدول مهمة مدرجة أو قيد التشغيل، يظل زرّا ضبط البحث وإنشاء الفهارس معطَّلين. انتظر انتهاء المهمة.
آخر تعديل في ١٤ أكتوبر ٢٠٢٦