> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# إعدادات session use_*
> إعدادات session في ClickHouse ضمن المجموعة المُنشأة use_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const ExperimentalBadge = () => {
return ;
};
هذه الإعدادات متاحة في [system.settings](/docs/ar/reference/system-tables/settings)، وقد وُلِّدت تلقائيًا من [الشفرة المصدرية](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## use\_async\_executor\_for\_materialized\_views
يستخدم تنفيذًا غير متزامن، وربما متعدد الخيوط، لاستعلام العرض المادي، ما قد يسرّع معالجة العروض أثناء INSERT، لكنه يستهلك أيضًا مزيدًا من الذاكرة.
## use\_cache\_for\_count\_from\_files
يُفعّل التخزين المؤقت لعدد الصفوف عند احتسابها من الملفات في دوال الجداول `file`/`s3`/`url`/`hdfs`/`azureBlobStorage`.
يكون مفعّلًا افتراضيًا.
## use\_client\_time\_zone
استخدم المنطقة الزمنية للعميل لتفسير قيم السلاسل النصية من نوع DateTime بدلًا من استخدام المنطقة الزمنية للخادم.
## use\_compact\_format\_in\_distributed\_parts\_names
يستخدم التنسيق المضغوط لتخزين الكتل الخاصة بعمليات INSERT في الخلفية (`distributed_foreground_insert`) إلى الجداول التي تستخدم المحرك `Distributed`.
القيم الممكنة:
* 0 — يستخدم تنسيق الدليل `user[:password]@host:port#default_database`.
* 1 — يستخدم تنسيق الدليل `[shard{shard_index}[_replica{replica_index}]]`.
- عند استخدام `use_compact_format_in_distributed_parts_names=0`، لن تُطبَّق التغييرات في تعريف العنقود على عمليات INSERT في الخلفية.
- عند استخدام `use_compact_format_in_distributed_parts_names=1`، فإن تغيير ترتيب العُقد في تعريف العنقود سيؤدي إلى تغيير `shard_index`/`replica_index`، لذا انتبه.
## use\_concurrency\_control
يراعي التحكم في التزامن على مستوى الخادم (راجع إعدادات الخادم العامة `concurrent_threads_soft_limit_num` و `concurrent_threads_soft_limit_ratio_to_cores`). وإذا كان معطّلًا، فسيتيح استخدام عدد أكبر من الخيوط حتى إذا كان الخادم مثقَلًا بالأحمال (وهذا غير موصى به للاستخدام العادي، ويُحتاج إليه غالبًا في الاختبارات).
## use\_constant\_folding\_in\_index\_analysis
استبدِل الثوابت على مستوى التقسيم داخل شرط عامل التصفية عند تحليل المفتاح الأساسي وفهارس التخطي لكل جزء.
عندما يظهر مفتاح التقسيم في عامل التصفية مع أعمدة المفتاح الأساسي أو أعمدة فهرس التخطي، يتيح ذلك لتحليل الفهرس طيَّ قيمة التقسيم بشكل منفصل داخل كل جزء. ويكون هذا مفيدًا بشكل خاص مع عوامل التصفية الفصلية التي تستهدف تفرعاتها أقسامًا مختلفة. على سبيل المثال، مع `PARTITION BY a` و`ORDER BY b`:
```sql theme={null}
SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)
```
بالنسبة إلى الجزء ضمن الـ partition `a = 1`، يُبسَّط الشرط إلى `b >= 1`، بينما في الـ partitions `a = 2` و`a = 3` يُبسَّط إلى `b > 10`، لذا يُحلَّل كل جزء باستخدام عبارة الشرط التي تنطبق عليه فعليًا.
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
## use\_hash\_table\_stats\_for\_join\_reordering
تمكين استخدام إحصاءات جدول التجزئة المجمّعة لتقدير الكاردينالية أثناء إعادة ترتيب عمليات JOIN
## use\_hedged\_requests
يُفعّل منطق الطلبات التحوطية للاستعلامات البعيدة. ويتيح إنشاء عدة اتصالات مع replicas مختلفة للاستعلام.
يُنشأ اتصال جديد إذا تعذّر إنشاء الاتصال الحالي (أو الاتصالات الحالية) مع replica (أو replicas) خلال `hedged_connection_timeout`
أو إذا لم يتم تلقي أي بيانات خلال `receive_data_timeout`. يستخدم الاستعلام أول اتصال يرسل حزمة Progress غير فارغة (أو حزمة Data إذا كان `allow_changing_replica_until_first_data_packet` مفعّلًا)؛
وتُلغى الاتصالات الأخرى. الاستعلامات التي تستخدم `max_parallel_replicas > 1` مدعومة.
مفعّل افتراضيًا.
القيمة الافتراضية في Cloud: `0`.
## use\_hive\_partitioning
عند تمكين هذا الإعداد، سيكتشف ClickHouse التقسيم بنمط Hive في المسار (`/name=value/`) في محركات الجداول الشبيهة بالملفات [File](/docs/ar/reference/functions/table-functions/file#hive-style-partitioning)/[S3](/docs/ar/reference/functions/table-functions/s3#hive-style-partitioning)/[URL](/docs/ar/reference/functions/table-functions/url#hive-style-partitioning)/[HDFS](/docs/ar/reference/functions/table-functions/hdfs#hive-style-partitioning)/[AzureBlobStorage](/docs/ar/reference/functions/table-functions/azureBlobStorage#hive-style-partitioning)، وسيتيح استخدام أعمدة التقسيم كأعمدة افتراضية في الاستعلام. وستحمل هذه الأعمدة الافتراضية الأسماء نفسها الموجودة في المسار المُقسَّم، لكنها ستبدأ بالبادئة `_`.
## use\_join\_disjunctions\_push\_down
يمكّن من دفع الأجزاء الموصولة بـ OR من شروط JOIN إلى جهات الإدخال المقابلة ("دفع جزئي").
ويتيح ذلك لمحركات التخزين إجراء التصفية مبكرًا، مما قد يقلل من البيانات المقروءة.
لا يغيّر هذا التحسين الدلالة، ولا يُطبَّق إلا عندما يوفّر كل فرع OR من المستوى الأعلى شرطًا حتميًا واحدًا على الأقل
للجهة المستهدفة.
## use\_legacy\_to\_time
عند تمكين هذا الإعداد، يتيح استخدام الدالة القديمة `toTime`، التي تحوّل قيمة تاريخ ووقت إلى تاريخ ثابت معيّن مع الحفاظ على الوقت.
وبخلاف ذلك، تُستخدم دالة `toTime` الجديدة، التي تحوّل أنواعًا مختلفة من البيانات إلى النوع `Time`.
وتظل الدالة القديمة متاحة دائمًا أيضًا باسم `toTimeWithFixedDate`.
## use\_lightweight\_primary\_key\_index\_analysis
تحسين تحليل فهرس المفتاح الأساسي لجداول `MergeTree` ذات المفاتيح الأساسية الطويلة.
عند التمكين، يعتمد وقت تشغيل تحليل الفهرس أساسًا على مدى تعقيد شرط التصفية في الاستعلام (أي أعمدة المفتاح التي يستخدمها فعليًا)، لا على طول المفتاح الأساسي — لذا فإن توسيع مفتاح الفرز يضيف عبئًا إضافيًا ضئيلًا جدًا على تحليل الفهرس في الاستعلامات التي تُجري تصفية على عدد قليل فقط من أعمدته.
القيم الممكنة:
* 0 — معطّل. تُعالَج جميع أعمدة المفتاح الأساسي أثناء تحليل الفهرس.
* 1 — مُمكّن.
## use\_parquet\_metadata\_cache
عند تفعيل هذا الخيار، قد يستخدم تنسيق Parquet ذاكرة التخزين المؤقت لبيانات تعريف Parquet.
القيم الممكنة:
* 0 - معطّل
* 1 - مفعّل
## use\_primary\_key
استخدم المفتاح الأساسي لتقليم الحبيبات أثناء تنفيذ الاستعلام في جداول MergeTree.
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
## use\_reader\_executor
تجريبي. تُوجَّه عمليات القراءة عبر خط الأنابيب الجديد `ReaderExecutor` بدلًا من البنية المتداخلة القديمة لمخازن القراءة المؤقتة. ويعود إلى المسار القديم في التهيئات التي لا يزال المنفّذ لا يدعمها.
## use\_roaring\_bitmap\_iceberg\_positional\_deletes
استخدم roaring bitmap لعمليات الحذف الموضعي في Iceberg.
## use\_streaming\_marks\_compression
عند تحميل العلامات لأجزاء MergeTree، اضغطها إلى تمثيلها داخل الذاكرة كتلةً واحدة في كل مرة (streaming) بدلًا من إنشاء مصفوفة العلامات العادية الكاملة أولًا. يقلل هذا بشكل كبير من ذروة استخدام الذاكرة أثناء تحميل العلامات للأجزاء compact التي تحتوي على العديد من التدفقات الفرعية (مثل الجداول التي تحتوي على أعمدة JSON مع تفعيل write\_marks\_for\_substreams\_in\_compact\_parts).
## use\_strict\_insert\_block\_limits
عند تمكينه، يفرض هذا الإعداد بدقة كلاً من الحدين الأدنى والأقصى لحجم كتلة insert.
تُنشأ كتلة عندما:
* العتبات الدنيا (AND): يتم بلوغ كلٍّ من min\_insert\_block\_size\_rows و min\_insert\_block\_size\_bytes.
* العتبات القصوى (OR): يتم بلوغ أحد max\_insert\_block\_size\_rows أو max\_insert\_block\_size\_bytes.
عند تعطيله، تُنشأ كتلة عندما:
* العتبات الدنيا (OR): يتم بلوغ min\_insert\_block\_size\_rows أو min\_insert\_block\_size\_bytes.
**ملاحظة**: إذا كانت إعدادات الحد الأقصى أصغر من إعدادات الحد الأدنى، فستكون لحدود الحد الأقصى الأولوية، وستُنشأ الكتل قبل بلوغ العتبات الدنيا.
**ملاحظة**: يُعطَّل هذا الإعداد تلقائيًا لعمليات insert غير المتزامنة، لأن عمليات insert غير المتزامنة تُرفق رموز إزالة التكرار لكل إدخال، وهي غير متوافقة مع تقسيم الكتل المطلوب لفرض الحدود الصارمة.
معطّل افتراضيًا.
## use\_structure\_from\_insertion\_table\_in\_table\_functions
استخدم البنية من جدول الإدراج بدلًا من استدلال المخطط من البيانات. القيم الممكنة: 0 - معطّل، 1 - مُمكّن، 2 - تلقائي
## use\_uncompressed\_cache
ما إذا كان سيتم استخدام cache of uncompressed blocks. يقبل 0 أو 1. والقيمة الافتراضية هي 0 (معطّل).
يمكن أن يؤدي استخدام uncompressed cache (فقط للجداول في tables in the MergeTree family) إلى تقليل زمن الاستجابة بشكل كبير وزيادة معدل النقل عند العمل مع عدد كبير من الاستعلامات القصيرة. فعّل هذا الإعداد للمستخدمين الذين يرسلون طلبات قصيرة متكررة. وانتبه أيضًا إلى المعلَمة [uncompressed\_cache\_size](/docs/ar/reference/settings/server-settings/settings#uncompressed_cache_size) في configuration (يتم ضبطها فقط في config file) — وهي حجم uncompressed cache blocks. وتبلغ قيمتها الافتراضية 8 GiB. ويتم ملء uncompressed cache حسب الحاجة، كما تُحذف البيانات الأقل استخدامًا تلقائيًا.
بالنسبة إلى الاستعلامات التي تقرأ حجمًا كبيرًا نسبيًا من data (مليون row أو أكثر)، يُعطَّل uncompressed cache تلقائيًا لتوفير المساحة للاستعلامات الصغيرة فعلًا. وهذا يعني أنه يمكنك إبقاء الإعداد 'use\_uncompressed\_cache' مضبوطًا دائمًا على 1.
## use\_with\_fill\_by\_sorting\_prefix
الأعمدة التي تسبق أعمدة WITH FILL في عبارة ORDER BY تُكوِّن بادئة الفرز. وتُملأ الصفوف التي تختلف قيم بادئة الفرز فيها بشكل مستقل