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

enable_adaptive_aggregator

يُفعّل خوارزمية GROUP BY التكيفية: يُجمّع كل خيط البيانات في جدول التجزئة المحلي الخاص به حتى يبلغ adaptive_aggregator_freeze_threshold مفتاحًا (أو adaptive_aggregator_freeze_threshold_bytes من الذاكرة)، ثم يُجمَّد الجدول، بحيث تستمر صفوف المفاتيح المرصودة مسبقًا (المتكررة) في تحديثه مباشرةً، بينما تُوجَّه المفاتيح الجديدة (النادرة) وفق تجزئتها إلى قوائم انتظار لكل bucket وتُجمَّع مرة واحدة فقط ضمن الدمج المتوازي للـbucket. تبقى المفاتيح المتكررة في جداول صغيرة مقيمة في ذاكرة التخزين المؤقت، بينما تُخزَّن المفاتيح النادرة وتُعالج مرة واحدة بدلًا من مرة لكل خيط. تُراعى إعدادات التجميع الخارجي (max_bytes_before_external_group_by، max_bytes_ratio_before_external_group_by): عند تجاوز العتبة، تُفرَّغ قوائم الانتظار مبكرًا في الجدول المشترك، وإذا لم يكن ذلك كافيًا للعودة إلى ما دون العتبة، يُرحَّل الجدول المشترك إلى القرص باستخدام التجميع الخارجي العادي.

enable_adaptive_memory_spill_scheduler

يحفّز المعالج على تفريغ البيانات إلى التخزين الخارجي بشكل تكيّفي. يتوفر حاليًا دعم عمليات hash join القابلة للتفريغ، سواء grace_hash أو المسار التكيّفي hash / parallel_hash.

enable_add_distinct_to_in_subqueries

فعِّل DISTINCT في الاستعلامات الفرعية IN. هذا إعداد للموازنة بين الفوائد والتكلفة: إذ يمكن أن يؤدي تفعيله إلى تقليل حجم الجداول المؤقتة المنقولة للاستعلامات الفرعية IN الموزعة بشكل كبير، وتسريع نقل البيانات بين المقاطع بشكل ملحوظ، من خلال ضمان إرسال القيم الفريدة فقط. ومع ذلك، فإن تفعيل هذا الإعداد يضيف عبئًا إضافيًا على عمليات الدمج في كل عقدة، إذ يجب تنفيذ إزالة التكرار (DISTINCT). استخدم هذا الإعداد عندما يكون نقل البيانات عبر الشبكة هو عنق الزجاجة وتكون الكلفة الإضافية للدمج مقبولة.

enable_alp_codec

يُمكّن برنامج الترميز لضغط ALP.

enable_automatic_decision_for_merging_across_partitions_for_final

إذا تم تعيينه، فسيُفعِّل ClickHouse هذا التحسين تلقائيًا عندما يكون تعبير مفتاح التقسيم حتميًا، وعندما تكون جميع الأعمدة المستخدمة في تعبير مفتاح التقسيم مُضمَّنة في المفتاح الأساسي. ويضمن هذا الاستنتاج التلقائي أن الصفوف ذات قيم المفتاح الأساسي نفسها ستنتمي دائمًا إلى التقسيم نفسه، مما يجعل تجنّب عمليات الدمج عبر التقسيمات آمنًا. تُستثنى أعمدة المفاتيح ذات الفاصلة العائمة من هذا الاستنتاج، إذ إن مُقارِن FINAL أقل دقة من تطابق القيم بالنسبة إلى Float32 وFloat64 وBFloat16: فالقيمة -0.0 تُعدّ مساوية لـ 0.0، وكل نمط بتات لـ NaN يُعدّ مساويًا لأي نمط آخر. أما تعبير التقسيم فيميّز بين تلك القيم تمييزًا دقيقًا، ولذلك قد تقع الصفوف التي يعاملها المُقارِن كمفتاح واحد في تقسيمات مختلفة، وعندها سيؤدي تخطّي الدمج عبر التقسيمات إلى إرجاعها جميعًا. وينطبق هذا الاستثناء أيضًا عندما يكون النوع العائم مُتداخلًا داخل عمود مفتاح، مثل Tuple(Float64, UInt8) أو Array(Float64).

enable_cascades_optimizer

فعّل مُحسِّن Cascades المعتمد على التكلفة لخطط الاستعلامات الموزعة. لا يسري مفعوله إلا عند استخدام make_distributed_plan = 1: فهذا الإعداد وحده لا يغيّر تخطيط الاستعلامات على عقدة واحدة.

enable_early_constant_folding

تمكين تحسين الاستعلام، حيث نحلل نتائج الدوال والاستعلامات الفرعية ونعيد كتابة الاستعلام إذا كانت تتضمن ثوابت

enable_extended_results_for_datetime_functions

يؤدي إلى تمكين أو تعطيل إرجاع نتائج من النوع Date32 بنطاق موسّع (مقارنةً بالنوع Date) أو من النوع DateTime64 بنطاق موسّع (مقارنةً بالنوع DateTime). القيم الممكنة:
  • 0 — تُرجِع الدوال Date أو DateTime لجميع أنواع الوسيطات.
  • 1 — تُرجِع الدوال Date32 أو DateTime64 عند استخدام وسيطات من النوع Date32 أو DateTime64، وتُرجِع Date أو DateTime في غير ذلك.
يوضح الجدول أدناه سلوك هذا الإعداد في دوال التاريخ والوقت المختلفة.

enable_full_text_index

الأسماء البديلة: allow_experimental_full_text_index إذا ضُبط هذا الإعداد على true، فسيُسمح باستخدام فهرس النص الكامل.

enable_function_early_short_circuit

فعّل طيّ الثوابت مبكرًا باستخدام التقييم قصير الدائرة لـ and وor أثناء تحليل الاستعلام. عند تفعيله، تُحلَّل الفروع غير القابلة للوصول والمؤهلة في الاستعلامات الفرعية القياسية للحفاظ على أنواعها والتحقق من دلالات الاستعلام، لكنها لا تُنفَّذ. ويعود التحسين إلى التحليل العادي عندما تكون قيمة العددية القياسية أو قيم وقت التشغيل مطلوبة.

enable_funnel_functions

اسم بديل: allow_experimental_funnel_functions تمكين الدوال الخاصة بتحليل مسار التحويل.

enable_global_with_statement

تمرير عبارات WITH إلى استعلامات UNION وجميع الاستعلامات الفرعية

enable_group_by_top_k_optimization

فعّل تحسين تصفية TopK أثناء التجميع في استعلامات GROUP BY keys ORDER BY <prefix of keys> LIMIT K، وكذلك في استعلامات GROUP BY keys LIMIT K التي لا تتضمن ORDER BY (إذ تكون أي مجموعات K نتيجة صالحة، لذا يُنشأ فرز على جميع المفاتيح). عند تفعيله، يحتفظ المُجمِّع بكومة محدودة تضم أفضل K مفاتيح ظهرت حتى الآن، ويتخطى إدراج صفوف جديدة في جدول التجزئة عندما لا يمكن لمفتاح التجميع الخاص بها أن يندرج ضمن النتيجة النهائية. يؤدي ذلك إلى تجنب تجميع الصفوف التي سيتخلص منها ORDER BY ... LIMIT اللاحق. وعندما ترتب الكومة مفتاح GROUP BY بالكامل، فإنها تحذف أيضًا المجموعات المُزالة من جدول التجزئة الوسيط، مما يحدّ حجمه بـ LIMIT بدلًا من عدد المفاتيح المميزة. أما عندما يغطي ORDER BY بادئة حقيقية فقط من مفاتيح GROUP BY، فلا يمكن للترتيب تحديد مجموعة كاملة، لذا لا يُطبّق سوى تخطي الصفوف: يحتفظ جدول التجزئة بكل مجموعة مقبولة، وقد يستمر في النمو بحسب عدد عناصر أعمدة المفاتيح المتبقية. يُعطّل التحسين عندما يتجاوز LIMIT المطلوب query_plan_max_limit_for_top_k_optimization أو الحد الأقصى الصارم البالغ 100000، لأن تكلفة الذاكرة ووحدة المعالجة المركزية للكومة تزداد بزيادة LIMIT المطلوب. يُتخطى التحسين في أشكال الاستعلامات التي قد يؤدي فيها حذف المجموعات إلى تغيير النتيجة، بما في ذلك WITH TOTALS وHAVING وQUALIFY ودوال النافذة وROLLUP/CUBE/GROUPING SETS وLIMIT WITH TIES، ووجود COLLATE على أي من مفاتيح GROUP BY المطابقة (أما COLLATE على عمود ORDER BY لاحق بعد بادئة المفتاح الكاملة فلا يمكن أن يؤثر في المجموعات المؤهلة، لذا لا يعطّل التحسين)، وORDER BY على قيمة مجمّعة أو على أي عنصر ليس بادئة أولية من مفاتيح GROUP BY، وعند تعيين max_rows_to_group_by أو exact_rows_before_limit. القيم الممكنة:
  • 0 — معطّل.
  • 1 — مفعّل.

enable_hash_join_row_store

تمكين تحويل حمولة hash join إلى تخطيط صفّي.

enable_hdfs_pread

يُفعِّل أو يُعطِّل pread لملفات HDFS. افتراضيًا، يُستخدَم hdfsPread. وإذا تم تعطيله، فسيُستخدَم hdfsRead وhdfsSeek لقراءة ملفات HDFS.

enable_http_compression

يُمكّن ضغط البيانات في الاستجابة لطلب HTTP أو يعطّله. لمزيد من المعلومات، اقرأ وصف واجهة HTTP. القيم الممكنة:
  • 0 — معطّل.
  • 1 — مفعّل.

enable_identifier_resolve_cache

يُمكّن ذاكرة التخزين المؤقت لحلّ المعرّفات في محلل الاستعلامات. تعيد ذاكرة التخزين المؤقت استخدام عُقد الأسماء المستعارة التي جرى حلّها لمنع تضخّم AST عند الرجوع إلى الاسم المستعار نفسه عدة مرات. اضبط القيمة على false لتعطيل التخزين المؤقت إذا كان هناك اشتباه في نتائج غير صحيحة.

enable_job_stack_trace

يُخرج تتبّع المكدس لمنشئ المهمة عندما تؤدي المهمة إلى استثناء. وهو معطّل افتراضيًا لتجنّب الكلفة الإضافية على الأداء.

enable_json_ast_dialect

فعّل القيمة clickhouse_json لإعداد dialect. عند ضبط dialect على clickhouse_json، تُفسَّر الاستعلامات على أنها أشجار AST بتنسيق JSON (ناتج parseQueryToJSON) بدلاً من نص SQL. يظل استعلام SET مُحلَّلاً بصيغة SQL عادية، بحيث يمكن تبديل اللهجة مرة أخرى. مثال:

enable_json_lazy_type_hints

اسم بديل: allow_experimental_json_lazy_type_hints يُمكّن تلميحات النوع المؤجّلة لنوع JSON. عند تمكين هذا الإعداد، فإن ALTER TABLE ... MODIFY COLUMN json JSON(path TypeName) الذي يقتصر على إضافة تلميحات النوع أو تغييرها يكون عملية على البيانات الوصفية فقط: إذ تُطبَّق تلميحات النوع وقت الاستعلام على أجزاء البيانات الموجودة وتُجسَّد أثناء عمليات الإدراج وعمليات الدمج في الخلفية بدلاً من إعادة كتابة البيانات التاريخية.

enable_lazy_columns_replication

يُمكّن النسخ الكسول للأعمدة في JOIN وARRAY JOIN والتقاطات لامبدا للدوال عالية الرتبة (مثل arrayMap)، مما يجنّب نسخ الصفوف نفسها في الذاكرة عدة مرات دون داعٍ.

enable_materialized_cte

تمكين تعبيرات الجدول الشائعة المُجسَّدة (WITH <name> AS MATERIALIZED (<subquery>)). عند التمكين، يُنفَّذ تعبير الجدول الشائع المُعلَن بوصفه MATERIALIZED والمُشار إليه أكثر من مرة تنفيذًا واحدًا فقط، ويُخزَّن في جدول مؤقت، وتقرأ جميع الإشارات من ذلك الجدول. أما تعبير الجدول الشائع المُشار إليه مرة واحدة فقط، فيُدمَج مباشرةً كتعبير جدول شائع عادي لتجنّب الكلفة الإضافية. وعند التعطيل، تُتجاهل الكلمة المفتاحية MATERIALIZED: فيُدمَج تعبير الجدول الشائع مباشرةً عند كل إشارة إليه كتعبير جدول شائع عادي، ويُسجَّل تحذير.

enable_materialized_postgresql_table

الأسماء البديلة: allow_experimental_materialized_postgresql_table يسمح باستخدام محرك الجداول MaterializedPostgreSQL.

enable_memory_bound_merging_of_aggregation_results

فعّل استراتيجية الدمج المقيّدة بالذاكرة لنتائج التجميع.

enable_multiple_prewhere_read_steps

انقل مزيدًا من الشروط من WHERE إلى PREWHERE، ونفّذ القراءة من القرص والتصفية على مراحل متعددة إذا كانت هناك شروط متعددة مدمجة باستخدام AND

enable_named_columns_in_function_tuple

إنشاء tuples مسماة في الدالة tuple() عندما تكون جميع الأسماء فريدة ويمكن التعامل معها كمُعرِّفات غير مقتبسة.

enable_nullable_tuple_type

اسم بديل: allow_experimental_nullable_tuple_type يتيح إنشاء columns من النوع Nullable Tuple في الجداول. لا يتحكم هذا الإعداد في إمكانية أن تكون subcolumns الـ tuple المستخرجة من النوع Nullable (على سبيل المثال، من columns من النوع Dynamic أو Variant أو JSON أو Tuple). استخدم allow_nullable_tuple_in_extracted_subcolumns للتحكم في إمكانية أن تكون subcolumns الـ tuple المستخرجة من النوع Nullable.

enable_order_by_all

يتيح أو يعطّل الفرز باستخدام الصيغة ORDER BY ALL، راجع ORDER BY. القيم الممكنة:
  • 0 — تعطيل ORDER BY ALL.
  • 1 — تمكين ORDER BY ALL.
مثال الاستعلام:
النتيجة:

enable_packed_string_keys_in_aggregation

استخدم جدول تجزئة بمفاتيح من مراجع سلاسل معبأة بطول 16 بايتًا (PackedStringRef) مع GROUP BY ذي مفتاح String واحد غير قابل لـ NULL. تُخزَّن المفاتيح التي يصل طولها إلى 11 بايتًا مباشرةً في المرجع المعبأ، بينما تُخزَّن المفاتيح الأطول بالإشارة إليها في Arena. يكون هذا أسرع في معظم أحمال العمل، لكنه قد يكون أبطأ من الطريقة القديمة عند استخدام GROUP BY مع عدد قليل جدًا من المفاتيح المميزة التي يزيد طولها على 11 بايتًا، ولا سيما بطول 12..24 بايتًا؛ إذ يحتفظ جدول التجزئة القديم بالمفاتيح مباشرةً في الخلية، بينما يفك الجدول المعبأ مرجع مؤشر Arena عند كل عملية بحث. عند تعطيله، تُستخدم الطريقة القديمة المستندة إلى StringHashTable، وهي الطريقة الافتراضية قبل الإصدار 26.8. يجب أن تتفق جميع الخوادم المشاركة في استعلام موزّع على هذه القيمة. فعند استخدام distributed_aggregation_memory_efficient، تعتمد أرقام buckets ثنائية المستوى على تجزئة المفتاح، وهي تختلف بين الطريقتين؛ لذلك قد تقسم الخوادم التي تختلف في هذا الإعداد المفتاح نفسه إلى buckets مختلفة وتنتج نتيجة مدمجة بصورة غير صحيحة. ولضمان هذا الاتفاق، ترسل initiator دائمًا قيمتها الفعلية مع الاستعلامات الثانوية، حتى عندما تكون مستمدة فقط من الإعدادات الافتراضية للخادم/الملف الشخصي، متجاوزةً الإعدادات الافتراضية للخوادم البعيدة.

enable_parsing_to_custom_serialization

إذا كانت القيمة true، فيمكن تحليل البيانات مباشرةً إلى الأعمدة ذات التسلسل المخصّص (مثل Sparse) وفقًا لتلميحات التسلسل المستمدة من الجدول.

enable_producing_buckets_out_of_order_in_aggregation

السماح للتجميع الموفّر للذاكرة (راجع distributed_aggregation_memory_efficient) بإنتاج buckets بترتيب غير متسلسل. قد يحسّن ذلك الأداء عندما تكون أحجام buckets التجميع غير متوازنة، إذ يتيح للنسخة المتماثلة إرسال buckets ذات المعرّفات الأعلى إلى initiator بينما تواصل معالجة بعض buckets الكبيرة ذات المعرّفات الأقل. والجانب السلبي هو احتمال زيادة استخدام الذاكرة.

enable_quantized_codec

يُمكّن برنامج الترميز للضغط Quantized.

enable_reads_from_query_cache

إذا كان هذا الخيار مفعّلًا، فستُسترجَع نتائج استعلامات SELECT من ذاكرة التخزين المؤقت للاستعلامات. القيم الممكنة:
  • 0 - معطّل
  • 1 - مفعّل

enable_s3_requests_logging

يُفعّل تسجيلًا مفصلًا جدًا لطلبات S3. وهذا مناسب لأغراض التصحيح فقط.

enable_scalar_subquery_optimization

إذا تم ضبطه على true، فإنه يمنع الاستعلامات الفرعية ذات القيمة المفردة من تسلسل/إلغاء تسلسل القيم المفردة الكبيرة، وقد يجنّب تنفيذ الاستعلام الفرعي نفسه أكثر من مرة.

enable_scopes_for_with_statement

إذا كان هذا الإعداد معطّلًا، فستتصرّف التعريفات في عبارات WITH الأب كما لو كانت مُعلنة ضمن النطاق الحالي نفسه. لاحظ أن هذا إعداد توافق للمحلل يتيح تشغيل بعض الاستعلامات غير الصالحة التي كان المحلل القديم يستطيع تنفيذها.

enable_shared_storage_snapshot_in_query

إذا كان مُمكّنًا، فستشارك جميع الاستعلامات الفرعية ضمن استعلام واحد نفس StorageSnapshot لكل جدول. ويضمن ذلك عرضًا متسقًا للبيانات على مستوى الاستعلام بأكمله، حتى إذا جرى الوصول إلى الجدول نفسه عدة مرات. وهذا مطلوب للاستعلامات التي يكون فيها الاتساق الداخلي لأجزاء البيانات مهمًا. مثال:
من دون هذا الإعداد، قد تعمل الاستعلامات الخارجية والداخلية على لقطات مختلفة من البيانات، مما يؤدي إلى نتائج غير صحيحة. القيم الممكنة:
  • 0 - معطّل
  • 1 - مفعّل

enable_sharing_sets_for_mutations

السماح بمشاركة كائنات set المُنشأة من أجل الاستعلامات الفرعية IN بين المهام المختلفة ضمن عملية mutation نفسها. يقلل ذلك من استخدام الذاكرة واستهلاك وحدة المعالجة المركزية

enable_streaming_queries

يسمح بالاستعلامات المستمرة SELECT ... FROM t STREAM [CURSOR '{...}']. عند إيقافه، يُرفَض أي تعبير جدول يستخدم المعدِّل STREAM أثناء بناء الخطة. هذا هو مفتاح التحكم الرئيسي لميزة الاستعلامات المتدفقة؛ وقد تُقيَّد إمكانات إضافية بإعداداتها الخاصة.

enable_sz3_codec

يُمكّن برنامج الترميز للضغط SZ3.

enable_time_series_aggregate_functions

الأسماء البديلة: allow_experimental_ts_to_grid_aggregate_function, allow_experimental_time_series_aggregate_functions يُفعّل دوال التجميع timeSeries* الخاصة بإعادة أخذ عينات السلاسل الزمنية على غرار Prometheus، وحساب rate ودلتا.

enable_time_series_table

الأسماء البديلة: allow_experimental_time_series_table يسمح بإنشاء جداول بمحرك الجداول TimeSeries. القيم الممكنة:
  • 0 — محرك الجداول TimeSeries معطّل.
  • 1 — محرك الجداول TimeSeries مُفعّل.

enable_time_time64_type

الأسماء البديلة: allow_experimental_time_time64_type يسمح بإنشاء نوعَي البيانات Time وTime64.

enable_trino_dialect

فعّل القيمة trino للإعداد dialect. عند ضبط dialect على trino، تُكتب الاستعلامات بلغة Trino SQL: إذ يُترجم بناء الجملة الخاص بـ Trino (القيم الحرفية ARRAY[...] وTRY_CAST وUNNEST وأنواع ROW وOFFSET قبل LIMIT) إلى ClickHouse SQL، وتُطابق أسماء دوال Trino مع مكافئاتها في ClickHouse. يظل استعلام SET محللًا بصيغة SQL عادية، بحيث يمكن إعادة تبديل اللهجة. تتوافق دلالات الاستعلام أيضًا مع Trino: إذ يُفعّل join_use_nulls، ويُعطّل use_variant_as_common_type، ويُفعّل محلّل الاستعلامات. وتظل عبارة SETTINGS الصريحة في الاستعلام ذات أولوية أعلى.

enable_unaligned_array_join

يسمح باستخدام ARRAY JOIN مع عدة مصفوفات ذات أحجام مختلفة. عند تمكين هذا الإعداد، سيُعاد ضبط حجم المصفوفات وفقًا لأطولها.

enable_unique_key

اسم بديل: allow_experimental_unique_key يسمح بإنشاء جداول تتضمن الـ clause UNIQUE KEY في engines عائلة MergeTree.

enable_url_encoding

يسمح بتمكين أو تعطيل فك ترميز المسار وترميزه في عنوان URI في جداول محرك URL. يكون معطّلًا افتراضيًا.

enable_vertical_final

عند التمكين، تُزال الصفوف المكررة أثناء FINAL عبر تمييز الصفوف على أنها محذوفة ثم ترشيحها لاحقًا بدلًا من دمج الصفوف

enable_writes_to_query_cache

إذا كان هذا الإعداد مفعّلًا، فسيتم تخزين نتائج استعلامات SELECT في ذاكرة التخزين المؤقت للاستعلامات. القيم الممكنة:
  • 0 - معطّل
  • 1 - مفعّل

enable_zxc_codec

يُمكّن برنامج الترميز للضغط ZXC.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦