أنواع EXPLAIN
AST— شجرة البنية النحوية المجردة.SYNTAX— نص الاستعلام بعد التحسينات على مستوى AST.QUERY TREE— شجرة الاستعلام بعد التحسينات على مستوى Query Tree.PLAN— خطة تنفيذ الاستعلام.PIPELINE— مسار تنفيذ الاستعلام.
EXPLAIN AST
SELECT فقط.
الإعدادات:
graph– يطبع AST على شكل رسم بياني موصوف بلغة وصف الرسوم البيانية DOT. القيمة الافتراضية: 0.
EXPLAIN SYNTAX
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 المختلفة:
| Symbol | Join Type |
|---|---|
⋈ | Inner Join |
⟕ | Left Join |
⟖ | Right Join |
⟗ | Full Join |
⋉ | Left Semi Join |
⋊ | Right Semi Join |
⋉ with strikethrough | Left Anti Join |
⋊ with strikethrough | Right Anti Join |
× | Cross Join |
t1 ⟕ t2 تعني LEFT JOIN بين الجدولين t1 وt2.
ويشير الرقم بين القوسين بعد اسم الجدول (مثل t1[100]) إلى العدد التقديري للصفوف
عندما تكون إحصاءات الجدول متاحة.
يعمل الخيار pretty جيدًا مع compact = 1، إذ يُخفي خطوات Expression ومعلومات الإجراءات التفصيلية، مما يجعل الخطة أسهل في القراءة.
EXPLAIN PIPELINE
header— يطبع الترويسة لكل منفذ إخراج. القيمة الافتراضية: 0.graph— يطبع رسمًا بيانيًا موصوفًا بلغة وصف الرسوم البيانية DOT. القيمة الافتراضية: 0.compact— يطبع الرسم البياني في الوضع المضغوط إذا كان إعدادgraphمفعّلًا. القيمة الافتراضية: 1.compact_repeated_processor_chains— يضغط سلاسل المعالجات المتكررة والمتجاورة في المخرجات النصية، وذلك بعرض نسخة واحدة من السلسلة مع عدد مرات تكرارها. يمكن أن يجعل ذلك خطوط المعالجة المتوازية أسهل قراءةً عندما تتكرر السلسلة نفسها مرات عديدة، على سبيل المثال في عمليات JOIN. ولا يؤثر ذلك في مخرجات الرسم البياني. القيمة الافتراضية: 0.
compact=0 وgraph=1، ستتضمن أسماء المعالجات لاحقة إضافية تحتوي على معرّف فريد للمعالج.
مثال:
EXPLAIN ESTIMATE
Query
Query
Response
EXPLAIN TABLE OVERRIDE
Query
Query
Response
لم تكتمل عملية التحقق، لذا فإن نجاح الاستعلام لا يضمن أن الاستبدال لن يسبب مشكلات.