إعدادات الجلسة allow_*

هذه الإعدادات متاحة في system.settings، وهي مُولَّدة تلقائيًا من الشيفرة المصدرية.

تمكين التجميع المستقل لـ partitions على threads منفصلة عندما يكون مفتاح partition مناسبًا لمفتاح GROUP BY. يكون ذلك مفيدًا عندما يكون عدد partitions قريبًا من عدد الأنوية وتكون أحجام partitions متقاربة إلى حدٍّ ما. تقوم الآليات الاستدلالية في ReadFromMergeTree تلقائيًا بتعطيل هذا التحسين في التخطيطات غير الملائمة (عدد قليل جدًا من partitions، أو عدد كبير جدًا منها، أو أحجام partitions غير متوازنة بشكل ملحوظ)؛ راجع force_aggregate_partitions_independently لتجاوز هذه الفحوصات.

ستفسّر محركات File/S3/دالة الجدول المسارات التي تحتوي على '::' على أنها <archive> :: <file> إذا كان للأرشيف امتداد صحيح.

استخدم مجموعة I/O في الخلفية للقراءة من جداول MergeTree. قد يؤدي هذا الإعداد إلى تحسين الأداء للاستعلامات المقيّدة بعمليات I/O

عند التمكين، سيحسب ClickHouse أحجام الملفات المطلوبة لقراءة كل عمود فرعي، لتحسين حساب أحجام المهام والكتل.

إذا كان هذا الإعداد مُمكّنًا، ففي الطلبات المتحوّطة يمكننا بدء connection جديد حتى استلام أول packet بيانات، حتى لو كنّا قد أحرزنا بعض التقدّم بالفعل (لكن لم يتم تحديث التقدّم خلال مهلة receive_data_timeout)؛ وإلا فسنُعطّل تغيير الـ replica بعد أول مرة نُحرز فيها تقدّمًا.

يسمح بتنفيذ استعلام CREATE INDEX بدون TYPE. سيتم تجاهل الاستعلام. وُضع هذا لأغراض اختبار التوافق مع SQL.

يتيح إزالة التكرار المسبقة والمتوازية لكل partition من نتيجة الاستعلام الفرعي عند بناء المجموعة لـ IN (subquery)، عندما يكون تعبير partition في جدول MergeTree الخاص بالاستعلام الفرعي دالة حتمية لأعمدة إخراج الاستعلام الفرعي. يُقرأ كل partition عبر تدفق منفصل وتُزال تكراراته بشكل مستقل، لذلك لا يحسب تحويل ملء المجموعة الوحيد التجزئة إلا للصفوف الفريدة. لا يُطبَّق مع FINAL أو النسخ المتماثلة المتوازية أو GLOBAL IN. لا يطلب التحسين القراءة لكل partition إلا عندما تحتوي البيانات على أكثر من partition واحد، ولا يتجاوز عدد صفوف أكبر partition ضعف عدد صفوف partition المتوسط (راجع force_creating_set_partitions_independently لتجاوز فحص عدم التوازن). وعندما تكون التدفقات منفصلة بحسب partition أصلًا لأن ميزة أخرى لكل partition قد فصلتها (مثل LIMIT BY لكل partition)، تُطبَّق إزالة التكرار المسبقة بغض النظر عن ذلك، لأن تخطيط القراءة محدد مسبقًا. أثناء بناء المجموعة، تحتفظ جداول إزالة التكرار الخاصة بكل تدفق مجتمعةً بنسخة إضافية واحدة تقريبًا من المفاتيح الفريدة.

يتيح استخدام رمز خطأ مخصص في الدالة throwIf(). إذا كانت القيمة true، فقد تحمل الاستثناءات المُطلَقة رموز خطأ غير متوقعة.

إذا ضُبطت القيمة على true، فسيُسمح للمستخدم بتنفيذ استعلامات DDL.

الأسماء المستعارة: allow_experimental_delta_kernel_rs

يسمح باستخدام تنفيذ delta-kernel-rs لقراءة جداول Delta Lake.

فعّل التقييم المستقل لـ DISTINCT لكل partition على خيوط تنفيذ منفصلة عندما يكون تعبير partition دالة حتمية لأعمدة DISTINCT، مع تجاوز الدمج بين التدفقات. يفيد ذلك عندما يكون عدد partitionات قريبًا من عدد الأنوية وتكون partitionات متقاربة الحجم؛ وإلا، تتجاوزه آلية استدلالية للتكلفة. راجع max_number_of_partitions_for_independent_distinct وforce_distinct_partitions_independently. لا يُطبَّق مع FINAL أو النسخ المتماثلة المتوازية.

لا يُطبَّق عند تعيين max_rows_in_distinct أو max_bytes_in_distinct: إذ تُفرض هذه الحدود بواسطة تحويل DISTINCT الواحد الذي يعالج النتيجة المدمجة بالكامل، لذلك يُحتفظ بالدمج بين التدفقات للحفاظ على دلالتها الشاملة.

إذا ضُبطت هذه القيمة على true، فسيُسمح للمستخدم بتنفيذ استعلامات DDL الموزعة.

يسمح بتنفيذ استعلامات ALTER TABLE … DROP DETACHED PART[ITION] …

يسمح باستخدام نوع Dynamic في مفاتيح JOIN. أُضيف لأغراض التوافق. لا يُنصح باستخدام نوع Dynamic في مفاتيح JOIN لأن المقارنة مع الأنواع الأخرى قد تؤدي إلى نتائج غير متوقعة.

السماح بتنفيذ الدالة multiIf بشكل عمودي

يُمكِّن الدالة fuzzQuery التي تُجري تعديلات عشوائية على AST لاستعلامٍ ما.

يتيح هذا استخدام خوارزمية أكثر عمومية لتخطيط JOIN يمكنها التعامل مع شروط أكثر تعقيدًا، لكنها لا تعمل إلا مع hash join. وإذا لم يكن hash join مُمكّنًا، فستُستخدم خوارزمية تخطيط JOIN المعتادة بغض النظر عن قيمة هذا الإعداد.

يسمح هذا الإعداد باستخدام الدالة getClientHTTPHeader التي تتيح الحصول على قيمة ترويسة طلب HTTP الحالي. وهي غير مُمكّنة افتراضيًا لأسباب أمنية، لأن بعض الترويسات، مثل Cookie، قد تحتوي على معلومات حساسة. لاحظ أن ترويسات X-ClickHouse-* وAuthentication وAuthorization تكون مقيّدة دائمًا، ولا يمكن الحصول عليها باستخدام هذه الدالة.

يسمح بالدوال التي تستخدم مكتبة Hyperscan. عطّل هذا الخيار لتجنّب أوقات تجميع طويلة محتملة والاستهلاك المفرط للموارد.

يسمح باستخدام 'ALTER TABLE … EXECUTE remove_orphan_files()' لجداول Iceberg.

الأسماء البديلة: allow_experimental_insert_into_iceberg

يسمح بتنفيذ استعلامات insert في Iceberg.

يؤدي إلى تمكين دوال فحص المكونات الداخلية أو تعطيلها لتنميط الاستعلامات.

القيم الممكنة:

• 1 — دوال فحص المكونات الداخلية مُمكّنة.
• 0 — دوال فحص المكونات الداخلية مُعطّلة.

انظر أيضًا

• Sampling Query Profiler
• جدول النظام trace_log

أعِد كتابة الشروط من الشكل coalesce(a_1, ..., a_N) <op> const (وكذلك ifNull بصورة مكافئة، أو عندما يكون الثابت على اليسار) إلى الفصل المنطقي (a_1 <op> const) OR (a_1 IS NULL AND a_2 <op> const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N <op> const) قبل تحليل الفهارس، بحيث يمكن استخدام المفتاح الأساسي وفهارس التخطي الخاصة بكل عمود على كل a_i. تُعالَج الأشكال ذات الثوابت الجزئية مثل coalesce(a, 42, b) وcoalesce(a, b, 42): إذ تُطبَّع قائمة الوسائط كما يفعل coalesce نفسه (تُحذف القيم الحرفية NULL، وتُحذف الوسائط التي تلي أول وسيطة غير Nullable)، ويُضاف الثابت غير NULL الختامي، إن وُجد، باعتباره الفرع الأخير. تُستخدم إعادة الكتابة فقط كإضافة لتحسين استبعاد البيانات عبر الفهارس؛ ويستمر الترشيح وقت التشغيل في استخدام الشرط الأصلي. بالإضافة إلى ذلك، يُعاد كتابة شروط المساواة الدقيقة من الشكل nullIf(key, sentinel) = const (حيث sentinel != const وتتطابق الأنواع تمامًا) إلى key = const، بحيث يتمكن المفتاح الأساسي وpartition وفهارس التخطي على key من استبعاد الحبيبات مباشرةً. لا يُدعم استبعاد البيانات عبر nullIf للنطاقات أو الشروط الفصلية.

يُمكّن التقييم المستقل لـ LIMIT BY لكل partition على خيوط تنفيذ منفصلة عندما يكون تعبير partition دالة حتمية لأعمدة LIMIT BY.

عند التمكين، تُوحِّد if/multiIf/coalesce/ifNull/array/map مجموعةً من الوسائط الرقمية التي لا نوعًا مشتركًا بينها دون فقدان (مثل Decimal وFloat64، أو Int64 وFloat64) إلى نوع فائق رقمي (Float64) بدلًا من أن تفشل، مع احتمال فقدان الدقة. يتيح ذلك استخدام النتيجة مباشرةً مع دوال التجميع التي تدمج القيم، مثل sum وavg وmin وmax. وهذا مستقل عن use_variant_as_common_type: إذ يُنتَج النوع الفائق الرقمي سواء أكان use_variant_as_common_type مُمكّنًا أم لا. عند التعطيل (الإعداد الافتراضي)، لا يكون لهذه المجموعات من الوسائط نوع مشترك، لذا فإنها إما تصبح Variant (إذا كان use_variant_as_common_type مُمكّنًا) أو تُصدر NO_COMMON_TYPE.

يسمح باستخدام CREATE MATERIALIZED VIEW مع استعلام SELECT يشير إلى جداول أو أعمدة غير موجودة. ويجب أن يظل صحيحًا من حيث الصياغة النحوية. لا ينطبق ذلك على MVs القابلة للتحديث. كما لا ينطبق إذا كان يجب استنتاج مخطط MV من استعلام SELECT (أي إذا كان CREATE لا يتضمن قائمة أعمدة ولا TO table). ويمكن استخدامه لإنشاء MV قبل الجدول المصدر الخاص بها.

إذا كانت القيمة true، فإن عملية ALTER MODIFY COLUMN على Tuple مُسمّى تضيف حقولًا فرعية جديدة فقط تكون مقتصرة على البيانات الوصفية (من دون mutation للبيانات). اضبطها على false لفرض السلوك القديم الذي يتضمن mutation كاملًا.

السماح بإنشاء فهارس minmax للتخطي على أعمدة JSON ‏(Object). يكون هذا الخيار معطّلًا افتراضيًا لأن مسار تسلسل فهرس minmax لا يمكنه التعامل مع قيم Field غير المتجانسة التي قد تحتويها أعمدة JSON.

السماح افتراضيًا بتجاوز حقول المجموعات المسماة.

السماح بتنفيذ عمليات ALTER التي لا تؤثر فقط في البيانات الوصفية للجداول، بل أيضًا في البيانات المخزنة على القرص

يسمح بوسائط timezone غير الثابتة في بعض الدوال المرتبطة بالوقت مثل toTimeZone() و fromUnixTimestamp*() و snowflakeIDToDateTime*(). يوجد هذا الإعداد لأسباب التوافق فقط. في ClickHouse، تُعد timezone خاصيةً لنوع البيانات، وبالتالي للعمود أيضًا. يُوحي تمكين هذا الإعداد خطأً بأن القيم المختلفة داخل العمود يمكن أن تكون لها timezones مختلفة. لذلك، يُرجى عدم تمكين هذا الإعداد.

يتحكم هذا الإعداد في ما إذا كان يمكن إسناد النوع Nullable(Tuple(...)) إلى الأعمدة الفرعية المستخرجة من النوع Tuple(...).

• false: أعد Tuple(...) واستخدم قيم tuple الافتراضية للصفوف التي يكون فيها العمود الفرعي مفقودًا.
• true: أعد Nullable(Tuple(...)) واستخدم NULL للصفوف التي يكون فيها العمود الفرعي مفقودًا.

يتحكم هذا الإعداد في سلوك الأعمدة الفرعية المستخرجة فقط. ولا يتحكم في ما إذا كان يمكن إنشاء أعمدة Nullable(Tuple(...)) في الجداول؛ فهذا يتحكم فيه enable_nullable_tuple_type.

يستخدم ClickHouse القيمة المحمّلة لهذا الإعداد عند بدء تشغيل الخادم. ولا تؤدي التغييرات التي تُجرى باستخدام SET أو SETTINGS على مستوى الاستعلام إلى تغيير سلوك الأعمدة الفرعية المستخرجة. ولتغيير سلوك الأعمدة الفرعية المستخرجة، حدّث allow_nullable_tuple_in_extracted_subcolumns في تهيئة ملف التعريف عند بدء التشغيل (على سبيل المثال، users.xml) ثم أعد تشغيل الخادم.

السماح بتمرير وسائط إلى دالتي النافذة RANK وDENSE_RANK للحفاظ على التوافق مع الإصدارات السابقة.

وفقًا لمعيار SQL، لا تقبل RANK وDENSE_RANK أي وسائط — إذ ترتبان الصفوف استنادًا فقط إلى النافذة OVER (ORDER BY ...). في إصدارات ClickHouse السابقة لـ 26.5، كانت الاستعلامات مثل RANK(x) OVER (...) تُقبل بصمت مع تجاهل الوسيطة، مما سبّب إرباكًا للمستخدمين (إذ توحي الوسيطة الظاهرة بأنها تؤثر في الترتيب، لكنها في الواقع لا تفعل ذلك).

عندما يكون هذا الإعداد false (وهو الخيار الافتراضي)، ترفض RANK وDENSE_RANK أي وسائط وتُطلق الاستثناء NUMBER_OF_ARGUMENTS_DOESNT_MATCH. وعند ضبطه على true، يُستعاد السلوك القديم المتساهل — إذ تُتجاهل الوسائط بصمت، بما يطابق السلوك السابق قبل الإصدار 26.5.

يسمح بإعادة ترتيب الشروط عند نقلها من WHERE إلى PREWHERE لتحسين التصفية

اسمح لـ ALTER TABLE ... REPLACE PARTITION ... FROM ... بحذف partition الوجهة بصمت عندما لا يحتوي المصدر على أي أجزاء في ذلك الـ partition.

بشكل افتراضي، هذا غير مسموح به: إذ إن REPLACE PARTITION من مصدر لا يحتوي على بيانات في الـ partition المطلوب يُطلق استثناءً، لأن العملية في هذه الحالة تصبح فعليًا DROP PARTITION صامتًا على الوجهة (تُزال بيانات الوجهة ولا يستبدلها شيء)، وهو سبب شائع لفقدان البيانات عن طريق الخطأ (راجع #23727).

فعّل هذا الإعداد لاستعادة السلوك السابق، على سبيل المثال عندما تستخدم عمدًا partition فارغًا في المصدر لمسح البيانات في الوجهة. وإذا أردت حذفًا غير مشروط، فالأفضل استخدام ALTER TABLE ... DROP PARTITION ... بدلًا من ذلك.

تحكّم في السماح باستخدام SETTINGS بعد FORMAT في استعلامات INSERT من عدمه. لا يُنصح باستخدام هذا، لأن ذلك قد يؤدي إلى تفسير جزء من SETTINGS على أنه قيم.

مثال:

INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');

لكن لن يعمل الاستعلام التالي إلا عند استخدام allow_settings_after_format_in_insert:

SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;

القيم الممكنة:

• 0 — غير مسموح.
• 1 — مسموح.

يسمح باستخدام مكتبة simdjson في دوال 'JSON*' إذا كانت تعليمات AVX2 متوفرة. وإذا كان هذا الخيار معطّلًا، فستُستخدم rapidjson.

يسمح بإخراج الأعمدة ذات أنواع التسلسل الخاصة مثل Sparse وReplicated دون تحويلها إلى تمثيل الأعمدة الكامل. ويساعد ذلك على تجنب نسخ البيانات غير الضروري عند التنسيق.

يسمح بعمليات قراءة غير مقيّدة (من دون شرط على مسار) من جدول system.zookeeper، وقد يكون ذلك مفيدًا، لكنه غير آمن لـ ZooKeeper

فعّل التقييم المستقل لدوال النافذة لكل partition في خيوط تنفيذ منفصلة عندما يكون تعبير partition في جدول MergeTree دالة حتمية لأعمدة النافذة PARTITION BY. يُقرأ كل partition عبر تدفق منفصل، ويُفرز بشكل مستقل وفقًا لوصف فرز النافذة، ويُعالج بتحويل النافذة الخاص به، مع تجاوز تشتيت التجزئة الذي يعيد عادةً توزيع كل صف بين خيوط التنفيذ. يكون ذلك مفيدًا عندما يكون عدد partition قريبًا من عدد الأنوية وتكون أحجام partition متقاربة؛ وإلا تتخطاه آلية استدلالية للتكلفة. راجع max_number_of_partitions_for_independent_window وforce_window_partitions_independently. لا يُطبّق مع FINAL أو النسخ المتماثلة المتوازية.