الانتقال إلى المحتوى الرئيسي
يعرض خطة تنفيذ عبارة.
الصيغة:
مثال:

أنواع EXPLAIN

  • AST — شجرة البنية النحوية المجردة.
  • SYNTAX — نص الاستعلام بعد التحسينات على مستوى AST.
  • QUERY TREE — شجرة الاستعلام بعد التحسينات على مستوى Query Tree.
  • PLAN — خطة تنفيذ الاستعلام.
  • PIPELINE — مسار تنفيذ الاستعلام.

EXPLAIN AST

يعرض AST للاستعلام. يدعم جميع أنواع الاستعلامات، وليس SELECT فقط. الإعدادات:
  • graph – يطبع AST على شكل رسم بياني موصوف بلغة وصف الرسوم البيانية DOT. القيمة الافتراضية: 0.
أمثلة:

EXPLAIN SYNTAX

يعرض شجرة البنية النحوية المجرّدة (AST) للاستعلام بعد تحليل البنية النحوية. يتم ذلك عبر تحليل الاستعلام، وبناء AST وشجرة الاستعلام، وتشغيل محلل الاستعلامات وتمريرات التحسين اختياريًا، ثم تحويل شجرة الاستعلام مرة أخرى إلى AST الخاصة بالاستعلام. الإعدادات:
  • oneline – يطبع الاستعلام في سطر واحد. القيمة الافتراضية: 0.
  • run_query_tree_passes – يشغّل تمريرات شجرة الاستعلام قبل إخراج شجرة الاستعلام. القيمة الافتراضية: 0.
  • query_tree_passes – إذا كان run_query_tree_passes مضبوطًا، فإنه يحدّد عدد التمريرات التي سيتم تشغيلها. ومن دون تحديد query_tree_passes، يتم تشغيل جميع التمريرات.
أمثلة:
Query
Response
باستخدام run_query_tree_passes:
Query
Response

EXPLAIN شجرة الاستعلام

الإعدادات:
  • run_passes — شغّل جميع تمريرات شجرة الاستعلام قبل إخراج شجرة الاستعلام. القيمة الافتراضية: 1.
  • dump_passes — أخرج معلومات عن التمريرات المستخدمة قبل إخراج شجرة الاستعلام. القيمة الافتراضية: 0.
  • passes — يحدّد عدد التمريرات المطلوب تشغيلها. إذا ضُبطت على -1، فسيُشغّل جميع التمريرات. القيمة الافتراضية: -1.
  • dump_tree — اعرض شجرة الاستعلام. القيمة الافتراضية: 1.
  • dump_ast — اعرض AST للاستعلام الناتجة من شجرة الاستعلام. القيمة الافتراضية: 0.
مثال:

EXPLAIN PLAN

يعرض خطوات خطة تنفيذ الاستعلام. الإعدادات:
  • optimize — يتحكم في ما إذا كانت تحسينات خطة تنفيذ الاستعلام تُطبَّق قبل عرض الخطة. القيمة الافتراضية: 1.
  • header — يطبع ترويسة المخرجات للخطوة. القيمة الافتراضية: 0.
  • description — يطبع وصف الخطوة. القيمة الافتراضية: 1.
  • indexes — يعرض الفهارس المستخدمة، وعدد الأجزاء التي تمت تصفيتها، وعدد الحبيبات التي تمت تصفيتها لكل فهرس مُطبَّق. القيمة الافتراضية: 0. مدعوم في جداول MergeTree. بدءًا من ClickHouse >= v25.9، لا تعرض هذه العبارة ناتجًا مناسبًا إلا عند استخدامها مع SETTINGS use_query_condition_cache = 0, use_skip_indexes_on_data_read = 0.
  • projections — يعرض جميع الإسقاطات التي جرى تحليلها وتأثيرها في التصفية على مستوى الأجزاء استنادًا إلى شروط المفتاح الأساسي للإسقاط. ولكل إسقاط، يتضمن هذا القسم إحصاءات مثل عدد الأجزاء والصفوف وعلامات ونطاقات التي جرى تقييمها باستخدام المفتاح الأساسي للإسقاط. كما يوضح عدد data parts التي تم تخطيها بسبب هذه التصفية، من دون القراءة من الإسقاط نفسه. ويمكن تحديد ما إذا كان الإسقاط قد استُخدم فعليًا للقراءة أو جرى تحليله فقط لأغراض التصفية من خلال الحقل description. القيمة الافتراضية: 0. مدعوم في جداول MergeTree.
  • actions — يطبع معلومات تفصيلية عن إجراءات الخطوة. القيمة الافتراضية: 0.
  • sorting — يطبع وصف الفرز لكل خطوة في الخطة تنتج مخرجات مرتبة. القيمة الافتراضية: 0.
  • keep_logical_steps — يحتفظ بالخطوات المنطقية في الخطة لعمليات joins بدلًا من تحويلها إلى تطبيقات join فعلية. القيمة الافتراضية: 0.
  • json — يطبع خطوات خطة تنفيذ الاستعلام كسطر بتنسيق JSON. القيمة الافتراضية: 0. يُنصح باستخدام تنسيق TabSeparatedRaw (TSVRaw) لتجنب عمليات الهروب غير الضرورية.
  • input_headers — يطبع ترويسات الإدخال للخطوة. القيمة الافتراضية: 0. يفيد غالبًا المطورين فقط في استكشاف المشكلات المتعلقة بعدم تطابق ترويسات الإدخال والإخراج.
  • column_structure — يطبع أيضًا بنية الأعمدة في الترويسات بالإضافة إلى اسمها ونوعها. القيمة الافتراضية: 0. يفيد غالبًا المطورين فقط في استكشاف المشكلات المتعلقة بعدم تطابق ترويسات الإدخال والإخراج.
  • distributed — يعرض خطط الاستعلام المنفَّذة على العقد البعيدة للجداول الموزعة أو parallel replicas. القيمة الافتراضية: 0.
  • compact — عند التمكين، يُخفي خطوات expression ومعلومات الإجراءات التفصيلية (المدخلات، والدوال، والأسماء المستعارة، ومواضع المخرجات) من الخطة. ولا يكون له تأثير إلا عندما تكون actions = 1. القيمة الافتراضية: 0.
  • pretty — يطبع شجرة الخطة باستخدام محارف رسم الخطوط (├──, └──, │) بدلًا من المسافات البادئة لتوضيح التدرج الهرمي. كما ينسّق خصائص خطوة join ضمن السطر نفسه. القيمة الافتراضية: 0.
عند استخدام json=1 ستتضمن أسماء الخطوات لاحقة إضافية تحتوي على معرّف فريد للخطوة. مثال:
لا تتوفر إمكانية تقدير تكلفة الخطوة والاستعلام.
عندما تكون قيمة json = 1، يُمثَّل مخطط الاستعلام بتنسيق JSON. وكل عقدة هي قاموس يحتوي دائمًا على المفتاحين Node Type وPlans. ويمثل Node Type سلسلة نصية تتضمن اسم الخطوة، بينما تمثل Plans مصفوفة تتضمن أوصاف الخطوات الفرعية. وقد تُضاف مفاتيح اختيارية أخرى بحسب نوع العقدة والإعدادات. مثال:
عند ضبط description على 1، يُضاف المفتاح Description إلى الخطوة:
عند ضبط header = 1، يُضاف المفتاح Header إلى الخطوة على هيئة مصفوفة من الأعمدة. مثال:
مع indexes = 1، يُضاف المفتاح Indexes. ويحتوي على مصفوفة من الفهارس المستخدمة. يُوصَف كل فهرس بتنسيق JSON مع المفتاح Type (سلسلة نصية بقيمة Partition Min-Max أو Partition أو Statistics أو PrimaryKey أو Skip) والمفاتيح الاختيارية التالية:
  • Name — اسم الفهرس (يُستخدم حاليًا فقط مع فهارس Skip).
  • Keys — مصفوفة الأعمدة التي يستخدمها الفهرس.
  • Condition — الشرط المستخدم.
  • Description — وصف الفهرس (يُستخدم حاليًا فقط مع فهارس Skip).
  • Parts — عدد الأجزاء بعد/قبل تطبيق الفهرس.
  • Granules — عدد الحبيبات بعد/قبل تطبيق الفهرس.
  • Ranges — عدد نطاقات الحبيبات بعد تطبيق الفهرس.
مثال:
مع projections = 1، يُضاف المفتاح Projections. ويحتوي على مصفوفة من الإسقاطات التي جرى تحليلها. ويُوصَف كل إسقاط بصيغة JSON بالمفاتيح التالية:
  • Name — اسم الإسقاط.
  • Condition — شرط المفتاح الأساسي المستخدم للإسقاط.
  • Description — وصف لكيفية استخدام الإسقاط (على سبيل المثال، التصفية على مستوى الجزء).
  • Selected Parts — عدد الأجزاء التي اختارها الإسقاط.
  • Selected Marks — عدد العلامات المختارة.
  • Selected Ranges — عدد النطاقات المختارة.
  • Selected Rows — عدد الصفوف المختارة.
  • Filtered Parts — عدد الأجزاء التي تم تخطيها بسبب التصفية على مستوى الجزء.
مثال:
مع actions = 1، تعتمد المفاتيح المُضافة على نوع الخطوة. مثال:
مع compact = 1، تُحذف كل خطوة Expression. وبالإضافة إلى ذلك، إذا كان actions = 1 مضبوطًا، فستُخفى أسطر Actions وPositions، ولن يتبقى سوى أوصاف الخطوات:
عند تعيين distributed = 1، يتضمن الناتج ليس فقط خطة الاستعلام المحلية، بل أيضاً خطط الاستعلام التي ستُنفَّذ على العقد البعيدة. يُفيد هذا في تحليل الاستعلامات الموزعة وتصحيح أخطائها. مثال مع جدول موزّع:
مثال مع النسخ المتماثلة المتوازية:
في كلا المثالَين، تُظهر خطةُ الاستعلام تدفق التنفيذ الكامل بما في ذلك الخطوات المحلية والبعيدة. عند تعيين pretty = 1، تُعرض شجرة الخطة باستخدام أحرف رسم الخطوط بدلاً من المسافات البادئة، وتظهر معلومات إضافية للخطوات الرئيسية:
  • تُطبع أعمدة مخرجات الاستعلام في أعلى الخطة.
  • تُعرض التعبيرات في المرشحات، ومفاتيح التجميع، وأوصاف الفرز، ووظائف النافذة بصياغة شبيهة بـ SQL وسهلة القراءة (مثل a + 1 > 5 بدلًا من greater(plus(a, 1), 5)). كما تُزال بادئات معرّفات الأعمدة الداخلية (مثل __table1.) لتوضيح العرض.
  • تعرض خطوات المصدر (مثل ReadFromMergeTree) أعمدة مخرجاتها.
  • تعرض خطوات التصفية شرط التصفية بصياغة SQL. وعند وجود مرشحات JOIN وقت التشغيل، تُعرض بشكل منفصل.
  • تعرض خطوات التجميع المفاتيح والدوال التجميعية مع وسيطاتها (مثل sum(c), count()).
  • تعرض مجموعات IN المشتقة من قيم Tuple الحرفية قيمها (مع اقتطاعها في المجموعات الكبيرة)، وتُسمّى المجموعات المستندة إلى استعلامات فرعية subquery1 وsubquery2 وما إلى ذلك، بينما تعرض المجموعات من جداول المحرك Set اسم الجدول.
  • تعرض خطوات JOIN علاقة الـ join باستخدام ترميز رياضي، والعدد التقديري لصفوف النتيجة، وتوضح أي أعمدة المخرجات تأتي من الجانب الأيسر مقابل الأيمن. وتُستخدم الرموز التالية لتمثيل أنواع join المختلفة:
SymbolJoin Type
Inner Join
Left Join
Right Join
Full Join
Left Semi Join
Right Semi Join
with strikethroughLeft Anti Join
with strikethroughRight Anti Join
×Cross Join
على سبيل المثال، t1 ⟕ t2 تعني LEFT JOIN بين الجدولين t1 وt2. ويشير الرقم بين القوسين بعد اسم الجدول (مثل t1[100]) إلى العدد التقديري للصفوف عندما تكون إحصاءات الجدول متاحة. يعمل الخيار pretty جيدًا مع compact = 1، إذ يُخفي خطوات Expression ومعلومات الإجراءات التفصيلية، مما يجعل الخطة أسهل في القراءة.
مثال أكثر تفصيلاً يتضمن عمليات JOIN:

EXPLAIN PIPELINE

الإعدادات:
  • header — يطبع الترويسة لكل منفذ إخراج. القيمة الافتراضية: 0.
  • graph — يطبع رسمًا بيانيًا موصوفًا بلغة وصف الرسوم البيانية DOT. القيمة الافتراضية: 0.
  • compact — يطبع الرسم البياني في الوضع المضغوط إذا كان إعداد graph مفعّلًا. القيمة الافتراضية: 1.
  • compact_repeated_processor_chains — يضغط سلاسل المعالجات المتكررة والمتجاورة في المخرجات النصية، وذلك بعرض نسخة واحدة من السلسلة مع عدد مرات تكرارها. يمكن أن يجعل ذلك خطوط المعالجة المتوازية أسهل قراءةً عندما تتكرر السلسلة نفسها مرات عديدة، على سبيل المثال في عمليات JOIN. ولا يؤثر ذلك في مخرجات الرسم البياني. القيمة الافتراضية: 0.
عندما تكون compact=0 وgraph=1، ستتضمن أسماء المعالجات لاحقة إضافية تحتوي على معرّف فريد للمعالج. مثال:

EXPLAIN ESTIMATE

يعرض العدد التقديري للصفوف والعلامات والأجزاء التي ستُقرأ من الجداول عند معالجة الاستعلام. يعمل مع الجداول من عائلة MergeTree. مثال إنشاء جدول:
Query
Query
Response

EXPLAIN TABLE OVERRIDE

يعرض ناتج تطبيق تجاوز على مخطط جدول تم الوصول إليه عبر دالة جدول. كما يُجري بعض عمليات التحقق، ويُطلق استثناءً إذا كان هذا التجاوز سيتسبب في أي نوع من الإخفاق. مثال افترض أن لديك جدول MySQL بعيدًا على النحو التالي:
Query
Query
Response
لم تكتمل عملية التحقق، لذا فإن نجاح الاستعلام لا يضمن أن الاستبدال لن يسبب مشكلات.
آخر تعديل في ٢ يوليو ٢٠٢٦