يعرض EXPLAIN query الخطة التي يختارها PostgreSQL للاستعلام: شجرة من الخطوات (العُقد) مع تكاليف وأعداد صفوف تقديرية. ويشغّل EXPLAIN ANALYZE query الاستعلام أيضًا ويضيف الزمن والصفوف والحلقات الفعلية لكل عقدة. اقرأ الشجرة من العقدة الأكثر إزاحة إلى الخارج: العُقد الداخلية تمرر صفوفها إلى العقدة التي فوقها.
لا يوجد فهرس على email، فالخطة Seq Scan: يقرأ PostgreSQL كل صف ويحتفظ بما يجتاز Filter. ويُظهر Rows Removed by Filter العمل الضائع. تختلف الأزمنة في كل تشغيل، وشكل الخطة أهم من الأرقام.
قراءة سطر واحد من الخطة
تطبع كل عقدة سطرًا بهذا الشكل:
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| الجزء | المعنى |
|---|---|
cost=STARTUP..TOTAL | العمل التقديري قبل أول صف، ولكل الصفوف، بوحدات المخطِّط (لا بالميلي ثانية) |
rows (الأول) | العدد التقديري للصفوف التي تعيدها العقدة |
width | متوسط حجم الصف التقديري بالبايت |
actual time | الميلي ثواني حتى أول صف وحتى آخر صف، لكل حلقة |
rows (الفعلي) | الصفوف المعادة، لكل حلقة |
loops | عدد مرات تشغيل العقدة، اضرب فيه الزمن والصفوف |
تكاليف العقدة الأم تشمل أبناءها. وPlanning Time وExecution Time في الأسفل مجموعان للجملة كلها.
التعرف على عُقد الخطة الشائعة
يخفي EXPLAIN (COSTS OFF) الأرقام، فيسهل رؤية شكل الخطة:
اقرأ من الداخل. يُمسح الجدولان، ويدخل العملاء المصفَّون في Hash. ثم يفحصه Hash Join بكل طلب، ويعدّ GroupAggregate في الأعلى النتيجة. العُقد التي ستصادفها أكثر من غيرها:
| العقدة | ما تفعله |
|---|---|
Seq Scan | تقرأ الجدول كله |
Index Scan | تجد الصفوف عبر فهرس، ثم تقرأ كل صف من الجدول |
Index Only Scan | تجيب من الفهرس دون زيارة الجدول |
Bitmap Index Scan + Bitmap Heap Scan | تجمع مواقع الصفوف المطابقة من فهرس، ثم تقرؤها بترتيب الجدول |
Nested Loop | لكل صف خارجي تبحث عن المطابقات في المدخل الداخلي، وهي جيدة حين يكون الجانب الخارجي صغيرًا |
Hash Join + Hash | تبني جدول hash من مدخل وتفحصه بالمدخل الآخر |
Merge Join | تربط مدخلين مرتبين أصلًا بحسب مفتاح الربط |
Sort، Incremental Sort | ترتّب الصفوف لـ ORDER BY أو DISTINCT أو merge join |
HashAggregate، GroupAggregate | GROUP BY بجدول hash، أو على مدخل مرتّب |
Limit | تتوقف بعد N صفوف |
Gather | تجمع الصفوف من العمّال المتوازيين |
اكتشاف تقديرات الصفوف الخاطئة
أنفع فحص في EXPLAIN ANALYZE هو مقارنة rows التقديري بـ rows الفعلي في العقدة نفسها. فحين يتباعدان كثيرًا، يكون المخطِّط قد اختار خطته بناءً على أرقام خاطئة، غالبًا لأن الإحصاءات غائبة أو قديمة:
يعيد المسح 10 صفوف فعلية، لكن التقدير أعلى بكثير لأن الجدول لم يُحلَّل بعد. أضف ANALYZE tasks; قبل EXPLAIN فيقترب التقدير من 10. يحلل autovacuum الجداول في الخلفية، لكن نفّذ ANALYZE بنفسك بعد أي تحميل كبير (راجع VACUUM وautovacuum).
شرح تعديل للبيانات دون الاحتفاظ به
ينفّذ EXPLAIN ANALYZE الجملة، فيغيّر UPDATE أو DELETE الصفوف فعلًا. غلّفه بمعاملة وتراجع عنها:
تبقى الصفوف الـ 1000 كلها بعد التراجع.
عرض عمليات الإدخال والإخراج مع BUFFERS وخيارات أخرى
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
يعرض BUFFERS عمليات الإدخال والإخراج: العقدة التي فيها صفحات read كثيرة ذهبت إلى القرص. وأضاف PostgreSQL 17 SERIALIZE (تكلفة تحويل صفوف الناتج إلى نص) وMEMORY (ذاكرة المخطِّط). ويستعرض دليل EXPLAIN الرسمي خططًا أخرى.
اختبار خطة بإعدادات المخطِّط
لترى الخطة التي سيستخدمها PostgreSQL دون طريقة معينة، عطّل تلك الطريقة في جلستك. افعل ذلك في التجارب فقط، لا في شيفرة الإنتاج أبدًا:
مع 100 صف يفضّل المخطِّط Seq Scan، ومع enable_seqscan = off تُظهر الخطة Index Scan using items_pkey. قارن زمني EXPLAIN ANALYZE لترى هل يساعد الفهرس. ويعيد RESET enable_seqscan; القيمة الافتراضية.
الأسئلة الشائعة
ما الفرق بين EXPLAIN وEXPLAIN ANALYZE؟
يخطط EXPLAIN للاستعلام فقط ويعرض التقديرات. أما EXPLAIN ANALYZE فينفّذه أيضًا ويضيف الزمن الفعلي وعدد الصفوف وعدد الحلقات لكل عقدة، لذا يستغرق ما يستغرقه الاستعلام نفسه.
ماذا تعني cost في خطة PostgreSQL؟
التكلفة تقدير المخطِّط بوحدات اعتباطية، مقيسة بحيث تكلّف قراءة صفحة واحدة تسلسليًا 1 (seq_page_cost). وهي مفيدة للمقارنة بين خطط الاستعلام نفسه، لا كزمن بالميلي ثانية.
هل يغيّر EXPLAIN ANALYZE البيانات؟
نعم، مع INSERT وUPDATE وDELETE وMERGE ينفّذ التغيير فعلًا. شغّله بين BEGIN وROLLBACK لتقيس دون الاحتفاظ بالنتيجة.
لماذا يُختار Seq Scan مع وجود فهرس؟
لأن المخطِّط يقدّر أنه أرخص: الجدول صغير، أو يعيد الاستعلام نسبة كبيرة من الصفوف، أو لا يستطيع الشرط استخدام الفهرس. وقد تضلله الإحصاءات القديمة أيضًا، ويصلح ANALYZE ذلك.