> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# إعدادات الجلسة enable_*
> إعدادات جلسة ClickHouse ضمن المجموعة المُولَّدة enable_*.
export const ExperimentalBadge = () => {
return
ميزة تجريبية
;
};
export const VersionHistory = ({rows = []}) => {
if (rows.length === 0) {
return null;
}
const headers = ["الإصدار", "القيمة الافتراضية", "التعليق"];
const border = "1px solid rgba(128, 128, 128, 0.3)";
const cell = {
border,
padding: "0.25rem 0.5rem",
textAlign: "start",
verticalAlign: "top"
};
return
سجل الإصدارات
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
هذه الإعدادات متاحة في [system.settings](/ar/reference/system-tables/settings)، وهي مُولَّدة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## enable\_adaptive\_aggregator
يُفعّل خوارزمية `GROUP BY` التكيفية: يُجمّع كل خيط البيانات في جدول التجزئة المحلي الخاص به حتى يبلغ `adaptive_aggregator_freeze_threshold` مفتاحًا، ثم يُجمَّد الجدول، بحيث تستمر صفوف المفاتيح المرصودة مسبقًا (المتكررة) في تحديثه مباشرةً، بينما تُوجَّه المفاتيح الجديدة (النادرة) وفق تجزئتها إلى قوائم انتظار لكل bucket وتُجمَّع مرة واحدة فقط ضمن الدمج المتوازي للـbucket. تبقى المفاتيح المتكررة في جداول صغيرة مقيمة في ذاكرة التخزين المؤقت، بينما تُخزَّن المفاتيح النادرة وتُعالج مرة واحدة بدلًا من مرة لكل خيط.
تُراعى إعدادات التجميع الخارجي (`max_bytes_before_external_group_by`، `max_bytes_ratio_before_external_group_by`): عند تجاوز العتبة، تُفرَّغ قوائم الانتظار مبكرًا في الجدول المشترك، وإذا لم يكن ذلك كافيًا للعودة إلى ما دون العتبة، يُرحَّل الجدول المشترك إلى القرص باستخدام التجميع الخارجي العادي.
## enable\_adaptive\_memory\_spill\_scheduler
يحفّز المعالج على تفريغ البيانات إلى التخزين الخارجي بشكل تكيّفي. يتوفر دعم grace join حاليًا.
## enable\_add\_distinct\_to\_in\_subqueries
فعِّل `DISTINCT` في الاستعلامات الفرعية `IN`. هذا إعداد للموازنة بين الفوائد والتكلفة: إذ يمكن أن يؤدي تفعيله إلى تقليل حجم الجداول المؤقتة المنقولة للاستعلامات الفرعية `IN` الموزعة بشكل كبير، وتسريع نقل البيانات بين المقاطع بشكل ملحوظ، من خلال ضمان إرسال القيم الفريدة فقط.
ومع ذلك، فإن تفعيل هذا الإعداد يضيف عبئًا إضافيًا على عمليات الدمج في كل عقدة، إذ يجب تنفيذ إزالة التكرار (`DISTINCT`). استخدم هذا الإعداد عندما يكون نقل البيانات عبر الشبكة هو عنق الزجاجة وتكون الكلفة الإضافية للدمج مقبولة.
## enable\_automatic\_decision\_for\_merging\_across\_partitions\_for\_final
إذا تم تعيينه، فسيُفعِّل ClickHouse هذا التحسين تلقائيًا عندما يكون تعبير مفتاح التقسيم حتميًا، وعندما تكون جميع الأعمدة المستخدمة في تعبير مفتاح التقسيم مُضمَّنة في المفتاح الأساسي.
ويضمن هذا الاستنتاج التلقائي أن الصفوف ذات قيم المفتاح الأساسي نفسها ستنتمي دائمًا إلى القسم نفسه، مما يجعل تجنّب عمليات الدمج عبر الأقسام آمنًا.
## 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` في غير ذلك.
يوضح الجدول أدناه سلوك هذا الإعداد في دوال التاريخ والوقت المختلفة.
| Function | `enable_extended_results_for_datetime_functions = 0` | `enable_extended_results_for_datetime_functions = 1` |
| ------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `toStartOfYear` | يعيد `Date` أو `DateTime` | يعيد `Date`/`DateTime` عند الإدخال من النوع `Date`/`DateTime`
يعيد `Date32`/`DateTime64` عند الإدخال من النوع `Date32`/`DateTime64` |
| `toStartOfISOYear` | يعيد `Date` أو `DateTime` | يُرجِع `Date`/`DateTime` عند إدخال `Date`/`DateTime`
ويُرجِع `Date32`/`DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toStartOfQuarter` | يُرجِع `Date` أو `DateTime` | تُرجع `Date`/`DateTime` عند إدخال `Date`/`DateTime`
تُرجع `Date32`/`DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toStartOfMonth` | ترجع `Date` أو `DateTime` | يُرجع `Date`/`DateTime` مع إدخال `Date`/`DateTime`
ويُرجع `Date32`/`DateTime64` مع إدخال `Date32`/`DateTime64` |
| `toStartOfWeek` | تُرجِع `Date` أو `DateTime` | يعيد `Date`/`DateTime` عند إدخال `Date`/`DateTime`
ويعيد `Date32`/`DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toLastDayOfWeek` | يُرجع `Date` أو `DateTime` | يُرجِع `Date`/`DateTime` عند إدخال `Date`/`DateTime`
يُرجِع `Date32`/`DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toLastDayOfMonth` | يرجع `Date` أو `DateTime` | يُرجِع `Date`/`DateTime` عند إدخال `Date`/`DateTime`
يُرجِع `Date32`/`DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toMonday` | تُرجع `Date` أو `DateTime` | يعيد `Date`/`DateTime` عند الإدخال من النوع `Date`/`DateTime`
يعيد `Date32`/`DateTime64` عند الإدخال من النوع `Date32`/`DateTime64` |
| `toStartOfDay` | يُرجع `DateTime`
*ملاحظة: يعطي نتائج غير صحيحة للقيم خارج النطاق 1970-2149* | تعيد `DateTime` عند إدخال `Date`/`DateTime`
تعيد `DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toStartOfHour` | يُرجِع `DateTime`
*ملاحظة: النتائج غير صحيحة للقيم خارج النطاق 1970-2149* | يعيد `DateTime` عند الإدخال من نوع `Date`/`DateTime`
ويعيد `DateTime64` عند الإدخال من نوع `Date32`/`DateTime64` |
| `toStartOfFifteenMinutes` | يُرجِع `DateTime`
*ملاحظة: تكون النتائج غير صحيحة للقيم الواقعة خارج النطاق من 1970 إلى 2149* | يُرجع `DateTime` عند الإدخال من النوع `Date`/`DateTime`
ويُرجع `DateTime64` عند الإدخال من النوع `Date32`/`DateTime64` |
| `toStartOfTenMinutes` | تُرجع `DateTime`
*ملاحظة: نتائج غير صحيحة للقيم الواقعة خارج النطاق 1970-2149* | يعيد `DateTime` للإدخال من نوع `Date`/`DateTime`
يعيد `DateTime64` للإدخال من نوع `Date32`/`DateTime64` |
| `toStartOfFiveMinutes` | يعيد `DateTime`
*ملاحظة: تكون النتائج غير صحيحة للقيم خارج النطاق 1970-2149* | يعيد `DateTime` عند إدخال `Date`/`DateTime`
ويعيد `DateTime64` عند إدخال `Date32`/`DateTime64` |
| `toStartOfMinute` | يُرجع `DateTime`
*ملاحظة: تكون النتائج غير صحيحة للقيم خارج النطاق 1970-2149* | يعيد `DateTime` عند استخدام الإدخال `Date`/`DateTime`
يعيد `DateTime64` عند استخدام الإدخال `Date32`/`DateTime64` |
| `timeSlot` | يعيد `DateTime`
*ملاحظة: تكون النتائج غير صحيحة للقيم الواقعة خارج النطاق 1970-2149* | يعيد `DateTime` عند إدخال `Date`/`DateTime`
يعيد `DateTime64` عند إدخال `Date32`/`DateTime64` |
## enable\_full\_text\_index
**الأسماء البديلة**: `allow_experimental_full_text_index`
إذا ضُبط هذا الإعداد على true، فسيُسمح باستخدام فهرس النص الكامل.
## enable\_global\_with\_statement
تمرير عبارات WITH إلى استعلامات UNION وجميع الاستعلامات الفرعية
## enable\_hdfs\_pread
يُفعِّل أو يُعطِّل `pread` لملفات HDFS. افتراضيًا، يُستخدَم `hdfsPread`. وإذا تم تعطيله، فسيُستخدَم `hdfsRead` و`hdfsSeek` لقراءة ملفات HDFS.
## enable\_http\_compression
يُمكّن ضغط البيانات في الاستجابة لطلب HTTP أو يعطّله.
لمزيد من المعلومات، اقرأ [وصف واجهة HTTP](/ar/concepts/features/interfaces/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 عادية، بحيث يمكن تبديل اللهجة مرة أخرى.
مثال:
```sql theme={null}
SET enable_json_ast_dialect = 1;
SET dialect = 'clickhouse_json';
-- Subsequent queries are parsed as JSON ASTs:
{"type":"SelectWithUnionQuery", ...}
```
## enable\_lazy\_columns\_replication
يُمكّن النسخ الكسول للأعمدة في `JOIN` و`ARRAY JOIN` والتقاطات لامبدا للدوال عالية الرتبة (مثل `arrayMap`)، مما يجنّب نسخ الصفوف نفسها في الذاكرة عدة مرات دون داعٍ.
## enable\_materialized\_cte
تمكين تعبيرات الجدول الشائعة المُجسَّدة؛ وسيُفضَّل هذا الإعداد على enable\_global\_with\_statement
## enable\_memory\_bound\_merging\_of\_aggregation\_results
فعّل استراتيجية الدمج المقيّدة بالذاكرة لنتائج التجميع.
## enable\_multiple\_prewhere\_read\_steps
انقل مزيدًا من الشروط من WHERE إلى PREWHERE، ونفّذ القراءة من القرص والتصفية على مراحل متعددة إذا كانت هناك شروط متعددة مدمجة باستخدام AND
## enable\_named\_columns\_in\_function\_tuple
إنشاء tuples مسماة في الدالة tuple() عندما تكون جميع الأسماء فريدة ويمكن التعامل معها كمُعرِّفات غير مقتبسة.
## enable\_order\_by\_all
يتيح أو يعطّل الفرز باستخدام الصيغة `ORDER BY ALL`، راجع [ORDER BY](/ar/reference/statements/select/order-by).
القيم الممكنة:
* 0 — تعطيل ORDER BY ALL.
* 1 — تمكين ORDER BY ALL.
**مثال**
الاستعلام:
```sql theme={null}
CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();
INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);
SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous
SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;
```
النتيجة:
```text theme={null}
┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │ 10 │
│ 30 │ 10 │ 20 │
│ 10 │ 20 │ 30 │
└────┴────┴─────┘
```
## 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\_reads\_from\_query\_cache
إذا كان هذا الخيار مفعّلًا، فستُسترجَع نتائج استعلامات `SELECT` من [ذاكرة التخزين المؤقت للاستعلامات](/ar/concepts/features/performance/caches/query-cache).
القيم الممكنة:
* 0 - معطّل
* 1 - مفعّل
## enable\_s3\_requests\_logging
يُفعّل تسجيلًا مفصلًا جدًا لطلبات S3. وهذا مناسب لأغراض التصحيح فقط.
## enable\_scalar\_subquery\_optimization
إذا تم ضبطه على true، فإنه يمنع الاستعلامات الفرعية ذات القيمة المفردة من تسلسل/إلغاء تسلسل القيم المفردة الكبيرة، وقد يجنّب تنفيذ الاستعلام الفرعي نفسه أكثر من مرة.
## enable\_scopes\_for\_with\_statement
إذا كان هذا الإعداد معطّلًا، فستتصرّف التعريفات في عبارات WITH الأب كما لو كانت مُعلنة ضمن النطاق الحالي نفسه.
لاحظ أن هذا إعداد توافق للمحلل يتيح تشغيل بعض الاستعلامات غير الصالحة التي كان المحلل القديم يستطيع تنفيذها.
## enable\_sharding\_aggregator
يُمكّن تحسين `GROUP BY` المُشطَّر، الذي يوزّع الصفوف على الخيوط عبر تجزئة مفتاح التجميع، بحيث يُجمّع كل خيط مجموعة فرعية مستقلة من المفاتيح من دون مرحلة دمج.
يكون هذا فعّالًا للمفاتيح عالية الكاردينالية عندما تكون البيانات موزّعة بالتساوي، لكنه قد يتأثر سلبًا عند وجود توزيعات شديدة الانحراف للمفاتيح أو استعلامات تتضمن عددًا قليلًا جدًا من المفاتيح المميزة.
القيم الممكنة:
* 0 — تحسين التجميع المُشطَّر معطّل.
* 1 — تحسين التجميع المُشطَّر مفعّل.
## enable\_shared\_storage\_snapshot\_in\_query
إذا كان مُمكّنًا، فستشارك جميع الاستعلامات الفرعية ضمن استعلام واحد نفس `StorageSnapshot` لكل جدول.
ويضمن ذلك عرضًا متسقًا للبيانات على مستوى الاستعلام بأكمله، حتى إذا جرى الوصول إلى الجدول نفسه عدة مرات.
وهذا مطلوب للاستعلامات التي يكون فيها الاتساق الداخلي لأجزاء البيانات مهمًا. مثال:
```sql theme={null}
SELECT
count()
FROM events
WHERE (_part, _part_offset) IN (
SELECT _part, _part_offset
FROM events
WHERE user_id = 42
)
```
من دون هذا الإعداد، قد تعمل الاستعلامات الخارجية والداخلية على لقطات مختلفة من البيانات، مما يؤدي إلى نتائج غير صحيحة.
القيم الممكنة:
* 0 - معطّل
* 1 - مفعّل
## enable\_sharing\_sets\_for\_mutations
السماح بمشاركة كائنات set المُنشأة من أجل الاستعلامات الفرعية IN بين المهام المختلفة ضمن عملية mutation نفسها. يقلل ذلك من استخدام الذاكرة واستهلاك CPU
## enable\_streaming\_queries
يسمح بالاستعلامات المستمرة `SELECT ... FROM t STREAM [CURSOR '{...}']`.
عند إيقافه، يُرفَض أي تعبير جدول يستخدم المعدِّل `STREAM`
أثناء بناء الخطة. هذا هو مفتاح التحكم الرئيسي لميزة
الاستعلامات المتدفقة؛ وقد تُقيَّد إمكانات إضافية بإعداداتها الخاصة.
## enable\_time\_time64\_type
**الأسماء البديلة**: `allow_experimental_time_time64_type`
يسمح بإنشاء نوعَي البيانات [Time](/ar/reference/data-types/time) و[Time64](/ar/reference/data-types/time64).
## enable\_unaligned\_array\_join
يسمح باستخدام ARRAY JOIN مع عدة مصفوفات ذات أحجام مختلفة. عند تمكين هذا الإعداد، سيُعاد ضبط حجم المصفوفات وفقًا لأطولها.
## enable\_url\_encoding
يسمح بتمكين أو تعطيل فك ترميز المسار وترميزه في عنوان URI في جداول محرك [URL](/ar/reference/engines/table-engines/special/url).
يكون معطّلًا افتراضيًا.
## enable\_vertical\_final
عند التمكين، تُزال الصفوف المكررة أثناء FINAL عبر تمييز الصفوف على أنها محذوفة ثم ترشيحها لاحقًا بدلًا من دمج الصفوف
## enable\_writes\_to\_query\_cache
إذا كان هذا الإعداد مفعّلًا، فسيتم تخزين نتائج استعلامات `SELECT` في [ذاكرة التخزين المؤقت للاستعلامات](/ar/concepts/features/performance/caches/query-cache).
القيم الممكنة:
* 0 - معطّل
* 1 - مفعّل