Menu

EXPLAIN ANALYZE في PostgreSQL: كيف تقرأ خطة الاستعلام

يعرض EXPLAIN الخطة التي يختارها PostgreSQL للاستعلام، ويشغّل EXPLAIN ANALYZE الاستعلام ويضيف أعداد الصفوف والأزمنة الفعلية لكل خطوة. تعلّم قراءة شجرة الخطة وأسماء العُقد الشائعة.

تحتوي هذه الصفحة على محررات قابلة للتشغيل. حرّر، شغّل، وشاهد النتيجة فوراً.

يعرض 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، GroupAggregateGROUP 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 ذلك.

رسم توضيحي للغات البرمجة في Coddy

تعلّم البرمجة مع Coddy

ابدأ الآن