> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> إعدادات MergeTree في `system.merge_tree_settings`
# إعدادات جداول MergeTree
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
const cells = [["النوع", {type}], ["القيمة الافتراضية", {default_value}]];
if (changeable_without_restart) {
const isYes = String(changeable_without_restart).trim().toLowerCase() === "yes";
const badge = isYes ? نعم : لا;
cells.push(["يمكن تغييره دون إعادة التشغيل", badge]);
}
return
{cells.map(([h]) => | {h} | )}
{cells.map(([h, v]) => | {v} | )}
;
};
export const galaxyOnClick = eventName => () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
export const ExperimentalBadge = () => {
return ;
};
يعرض جدول النظام `system.merge_tree_settings` إعدادات MergeTree المعيَّنة على المستوى العام.
يمكن تعيين إعدادات MergeTree في قسم `merge_tree` ضمن ملف إعدادات الخادم، أو تحديدها لكل جدول `MergeTree` على حدة في
عبارة `SETTINGS` ضمن تعليمة `CREATE TABLE`.
مثال على تخصيص الإعداد `max_suspicious_broken_parts`:
اضبط القيمة الافتراضية لجميع جداول `MergeTree` في ملف إعدادات الخادم:
```text theme={null}
5
```
اضبطه لجدول معيّن:
```sql theme={null}
CREATE TABLE tab
(
`A` Int64
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS max_suspicious_broken_parts = 500;
```
عدّل إعدادات جدول معيّن باستخدام `ALTER TABLE ... MODIFY SETTING`:
```sql theme={null}
ALTER TABLE tab MODIFY SETTING max_suspicious_broken_parts = 100;
-- reset to global default (value from system.merge_tree_settings)
ALTER TABLE tab RESET SETTING max_suspicious_broken_parts;
```
## إعدادات MergeTree
## adaptive\_write\_buffer\_initial\_size
الحجم الأولي لمخزن كتابة مؤقت تكيّفي
## add\_implicit\_sign\_column\_constraint\_for\_collapsing\_engine
إذا كانت القيمة `true`، فسيُضاف قيد ضمني على العمود `sign` في جدول CollapsingMergeTree
أو VersionedCollapsingMergeTree بحيث لا يُسمح إلا بالقيم الصالحة (`1` و `-1`).
## add\_minmax\_index\_for\_block\_number\_column
عند تفعيله، يُضاف فهرس min-max ضمني (للتخطي) للعمود الافتراضي الدائم `_block_number`.
يتطلب ذلك ضبط `enable_block_number_column = 1` حتى يسري مفعوله. لا يُبنى الفهرس إلا أثناء عمليات الدمج،
وليس أثناء عمليات الإدراج: ففي وقت الإدراج يكون رقم block مؤقتًا، ما يعني فهرسة قيمة ثابتة.
## add\_minmax\_index\_for\_block\_offset\_column
عند التفعيل، يُضاف فهرس min-max ضمني من نوع (skipping) للعمود الافتراضي المستمر `_block_offset`.
يتطلب هذا الإعداد `enable_block_offset_column = 1` لكي يسري مفعوله. لا يُنشأ الفهرس إلا أثناء عمليات الدمج،
وليس أثناء عمليات الإدراج.
## add\_minmax\_index\_for\_numeric\_columns
عند التفعيل، تُضاف فهارس الحد الأدنى والحد الأقصى (التخطي) إلى جميع الأعمدة الرقمية
في الجدول.
## add\_minmax\_index\_for\_string\_columns
عند تمكينه، تُضاف فهارس min-max (skipping) إلى جميع الأعمدة النصية في الجدول.
## add\_minmax\_index\_for\_temporal\_columns
عند تفعيل هذا الخيار، تُضاف فهارس min-max (skipping) إلى جميع أعمدة Date وDate32 وTime وTime64 وDateTime وDateTime64 في الجدول
## allow\_coalescing\_columns\_in\_partition\_or\_order\_key
عند تمكينه، يتيح استخدام أعمدة الدمج في جدول CoalescingMergeTree ضمن مفتاح التقسيم أو مفتاح الترتيب.
## allow\_commit\_order\_projection
يُمكّن الإسقاطات المعتمدة على ترتيب الالتزام التي تخزّن العمودين الافتراضيين `_block_number` و`_block_offset`، مع الحفاظ على ترتيب الإدراج الأصلي عبر عمليات الدمج.
ويتطلب أن يكون كلٌّ من `enable_block_number_column` و`enable_block_offset_column` مُمكّنًا.
## allow\_experimental\_replacing\_merge\_with\_cleanup
يسمح بعمليات الدمج التجريبية من نوع CLEANUP لمحرك ReplacingMergeTree مع العمود `is_deleted`.
وعند تمكينه، يتيح استخدام `OPTIMIZE ... FINAL CLEANUP` يدويًا
لدمج جميع الأجزاء في partition في جزء واحد وإزالة أي
صفوف محذوفة.
كما يتيح تمكين حدوث عمليات الدمج هذه تلقائيًا في الخلفية
باستخدام الإعدادات `min_age_to_force_merge_seconds`،
`min_age_to_force_merge_on_partition_only` و
`enable_replacing_merge_with_cleanup_for_min_age_to_force_merge`.
## allow\_experimental\_reverse\_key
إعداد متقادم، ولا تأثير له.
## allow\_floating\_point\_partition\_key
يتيح السماح باستخدام عدد ذي فاصلة عائمة كمفتاح التقسيم.
القيم الممكنة:
* `0` — مفتاح التقسيم ذي الفاصلة العائمة غير مسموح به.
* `1` — مفتاح التقسيم ذي الفاصلة العائمة مسموح به.
## allow\_nullable\_key
إتاحة استخدام أنواع Nullable كمفاتيح أساسية.
## allow\_part\_offset\_column\_in\_projections
السماح باستخدام العمود '\_part\_offset' في استعلام SELECT الخاص بالإسقاطات.
## allow\_reduce\_blocking\_parts\_task
مهمة تعمل في الخلفية لتقليل الأجزاء المعيقة في جداول shared merge tree.
متاح فقط في ClickHouse Cloud
## allow\_remote\_fs\_zero\_copy\_replication
لا تستخدم هذا الإعداد في بيئة الإنتاج، لأنه غير جاهز بعد.
## allow\_summing\_columns\_in\_partition\_or\_order\_key
عند التمكين، يسمح باستخدام الأعمدة التي تُجمَّع في جدول SummingMergeTree ضمن
مفتاح التقسيم أو مفتاح الترتيب.
## allow\_suspicious\_indices
يرفض الفهارس الأساسية/الثانوية ومفاتيح الترتيب ذات التعبيرات المتطابقة
## allow\_tuple\_element\_aggregation
عند التمكين، تشارك العناصر الفردية داخل أعمدة Tuple في
التجميع أثناء الدمج في SummingMergeTree وAggregatingMergeTree و
CoalescingMergeTree. وتُوسَّع Tuples المتداخلة بشكل تكراري بحيث تُجمَّع جميع
العناصر الطرفية بشكل مستقل. هذا الإعداد ثابت
ويجب تحديده عند إنشاء الجدول.
## allow\_vertical\_merges\_from\_compact\_to\_wide\_parts
يسمح بعمليات الدمج العمودي من الأجزاء بتنسيق compact إلى الأجزاء بتنسيق wide. يجب أن تكون قيمة هذا الإعداد
متماثلة على جميع النسخ المتماثلة.
## alter\_column\_secondary\_index\_mode
يضبط ما إذا كان يجب السماح بأوامر `ALTER` التي تعدّل الأعمدة المشمولة بفهارس ثانوية، وما الإجراء الذي يجب اتخاذه إذا
كان يُسمح بها. افتراضيًا، يُسمح بأوامر `ALTER` هذه وتُعاد بناء الفهارس.
القيم الممكنة:
* `rebuild` (الافتراضي): يعيد بناء أي فهارس ثانوية تتأثر بالعمود في أمر `ALTER`.
* `throw`: يمنع أي `ALTER` على الأعمدة المشمولة بفهارس ثانوية **صريحة** من خلال إطلاق استثناء. ولا يشمل هذا القيد الفهارس الضمنية، إذ ستُعاد بناؤها.
* `drop`: يحذف الفهارس الثانوية التابعة. ولن تحتوي الأجزاء الجديدة على هذه الفهارس، ما يتطلب `MATERIALIZE INDEX` لإعادة إنشائها.
* `compatibility`: يطابق السلوك الأصلي: `throw` عند `ALTER ... MODIFY COLUMN` و`rebuild` عند `ALTER ... UPDATE/DELETE`.
* `ignore`: مخصص لاستخدام الخبراء. يترك الفهارس في حالة غير متسقة، ما قد يؤدي إلى نتائج استعلام غير صحيحة.
## always\_fetch\_merged\_part
إذا كانت القيمة `true`، فلن تُجري هذه النسخة المتماثلة أي عمليات دمج للأجزاء، وستجلب دائمًا الأجزاء المدمجة
من النسخ المتماثلة الأخرى.
القيم الممكنة:
* true, false
## always\_use\_copy\_instead\_of\_hardlinks
انسخ البيانات دائمًا بدلًا من استخدام الروابط الصلبة أثناء عمليات mutation وreplace وdetach
وما إلى ذلك.
## apply\_patches\_on\_merge
إذا كانت القيمة true، فسيتم تطبيق أجزاء التصحيح أثناء عمليات الدمج
## assign\_part\_uuids
عند تفعيله، سيُخصَّص معرّف فريد لكل جزء جديد.
قبل تفعيله، تحقّق من أن جميع النسخ المتماثلة تدعم UUID الإصدار 4.
## async\_block\_ids\_cache\_update\_wait\_ms
المدة التي ينتظرها كل تكرار من عملية الإدراج لتحديث async\_block\_ids\_cache
## async\_insert
إذا كانت القيمة true، فتُخزَّن بيانات استعلام INSERT في قائمة انتظار، ثم تُفرَّغ لاحقًا إلى
الجدول في الخلفية.
## auto\_statistics\_types
قائمة مفصولة بفواصل لأنواع الإحصاءات التي تُحتسب تلقائيًا لجميع الأعمدة المناسبة.
أنواع الإحصاءات المدعومة: basic, tdigest, countmin, minmax, uniq.
## background\_task\_preferred\_step\_execution\_time\_ms
الوقت المستهدف لتنفيذ خطوة واحدة من عمليات الدمج أو التعديل. وقد يتم تجاوزه إذا
استغرقت إحدى الخطوات وقتًا أطول
## cache\_populated\_by\_fetch
ينطبق هذا الإعداد فقط على ClickHouse Cloud.
عندما يكون `cache_populated_by_fetch` معطّلًا (وهو الإعداد الافتراضي)، لا تُحمَّل أجزاء البيانات
الجديدة إلى cache نظام الملفات إلا عند تشغيل query يتطلب تلك الأجزاء.
إذا كان مفعّلًا، فإن `cache_populated_by_fetch` سيؤدي بدلًا من ذلك إلى قيام جميع العقد بتحميل
أجزاء البيانات الجديدة من التخزين إلى cache نظام الملفات الخاصة بها، من دون الحاجة إلى query
ليؤدي إلى هذا الإجراء.
**راجع أيضًا**
* [ignore\_cold\_parts\_seconds](/ar/reference/settings/session-settings#ignore_cold_parts_seconds)
* [prefer\_warmed\_unmerged\_parts\_seconds](/ar/reference/settings/session-settings#prefer_warmed_unmerged_parts_seconds)
* [cache\_warmer\_threads](/ar/reference/settings/session-settings#cache_warmer_threads)
## cache\_populated\_by\_fetch\_filename\_regexp
ينطبق هذا الإعداد فقط على ClickHouse Cloud.
إذا لم تكن القيمة فارغة، فسيُحمَّل مسبقًا إلى ذاكرة التخزين المؤقت بعد الجلب فقط الملفات التي تطابق هذا التعبير النمطي (إذا كان `cache_populated_by_fetch` مُمكّنًا).
## check\_delay\_period
إعداد متقادم، ولا تأثير له.
## check\_sample\_column\_is\_correct
يُفعِّل هذا الفحص عند إنشاء الجدول للتأكد من صحة نوع بيانات العمود المستخدم في أخذ
العينات أو تعبير أخذ العينات. يجب أن يكون نوع البيانات أحد [أنواع الأعداد الصحيحة](/ar/reference/data-types/int-uint) غير الموقَّعة التالية: `UInt8`, `UInt16`,
`UInt32`, `UInt64`.
القيم الممكنة:
* `true` — الفحص مفعَّل.
* `false` — الفحص معطَّل عند إنشاء الجدول.
القيمة الافتراضية: `true`.
يتحقق ClickHouse server افتراضيًا عند إنشاء الجدول من نوع بيانات العمود
المستخدم في أخذ العينات أو تعبير أخذ العينات. إذا كانت لديك بالفعل جداول تحتوي على
تعبير أخذ عينات غير صحيح ولا تريد أن يُثير الخادم استثناءً
أثناء بدء التشغيل، فاضبط `check_sample_column_is_correct` على `false`.
## clean\_deleted\_rows
متقادم، لا تأثير له.
## cleanup\_delay\_period
الحد الأدنى للفترة اللازمة لتنظيف سجلات queue القديمة، وقيم hash الخاصة بـ blocks، وparts.
## cleanup\_delay\_period\_random\_add
أضِف قيمة موزعة توزيعًا منتظمًا من 0 إلى x ثانية إلى cleanup\_delay\_period
لتجنب ظاهرة الاندفاع الجماعي وما قد ينتج عنها من هجوم حجب الخدمة على ZooKeeper في حال
وجود عدد كبير جدًا من الجداول.
## cleanup\_thread\_preferred\_points\_per\_iteration
حجم الدفعة المفضّل لعمليات التنظيف في الخلفية (النقاط هنا قيمة مجرّدة، لكن نقطة واحدة
تعادل تقريبًا كتلة واحدة مُدخلة).
## cleanup\_threads
إعداد متقادم، بلا أي تأثير.
## clone\_replica\_zookeeper\_create\_get\_part\_batch\_size
حجم الدفعة لطلبات get-part متعددة الإنشاء في ZooKeeper عند استنساخ النسخة المتماثلة.
## columns\_and\_secondary\_indices\_sizes\_lazy\_calculation
احسب أحجام الأعمدة والفهارس الثانوية عند الطلب الأول بدلًا
من حسابها عند تهيئة الجدول.
## columns\_to\_prewarm\_mark\_cache
قائمة الأعمدة المطلوب إجراء تسخين مسبق لذاكرة التخزين المؤقت للعلامات لها (إذا كانت مفعّلة). تشير القيمة الفارغة إلى جميع الأعمدة
## compact\_parts\_max\_bytes\_to\_buffer
متاح فقط في ClickHouse Cloud. الحد الأقصى لعدد البايتات التي يمكن كتابتها في
stripe واحد داخل compact parts
## compact\_parts\_max\_granules\_to\_buffer
متاح فقط في ClickHouse Cloud. الحد الأقصى لعدد granules التي يمكن كتابتها في
stripe واحد داخل compact parts
## compact\_parts\_merge\_max\_bytes\_to\_prefetch\_part
متاح فقط في ClickHouse Cloud. الحد الأقصى لحجم compact part لقراءته بالكامل في الذاكرة أثناء الدمج.
## compatibility\_allow\_sampling\_expression\_not\_in\_primary\_key
يسمح بإنشاء جدول يكون فيه تعبير أخذ العينات غير موجود في المفتاح الأساسي. وهذا
مطلوب فقط للسماح مؤقتًا بتشغيل الخادم باستخدام جداول غير صحيحة من أجل
التوافق مع الإصدارات السابقة.
## compress\_marks
تدعم العلامات الضغط، ما يقلّل حجم ملف العلامات ويُسرّع نقلها عبر الشبكة.
## compress\_per\_column\_in\_compact\_parts
يتحكم هذا الإعداد في التخطيط المادي للأجزاء المدمجة. إذا كانت القيمة true (وهو الإعداد الافتراضي)، فسيبدأ كل عمود داخل granule كتلةً مضغوطة جديدة، مما يتيح لـ ClickHouse تخطي قراءة الأعمدة غير الضرورية من القرص. وإذا كانت القيمة false، فستُحزَم جميع الأعمدة داخل granule في الكتلة المضغوطة نفسها، مما يحسّن نسبة الضغط، لكنه يتطلب فك ضغط قدر أكبر من البيانات أثناء القراءة. ويكون هذا مفيدًا لأحمال العمل التي تقرأ جميع الأعمدة دائمًا (مثل projections).
## compress\_primary\_key
يدعم ضغط المفتاح الأساسي، مما يقلّل حجم ملف المفتاح الأساسي ويُسرّع
نقل البيانات عبر الشبكة.
## concurrent\_part\_removal\_threshold
فعِّل إزالة الأجزاء بالتزامن (راجع `max_part_removal_threads`) فقط إذا
كان عدد أجزاء البيانات غير النشطة لا يقل عن هذه القيمة.
## concurrent\_part\_removal\_threshold\_for\_remote\_disk
مثل `concurrent_part_removal_threshold`، لكنه يُستخدم عندما يكون جزء واحد
على الأقل من الأجزاء المُزالة مخزّنًا على قرص بعيد. وتكون القيمة
الافتراضية أقل لأن إزالة كل جزء من التخزين البعيد تتطلب عادةً رحلة
ذهاب وإياب عبر الشبكة (على سبيل المثال، طلب `DELETE` واحد عبر HTTP
لكل جزء في تخزين الكائنات)، لذلك فإن الإزالة التسلسلية حتى لـ 100 جزء
قد تؤخر `DROP TABLE` لعشرات الثواني.
## deduplicate\_merge\_projection\_mode
ما إذا كان ينبغي السماح بإنشاء إسقاط لجدول يستخدم MergeTree غير كلاسيكي،
أي ليس من النوعين MergeTree (Replicated, Shared). خيار `ignore` مخصص فقط
للتوافق، وقد يؤدي إلى نتائج غير صحيحة. بخلاف ذلك، إذا كان ذلك مسموحًا،
فما الإجراء الذي يجب اتخاذه عند دمج الإسقاطات: إما حذفها أو إعادة بنائها. لذلك فإن
MergeTree الكلاسيكي سيتجاهل هذا الإعداد. كما أنه يتحكم أيضًا في `OPTIMIZE DEDUPLICATE`،
لكن تأثيره يشمل جميع أفراد عائلة MergeTree. وهو أيضًا، على غرار
الخيار `lightweight_mutation_projection_mode`، يعمل على مستوى الجزء.
القيم الممكنة:
* `ignore`
* `throw`
* `drop`
* `rebuild`
## default\_compression\_codec
يحدّد برنامج ترميز الضغط الافتراضي الذي سيُستخدم إذا لم يكن محددًا لعمود معيّن في تعريف الجدول.
ترتيب اختيار برنامج ترميز الضغط لعمود ما:
1. برنامج ترميز الضغط المعرّف للعمود في تعريف الجدول
2. برنامج ترميز الضغط المعرّف في `default_compression_codec` (هذا الإعداد)
3. برنامج ترميز الضغط الافتراضي المعرّف في إعدادات `compression`
القيمة الافتراضية: سلسلة فارغة (غير معرّفة).
## detach\_not\_byte\_identical\_parts
يؤدي هذا الإعداد إلى تمكين أو تعطيل فصل data part على نسخة متماثلة بعد عملية merge أو
mutation إذا لم يكن مطابقًا بايتًا ببايت لأجزاء البيانات الموجودة على النسخ المتماثلة الأخرى. وإذا
كان معطّلًا، فستتم إزالة data part. فعّل هذا الإعداد إذا كنت تريد
تحليل هذه الأجزاء لاحقًا.
ينطبق هذا الإعداد على جداول `MergeTree` التي تكون فيها
[data replication](/ar/reference/engines/table-engines/mergetree-family/replacingmergetree) مفعّلة.
القيم الممكنة:
* `0` — تُزال الأجزاء.
* `1` — تُفصل الأجزاء.
## detach\_old\_local\_parts\_when\_cloning\_replica
لا تُزِل الأجزاء المحلية القديمة عند إصلاح نسخة متماثلة مفقودة.
القيم الممكنة:
* `true`
* `false`
## disable\_detach\_partition\_for\_zero\_copy\_replication
يُعطِّل استعلام DETACH PARTITION في نسخ متماثل دون نسخ.
## disable\_fetch\_partition\_for\_zero\_copy\_replication
تعطيل استعلام FETCH PARTITION في نسخ متماثل دون نسخ.
## disable\_freeze\_partition\_for\_zero\_copy\_replication
تعطيل استعلام FREEZE PARTITION عند استخدام نسخ متماثل دون نسخ.
## القرص
اسم قرص التخزين. يمكن تحديده عوضًا عن سياسة التخزين.
## distributed\_index\_analysis\_min\_indexes\_bytes\_to\_activate
الحد الأدنى لأحجام الفهارس على القرص (لفهارس تخطّي البيانات والمفتاح الأساسي، ومن دون ضغط) لتفعيل تحليل الفهرس الموزّع
## distributed\_index\_analysis\_min\_parts\_to\_activate
الحد الأدنى لعدد الأجزاء اللازمة لتفعيل تحليل الفهارس الموزّع
## dynamic\_serialization\_version
إصدار التسلسل لنوع البيانات Dynamic. مطلوب للتوافق.
القيم الممكنة:
* `v1`
* `v2`
* `v3`
## enable\_block\_number\_column
تمكين الاحتفاظ بالعمود \_block\_number لكل صف.
## enable\_block\_offset\_column
يحتفظ بالعمود الافتراضي `_block_offset` أثناء عمليات الدمج.
## enable\_index\_granularity\_compression
اضغط قيم دقة الفهرسة في الذاكرة إن أمكن ذلك
## enable\_max\_bytes\_limit\_for\_min\_age\_to\_force\_merge
ما إذا كان ينبغي أن يراعي الإعدادان `min_age_to_force_merge_seconds` و
`min_age_to_force_merge_on_partition_only` الإعداد
`max_bytes_to_merge_at_max_space_in_pool`.
القيم الممكنة:
* `true`
* `false`
## enable\_mixed\_granularity\_parts
يُفعِّل أو يعطِّل التحوّل إلى التحكم في حجم الـ granule باستخدام
الإعداد `index_granularity_bytes`. قبل الإصدار 19.11، كان الإعداد
`index_granularity` هو الوحيد المستخدم لتقييد حجم الـ granule. يُحسِّن
الإعداد `index_granularity_bytes` أداء ClickHouse عند
قراءة البيانات من الجداول التي تحتوي على صفوف كبيرة (بعشرات أو مئات الميغابايت).
إذا كانت لديك جداول تحتوي على صفوف كبيرة، فيمكنك تفعيل هذا الإعداد لهذه الجداول
لتحسين كفاءة استعلامات `SELECT`.
## enable\_replacing\_merge\_with\_cleanup\_for\_min\_age\_to\_force\_merge
ما إذا كان سيتم استخدام عمليات دمج `CLEANUP` لـ ReplacingMergeTree عند دمج
الأقسام حتى تصبح جزءًا واحدًا. يتطلب ذلك تفعيل `allow_experimental_replacing_merge_with_cleanup`
و`min_age_to_force_merge_seconds` و`min_age_to_force_merge_on_partition_only`.
القيم الممكنة:
* `true`
* `false`
## enable\_the\_endpoint\_id\_with\_zookeeper\_name\_prefix
تمكين معرّف نقطة النهاية باستخدام بادئة اسم ZooKeeper لجدول ReplicatedMergeTree.
## enable\_vertical\_merge\_algorithm
تمكين استخدام خوارزمية الدمج العمودي.
## enforce\_index\_structure\_match\_on\_partition\_manipulation
إذا كان هذا الإعداد مُمكّنًا لجدول الوجهة في استعلام لمعالجة التقسيم
(`ATTACH/MOVE/REPLACE PARTITION`)، فيجب أن تكون الفهارس والإسقاطات
متطابقة بين جدولي المصدر والوجهة. وإلا، يمكن أن يحتوي جدول الوجهة
على مجموعة شاملة لفهارس جدول المصدر وإسقاطاته.
## escape\_index\_filenames
قبل الإصدار 26.1، لم نكن نجري إفلاتًا للرموز الخاصة في أسماء الملفات المُنشأة للفهارس الثانوية، مما قد يؤدي إلى مشكلات
إذ قد تتسبب بعض المحارف في أسماء الفهارس في إنشاء أجزاء تالفة. أُضيف هذا فقط لأسباب تتعلق بالتوافق. ولا ينبغي تغييره إلا إذا كنت
تقرأ أجزاء قديمة تحتوي على فهارس تستخدم محارف غير ASCII في أسمائها.
## escape\_variant\_subcolumn\_filenames
إفلات الرموز الخاصة في أسماء الملفات المُنشأة للأعمدة الفرعية من نوع البيانات Variant في الأجزاء العريضة لجدول MergeTree. ضروري للتوافق.
## exclude\_deleted\_rows\_for\_part\_size\_in\_merge
إذا كان هذا الإعداد مُمكّنًا، فسيُستخدم الحجم الفعلي التقديري لأجزاء البيانات (أي باستبعاد الصفوف
التي حُذفت باستخدام `DELETE FROM`) عند اختيار
الأجزاء المطلوب دمجها. لاحظ أن هذا السلوك لا يُفعَّل إلا لأجزاء البيانات
المتأثرة بعملية `DELETE FROM` نُفِّذت بعد تمكين هذا الإعداد.
القيم الممكنة:
* `true`
* `false`
**انظر أيضًا**
* [load\_existing\_rows\_count\_for\_old\_parts](#load_existing_rows_count_for_old_parts)
الإعداد
## exclude\_materialize\_skip\_indexes\_on\_merge
يستبعد قائمة فهارس التخطي المحددة والمفصولة بفواصل من الإنشاء والتخزين أثناء عمليات الدمج. ولا يكون له أي تأثير إذا كانت
[materialize\_skip\_indexes\_on\_merge](#materialize_skip_indexes_on_merge) بقيمة false.
ستظل فهارس التخطي المستثناة تُنشأ وتُخزَّن من خلال استعلام
[MATERIALIZE INDEX](/ar/reference/statements/alter/skipping-index#materialize-index) صريح أو أثناء عمليات INSERT، وذلك وفقًا
لإعداد [materialize\_skip\_indexes\_on\_insert](/ar/reference/settings/session-settings#materialize_skip_indexes_on_insert)
للجلسة.
مثال:
```sql theme={null}
CREATE TABLE tab
(
a UInt64,
b UInt64,
INDEX idx_a a TYPE minmax,
INDEX idx_b b TYPE set(3)
)
ENGINE = MergeTree ORDER BY tuple() SETTINGS exclude_materialize_skip_indexes_on_merge = 'idx_a';
INSERT INTO tab SELECT number, number / 50 FROM numbers(100); -- setting has no effect on INSERTs
-- idx_a will be excluded from update during background or explicit merge via OPTIMIZE TABLE FINAL
-- can exclude multiple indexes by providing a list
ALTER TABLE tab MODIFY SETTING exclude_materialize_skip_indexes_on_merge = 'idx_a, idx_b';
-- default setting, no indexes excluded from being updated during merge
ALTER TABLE tab MODIFY SETTING exclude_materialize_skip_indexes_on_merge = '';
```
## execute\_merges\_on\_single\_replica\_time\_threshold
عندما تكون قيمة هذا الإعداد أكبر من صفر، تبدأ نسخة متماثلة واحدة فقط
عملية الدمج فورًا، بينما تنتظر النسخ المتماثلة الأخرى حتى انقضاء تلك المدة
لتنزيل النتيجة بدلًا من تنفيذ عمليات الدمج محليًا. وإذا لم تُنهِ النسخة المتماثلة
المختارة عملية الدمج خلال تلك المدة، فسيجري الرجوع إلى السلوك القياسي.
القيم الممكنة:
* أي عدد صحيح موجب.
## fault\_probability\_after\_part\_commit
مخصّص للاختبار. لا تغيّره.
## fault\_probability\_before\_part\_commit
للاختبار. لا تغيّره.
## finished\_mutations\_to\_keep
عدد السجلات الخاصة بعمليات mutation المكتملة المطلوب الاحتفاظ بها. إذا كانت القيمة صفرًا، فسيتم الاحتفاظ
بها كلها.
## force\_read\_through\_cache\_for\_merges
فرض القراءة من خلال ذاكرة التخزين المؤقت لنظام الملفات أثناء عمليات الدمج
## fsync\_after\_insert
نفّذ `fsync` لكل جزء يتم إدراجه. يؤدي ذلك إلى انخفاض كبير في أداء
عمليات الإدراج، ولا يُنصح باستخدامه مع الأجزاء الواسعة.
## fsync\_part\_directory
نفّذ fsync على دليل الجزء بعد اكتمال جميع عمليات الجزء (الكتابة، وإعادة التسمية، وما إلى ذلك).
## in\_memory\_parts\_enable\_wal
إعداد متقادم، ولا تأثير له.
## in\_memory\_parts\_insert\_sync
إعداد متقادم، وليس له أي تأثير.
## inactive\_parts\_to\_delay\_insert
إذا تجاوز عدد الأجزاء غير النشطة في قسم واحد من الجدول
قيمة `inactive_parts_to_delay_insert`، يتم إبطاء
عملية `INSERT` عمدًا.
يفيد ذلك عندما يعجز الخادم عن تنظيف الأجزاء بالسرعة الكافية.
القيم الممكنة:
* أي عدد صحيح موجب.
## inactive\_parts\_to\_throw\_insert
إذا تجاوز عدد الأجزاء غير النشطة في قسم واحد قيمة
`inactive_parts_to_throw_insert`، تتم مقاطعة `INSERT` مع
الخطأ التالي:
> "عدد الأجزاء غير النشطة كبير جدًا (N). تتم معالجة تنظيف الأجزاء بمعدل أبطأ بكثير من عمليات الإدراج" استثناء."
القيم الممكنة:
* أي عدد صحيح موجب.
## index\_granularity
الحد الأقصى لعدد صفوف البيانات بين علامات الفهرس. أي: عدد الصفوف
المقابل لقيمة واحدة من المفتاح الأساسي.
## index\_granularity\_bytes
الحد الأقصى لحجم حبيبات البيانات، بالبايت.
لقصر حجم الحبيبة على عدد الصفوف فقط، اضبطه على `0` (غير مستحسن).
## initialization\_retry\_period
فترة إعادة المحاولة لتهيئة الجدول، بالثواني.
## kill\_delay\_period
إعداد متقادم، وليس له أي تأثير.
## kill\_delay\_period\_random\_add
إعداد متقادم، بلا تأثير.
## kill\_threads
إعداد متقادم، وليس له أي تأثير.
## lightweight\_mutation\_projection\_mode
افتراضيًا، لا تعمل ميزة الحذف خفيف الوزن `DELETE` مع الجداول التي تحتوي على
إسقاطات. ويرجع ذلك إلى أن الصفوف في الإسقاط قد تتأثر بعملية
`DELETE`. لذلك، تكون القيمة الافتراضية هي `throw`. ومع ذلك، يمكن لهذا
الخيار تغيير هذا السلوك. عند استخدام القيمة `drop` أو `rebuild`،
سيعمل الحذف مع الإسقاطات. تؤدي القيمة `drop` إلى حذف الإسقاط، لذا
قد يكون ذلك سريعًا في الاستعلام الحالي لأن الإسقاط سيُحذف، لكنه قد يكون
أبطأ في الاستعلامات المستقبلية لعدم وجود إسقاط مرفق. أما `rebuild` فيؤدي إلى
إعادة بناء الإسقاط، ما قد يؤثر في أداء الاستعلام الحالي، لكنه
قد يسرّع الاستعلامات المستقبلية. ومن الميزات الجيدة أن هذه الخيارات
لا تعمل إلا على مستوى الجزء، ما يعني أن الإسقاطات الموجودة في الجزء الذي لا
يجري المساس به ستبقى سليمة بدلًا من أن تؤدي إلى تشغيل أي إجراء مثل
drop أو rebuild.
القيم الممكنة:
* `throw`
* `drop`
* `rebuild`
## load\_existing\_rows\_count\_for\_old\_parts
إذا كان هذا الإعداد ممكّنًا مع [exclude\_deleted\_rows\_for\_part\_size\_in\_merge](#exclude_deleted_rows_for_part_size_in_merge)،
فسيُحتسب عدد الصفوف المحذوفة لأجزاء البيانات الموجودة عند
بدء تشغيل الجدول. لاحظ أن ذلك قد يبطّئ تحميل الجدول عند بدء التشغيل.
القيم الممكنة:
* `true`
* `false`
**راجع أيضًا**
* الإعداد [exclude\_deleted\_rows\_for\_part\_size\_in\_merge](#exclude_deleted_rows_for_part_size_in_merge)
## lock\_acquire\_timeout\_for\_background\_operations
لعمليات الخلفية مثل عمليات الدمج والتعديلات وغيرها: عدد الثواني التي يُنتظرها قبل الإخفاق في الحصول على أقفال الجدول.
## map\_buckets\_coefficient
المعامل المستخدم في [map\_buckets\_strategy](#map_buckets_strategy) بالاستراتيجيتين `sqrt` و`linear` لحساب عدد الحاويات استنادًا إلى متوسط حجم الخريطة.
بالنسبة إلى استراتيجية `sqrt`: `round(map_buckets_coefficient * sqrt(avg_map_size))`.
بالنسبة إلى استراتيجية `linear`: `round(map_buckets_coefficient * avg_map_size)`.
يُتجاهل هذا الإعداد عندما تكون قيمة `map_buckets_strategy` هي `constant`.
## map\_buckets\_min\_avg\_size
الحد الأدنى لمتوسط حجم Map (عدد المفاتيح لكل صف) اللازم لتطبيق تسلسل `with_buckets`.
إذا كان متوسط حجم Map أقل من هذه القيمة، فسيُستخدم حاوية واحد بصرف النظر عن إعدادات الحاوية الأخرى.
تؤدي القيمة `0` إلى تعطيل العتبة وتطبيق استراتيجية التقسيم إلى حاوية دائمًا.
يفيد هذا الإعداد في تجنب الحمل الإضافي الناتج عن التسلسل المعتمد على الحاوية مع قيم Map الصغيرة، حيث تكون الفائدة محدودة.
## map\_buckets\_strategy
يتحكم هذا الإعداد في استراتيجية اختيار عدد الحاويات في تسلسل `with_buckets` لـ `Map` استنادًا إلى متوسط حجم الخريطة.
القيم الممكنة:
* constant — استخدم دائمًا [max\_buckets\_in\_map](#max_buckets_in_map) كعددٍ للحاويات، بغض النظر عن متوسط حجم الخريطة.
* sqrt — استخدم `round(map_buckets_coefficient * sqrt(avg_map_size))` كعددٍ للحاويات، مع حصره ضمن `[1, max_buckets_in_map]`.
* linear — استخدم `round(map_buckets_coefficient * avg_map_size)` كعددٍ للحاويات، مع حصره ضمن `[1, max_buckets_in_map]`.
## map\_serialization\_version
يتحكم في أسلوب التسلسل المستخدم لأعمدة `Map`.
القيم المحتملة:
* basic — يستخدم التسلسل القياسي لـ `Map`.
* with\_buckets — يقسّم المفاتيح إلى حاوية أثناء التسلسل. ويؤدي استخدام حاوية إلى تحسين قراءة المفاتيح الفردية من `Map`.
يُحدَّد عدد حاوية في تسلسل `with_buckets` بواسطة [max\_buckets\_in\_map](#max_buckets_in_map) و [map\_buckets\_strategy](#map_buckets_strategy).
## map\_serialization\_version\_for\_zero\_level\_parts
يتيح هذا الإعداد تحديد إصدار مختلف من التسلسل لأعمدة
`Map` في الأجزاء ذات المستوى الصفري التي يتم إنشاؤها أثناء عمليات insert.
وقد يكون من المفيد الإبقاء على تسلسل `basic` للأجزاء ذات المستوى الصفري لتجنب
تدهور الأداء أثناء عمليات insert، مع استخدام `with_buckets` للأجزاء المدمجة.
## marks\_compress\_block\_size
حجم كتلة ضغط العلامات، أي الحجم الفعلي للكتلة التي ستُضغط.
## marks\_compression\_codec
ترميز الضغط المستخدم للعلامات؛ وبما أن العلامات صغيرة بما يكفي وتُخزَّن مؤقتًا، فإن الضغط الافتراضي هو ZSTD(3).
## materialize\_projections\_on\_insert
عند تفعيل هذا الإعداد، تُنشئ عمليات INSERT أجزاءً جديدة تتضمن الإسقاطات.
وإلا، يمكن إنشاؤها صراحةً عبر [MATERIALIZE PROJECTION](/ar/reference/statements/alter/projection#materialize-projection)
أو أثناء عمليات الدمج باستخدام [materialize\_projections\_on\_merge](/ar/reference/settings/merge-tree-settings#materialize_projections_on_merge).
## materialize\_projections\_on\_merge
عند تمكين هذا الإعداد، تعيد عملية الدمج إنشاء الإسقاط إذا كان مفقودًا من جميع أجزائه المصدرية (على سبيل المثال، لأنها أُدرجت باستخدام `materialize_projections_on_insert = 0`)، بحيث يحتوي الجزء الناتج عن الدمج على هذا الإسقاط.
تظل عمليات الدمج تقتصر على دمج الأجزاء التي تشترك في المجموعة نفسها من الإسقاطات. ولاستكمال إسقاط في جميع الأجزاء الموجودة،
استخدم [MATERIALIZE PROJECTION](/ar/reference/statements/alter/projection#materialize-projection) بشكل صريح. كما تُنشأ الإسقاطات أيضًا
أثناء عمليات INSERT باستخدام [materialize\_projections\_on\_insert](/ar/reference/settings/merge-tree-settings#materialize_projections_on_insert).
## materialize\_skip\_indexes\_on\_merge
عند تفعيل هذا الإعداد، تُنشئ عمليات الدمج فهارس التخطي للأجزاء الجديدة وتخزّنها.
أما إذا لم يكن مفعّلًا، فيمكن إنشاؤها/تخزينها صراحةً عبر [MATERIALIZE INDEX](/ar/reference/statements/alter/skipping-index#materialize-index)
أو [أثناء عمليات INSERT](/ar/reference/settings/session-settings#materialize_skip_indexes_on_insert).
راجع أيضًا [exclude\_materialize\_skip\_indexes\_on\_merge](#exclude_materialize_skip_indexes_on_merge) لمزيد من التحكم الدقيق.
## materialize\_statistics\_on\_merge
عند تفعيل هذا الإعداد، تنشئ عمليات الدمج الإحصاءات للأجزاء الجديدة وتخزّنها.
وإلا، يمكن إنشاؤها/تخزينها صراحةً باستخدام [MATERIALIZE STATISTICS](/ar/reference/statements/alter/statistics)
أو [أثناء عمليات INSERT](/ar/reference/settings/session-settings#materialize_statistics_on_insert)
## materialize\_ttl\_recalculate\_only
أعِد احتساب معلومات TTL فقط عند تنفيذ MATERIALIZE TTL
## max\_avg\_part\_size\_for\_too\_many\_parts
لن يكون فحص 'too many parts' وفقًا لـ 'parts\_to\_delay\_insert' و
'parts\_to\_throw\_insert' نشطًا إلا إذا كان متوسط حجم الجزء (في
الـ partition المعني) لا يتجاوز العتبة المحددة. وإذا
تجاوزها، فلن تُؤجَّل عمليات INSERT ولن تُرفَض. يتيح ذلك
وجود مئات التيرابايتات في جدول واحد على خادم واحد إذا
دُمجت الأجزاء بنجاح في أجزاء أكبر. ولا يؤثر ذلك في
العتبات الخاصة بالأجزاء غير النشطة أو بإجمالي الأجزاء.
## max\_buckets\_in\_map
الحد الأقصى لعدد الـ حاوية لتسلسل `Map`. يعمل مع تسلسل `Map` باستخدام `with_buckets`.
يُحدَّد العدد الفعلي للـ حاوية بواسطة [map\_buckets\_strategy](#map_buckets_strategy).
الحد الأقصى المسموح به هو 256.
## max\_bytes\_to\_merge\_at\_max\_space\_in\_pool
الحد الأقصى لإجمالي حجم الأجزاء (بالبايت) التي يمكن دمجها في جزء واحد، إذا
كانت الموارد المتاحة كافية. ويقابل ذلك تقريبًا أكبر
حجم ممكن للجزء الناتج عن عملية دمج تلقائية في الخلفية. (تعني القيمة 0 تعطيل عمليات الدمج)
القيم الممكنة:
* أي عدد صحيح غير سالب.
يحلّل مُجدول الدمج دوريًا أحجام الأجزاء وعددها داخل
الأقسام، وإذا توفرت موارد حرة كافية في المجمّع، فإنه يبدأ
عمليات دمج في الخلفية. وتستمر عمليات الدمج إلى أن يصبح الحجم الإجمالي للأجزاء المصدر
أكبر من `max_bytes_to_merge_at_max_space_in_pool`.
تتجاهل عمليات الدمج التي يبدأها [OPTIMIZE FINAL](/ar/reference/statements/optimize)
القيمة `max_bytes_to_merge_at_max_space_in_pool` (إذ لا
تؤخذ في الحسبان إلا المساحة الحرة على القرص).
## max\_bytes\_to\_merge\_at\_min\_space\_in\_pool
الحد الأقصى لإجمالي حجم الأجزاء (بالبايت) التي يمكن دمجها في جزء واحد، عند
الحد الأدنى من الموارد المتاحة في تجمع الخلفية.
القيم الممكنة:
* أي عدد صحيح موجب.
يحدّد `max_bytes_to_merge_at_min_space_in_pool` الحد الأقصى للحجم الإجمالي
للأجزاء التي يمكن دمجها رغم نقص مساحة القرص المتاحة (في التجمع).
وهذا ضروري لتقليل عدد الأجزاء الصغيرة وخفض احتمال ظهور أخطاء
`Too many parts`.
تحجز عمليات الدمج مساحة على القرص تعادل ضعف الحجم الإجمالي للأجزاء المدمجة.
لذلك، عند توفّر قدر قليل من المساحة الحرة على القرص، قد تنشأ حالة
تكون فيها هناك مساحة حرة، لكنها تكون محجوزة بالفعل لعمليات دمج كبيرة جارية،
وبالتالي لا تتمكن عمليات دمج أخرى من البدء، ويزداد عدد الأجزاء الصغيرة
مع كل عملية insert.
## max\_cleanup\_delay\_period
الحد الأقصى للمدة اللازمة لتنظيف سجلات قائمة الانتظار القديمة، وقيم تجزئة الكتل، والأجزاء.
## max\_compress\_block\_size
الحد الأقصى لحجم كتل البيانات غير المضغوطة قبل ضغطها وكتابتها
إلى جدول. يمكنك أيضًا تحديد هذا الإعداد ضمن الإعدادات العامة
(راجع إعداد [max\_compress\_block\_size](/ar/reference/settings/merge-tree-settings#max_compress_block_size)
). تتجاوز القيمة المحددة عند إنشاء الجدول
القيمة العامة لهذا الإعداد.
## max\_concurrent\_queries
الحد الأقصى لعدد الاستعلامات التي تُنفَّذ بالتوازي والمرتبطة بجدول MergeTree.
ستظل الاستعلامات خاضعة لإعدادات `max_concurrent_queries` الأخرى.
القيم الممكنة:
* عدد صحيح موجب.
* `0` — بدون حد.
القيمة الافتراضية: `0` (بدون حد).
**مثال**
```xml theme={null}
50
```
## max\_delay\_to\_insert
القيمة بالثواني، وتُستخدم لحساب تأخير `INSERT` إذا
تجاوز عدد الأجزاء النشطة في partition واحدة قيمة
[parts\_to\_delay\_insert](#parts_to_delay_insert).
القيم الممكنة:
* أي عدد صحيح موجب.
يُحسب تأخير `INSERT` (بالملي ثانية) وفق الصيغة التالية:
```code theme={null}
max_k = parts_to_throw_insert - parts_to_delay_insert
k = 1 + parts_count_in_partition - parts_to_delay_insert
delay_milliseconds = pow(max_delay_to_insert * 1000, k / max_k)
```
على سبيل المثال، إذا كان partition يحتوي على 299 جزءًا نشطًا وكان parts\_to\_throw\_insert
\= 300، وparts\_to\_delay\_insert = 150، وmax\_delay\_to\_insert = 1، فسيتم
تأخير `INSERT` لمدة `pow( 1 * 1000, (1 + 299 - 150) / (300 - 150) ) = 1000`
مللي ثانية.
اعتبارًا من الإصدار 23.1، تغيرت الصيغة إلى:
```code theme={null}
allowed_parts_over_threshold = parts_to_throw_insert - parts_to_delay_insert
parts_over_threshold = parts_count_in_partition - parts_to_delay_insert + 1
delay_milliseconds = max(min_delay_to_insert_ms, (max_delay_to_insert * 1000)
* parts_over_threshold / allowed_parts_over_threshold)
```
على سبيل المثال، إذا كان لأحد الأقسام 224 جزءًا نشطًا وكانت قيم parts\_to\_throw\_insert
\= 300، وparts\_to\_delay\_insert = 150، وmax\_delay\_to\_insert = 1،
وmin\_delay\_to\_insert\_ms = 10، فسيُؤخَّر `INSERT` لمدة `max( 10, 1 * 1000 *
(224 - 150 + 1) / (300 - 150) ) = 500` مللي ثانية.
## max\_delay\_to\_mutate\_ms
الحد الأقصى لتأخير إجراء mutation على جدول MergeTree بالمللي ثانية، إذا كان هناك عدد كبير من
عمليات mutation غير المكتملة
## max\_digestion\_size\_per\_segment
إعداد متقادم، وليس له أي تأثير.
## max\_file\_name\_length
الحد الأقصى لطول اسم الملف للإبقاء عليه كما هو من دون تجزئته.
يسري هذا فقط إذا كان الإعداد `replace_long_file_name_to_hash` مُمكّنًا.
لا تتضمن قيمة هذا الإعداد طول امتداد الملف. لذلك،
يوصى بضبطه على قيمة أقل من الحد الأقصى لطول اسم الملف (عادةً 255
بايتًا) مع ترك هامش لتجنب أخطاء نظام الملفات.
## max\_files\_to\_modify\_in\_alter\_columns
لا تُنفِّذ ALTER إذا كان عدد الملفات المطلوب تعديلها (حذفًا أو إضافةً)
أكبر من قيمة هذا الإعداد.
القيم الممكنة:
* أي عدد صحيح موجب.
القيمة الافتراضية: 75
## max\_files\_to\_remove\_in\_alter\_columns
لا تُنفِّذ ALTER إذا كان عدد الملفات المراد حذفها أكبر من هذا
الإعداد.
القيم الممكنة:
* أي عدد صحيح موجب.
## max\_merge\_delayed\_streams\_for\_parallel\_write
الحد الأقصى لعدد المسارات (الأعمدة) التي يمكن تفريغها بالتوازي
(النظير لـ max\_insert\_delayed\_streams\_for\_parallel\_write في عمليات الدمج). يعمل
فقط مع عمليات الدمج الرأسية.
## max\_merge\_selecting\_sleep\_ms
الحد الأقصى للوقت الواجب انتظاره قبل إعادة محاولة تحديد الأجزاء المراد دمجها بعد
عدم تحديد أي أجزاء. سيؤدي تقليل هذه القيمة إلى تشغيل مهام التحديد بشكل متكرر في
background\_schedule\_pool، مما ينتج عنه عدد كبير من
الطلبات إلى ZooKeeper في العناقيد واسعة النطاق
## max\_number\_of\_merges\_with\_ttl\_in\_pool
عندما يتجاوز عدد
عمليات الدمج التي تحتوي على إدخالات TTL في المجمّع العددَ المحدد، فلا تُسند
عملية دمج جديدة مع TTL. يهدف ذلك إلى الإبقاء على
خيوط تنفيذ متاحة لعمليات الدمج العادية وتجنّب "Too many parts"
## max\_number\_of\_mutations\_for\_replica
يحدّ عدد عمليات تعديل الأجزاء لكل نسخة متماثلة بالقيمة المحددة.
يعني الصفر عدم فرض أي حدّ على عدد عمليات التعديل لكل نسخة متماثلة (مع أن التنفيذ قد
يبقى مقيّدًا بإعدادات أخرى).
## max\_part\_loading\_threads
إعداد متقادم لم يعد له أي تأثير.
## max\_part\_removal\_threads
إعداد متقادم، بلا تأثير.
## max\_partitions\_to\_read
يحدّد الحد الأقصى لعدد الأقسام التي يمكن الوصول إليها في استعلام واحد.
يمكن تجاوز قيمة الإعداد المحددة عند إنشاء الجدول
عبر إعداد على مستوى الاستعلام.
القيم الممكنة:
* أي عدد صحيح موجب.
يمكنك أيضًا تحديد إعداد لتعقيد الاستعلام [max\_partitions\_to\_read](/ar/reference/settings/session-settings#max_partitions_to_read)
على مستوى الاستعلام / الجلسة / ملف التعريف.
## max\_parts\_in\_total
إذا تجاوز العدد الإجمالي للأجزاء النشطة في جميع الأقسام في جدول واحد
القيمة `max_parts_in_total`، تتوقف عملية `INSERT` ويُطرح الاستثناء `Too many parts
(N)`.
القيم الممكنة:
* أي عدد صحيح موجب.
يؤدي العدد الكبير من الأجزاء في الجدول إلى تراجع أداء استعلامات ClickHouse
وزيادة وقت بدء تشغيل ClickHouse. وغالبًا ما يكون ذلك نتيجة تصميم غير
صحيح (أخطاء عند اختيار استراتيجية التقسيم - أقسام صغيرة جدًا).
## max\_parts\_to\_merge\_at\_once
الحد الأقصى لعدد الأجزاء التي يمكن دمجها في المرة الواحدة (0 - معطّل). لا يؤثر هذا
في استعلام OPTIMIZE FINAL.
## max\_postpone\_time\_for\_failed\_mutations\_ms
الحد الأقصى لمدة تأجيل التعديلات الفاشلة.
## max\_postpone\_time\_for\_failed\_replicated\_fetches\_ms
الحد الأقصى لمدة تأجيل عمليات الجلب الفاشلة في النسخ المتماثل.
## max\_postpone\_time\_for\_failed\_replicated\_merges\_ms
الحد الأقصى لوقت تأجيل عمليات الدمج المتماثلة الفاشلة.
## max\_postpone\_time\_for\_failed\_replicated\_tasks\_ms
الحد الأقصى لمدة تأجيل المهمة المتماثلة الفاشلة. تُستخدم هذه القيمة إذا لم تكن المهمة عملية جلب أو دمج أو تعديل.
## max\_projections
الحد الأقصى لعدد إسقاطات MergeTree.
## max\_replicated\_fetches\_network\_bandwidth
يحدّد السرعة القصوى لتبادل البيانات عبر الشبكة، بالبايت في
الثانية، لعمليات الجلب [المتماثلة](/ar/reference/engines/table-engines/mergetree-family/replication).
ويُطبَّق هذا الإعداد على جدول معيّن، بخلاف
الإعداد [`max_replicated_fetches_network_bandwidth_for_server`](/ar/reference/settings/merge-tree-settings#max_replicated_fetches_network_bandwidth)،
الذي يُطبَّق على الخادم.
يمكنك تقييد كلٍّ من شبكة الخادم والشبكة الخاصة بجدول معيّن، ولكن لتحقيق
ذلك يجب أن تكون قيمة الإعداد على مستوى الجدول أقل من القيمة على مستوى
الخادم. وإلا فلن يأخذ الخادم في الاعتبار إلا
الإعداد `max_replicated_fetches_network_bandwidth_for_server`.
لا يُلتزم بهذا الإعداد دائمًا بدقة تامة.
القيم الممكنة:
* عدد صحيح موجب.
* `0` — غير محدود.
القيمة الافتراضية: `0`.
**الاستخدام**
يمكن استخدامه لتقييد السرعة عند نسخ البيانات متماثلًا لإضافة
عُقد جديدة أو استبدال عُقد قائمة.
## max\_replicated\_logs\_to\_keep
عدد السجلات التي يمكن أن يحتوي عليها سجل ClickHouse Keeper إذا كانت هناك
نسخة متماثلة غير نشطة. وتُعدّ النسخة المتماثلة غير النشطة مفقودة عند تجاوز هذا العدد.
القيم الممكنة:
* أي عدد صحيح موجب.
## max\_replicated\_merges\_in\_queue
عدد مهام دمج الأجزاء وتعديلها المسموح بتنفيذها بالتزامن في
قائمة انتظار ReplicatedMergeTree.
## max\_replicated\_merges\_with\_ttl\_in\_queue
عدد مهام دمج الأجزاء المرتبطة بـ TTL المسموح بتنفيذها في الوقت نفسه ضمن قائمة انتظار ReplicatedMergeTree.
## max\_replicated\_mutations\_in\_queue
عدد المهام الخاصة بالأجزاء قيد التعديل المسموح بتنفيذها بالتزامن في
قائمة انتظار ReplicatedMergeTree.
## max\_replicated\_sends\_network\_bandwidth
يحدّد السرعة القصوى لتبادل البيانات عبر الشبكة، بالبايت في
الثانية، لعمليات الإرسال [المتماثلة](/ar/reference/engines/table-engines/mergetree-family/replacingmergetree).
يُطبَّق هذا الإعداد على جدول معيّن، بخلاف الإعداد
[`max_replicated_sends_network_bandwidth_for_server`](/ar/reference/settings/merge-tree-settings#max_replicated_sends_network_bandwidth)
الذي يُطبَّق على الخادم.
يمكنك تقييد كلٍّ من شبكة الخادم والشبكة الخاصة بجدول معيّن، ولكن
يتطلّب ذلك أن تكون قيمة الإعداد على مستوى الجدول أقل من
القيمة على مستوى الخادم. وإلا فلن يأخذ الخادم في الاعتبار سوى
الإعداد `max_replicated_sends_network_bandwidth_for_server`.
لا يُطبَّق هذا الإعداد دائمًا بدقة تامة.
القيم الممكنة:
* عدد صحيح موجب.
* `0` — غير محدود.
**الاستخدام**
يمكن استخدامه لتقييد السرعة عند نسخ البيانات إلى
عُقد جديدة لإضافتها أو استبدالها.
## max\_suspicious\_broken\_parts
إذا تجاوز عدد الأجزاء التالفة في تجزئة واحدة
القيمة `max_suspicious_broken_parts`، فسيُرفض الحذف التلقائي.
القيم الممكنة:
* أي عدد صحيح موجب.
## max\_suspicious\_broken\_parts\_bytes
الحد الأقصى لإجمالي حجم الأجزاء التالفة؛ وإذا زاد عن ذلك، فسيتم رفض الحذف التلقائي.
القيم الممكنة:
* أي عدد صحيح موجب.
## max\_uncompressed\_bytes\_in\_patches
الحد الأقصى للحجم غير المضغوط للبيانات في جميع أجزاء التصحيح، محسوبًا بالبايت.
إذا تجاوزت كمية البيانات في جميع أجزاء التصحيح هذه القيمة، فستُرفَض التحديثات خفيفة الوزن.
0 - غير محدود.
## merge\_max\_block\_size
عدد الصفوف التي تُقرأ من الأجزاء المدمجة إلى الذاكرة.
القيم الممكنة:
* أي عدد صحيح موجب.
تقرأ عملية الدمج الصفوف من الأجزاء على شكل كتل تضم `merge_max_block_size` صفًا، ثم
تدمج النتيجة وتكتبها في جزء جديد. وتُوضَع كتلة القراءة في RAM،
لذا يؤثر `merge_max_block_size` في مقدار RAM المطلوب لعملية الدمج.
لذلك، قد تستهلك عمليات الدمج مقدارًا كبيرًا من RAM في الجداول ذات الصفوف العريضة جدًا
(إذا كان متوسط حجم الصف 100kb، فعند دمج 10 أجزاء،
فإن (100kb \* 10 \* 8192) = \~ 8GB من RAM). ومن خلال تقليل `merge_max_block_size`،
يمكنك تقليل مقدار RAM المطلوب لعملية الدمج، لكن ذلك سيبطّئ عملية الدمج.
## merge\_max\_block\_size\_bytes
عدد البايتات في الكتل التي ينبغي تكوينها لعمليات الدمج. وتكون هذه القيمة افتراضيًا
مطابقة لقيمة `index_granularity_bytes`.
## merge\_max\_bytes\_to\_prewarm\_cache
متاح فقط في ClickHouse Cloud. الحد الأقصى لحجم جزء (compact أو packed)
لإجراء تهيئة مسبقة cache أثناء merge.
## merge\_max\_dynamic\_subcolumns\_in\_compact\_part
الحد الأقصى لعدد الأعمدة الفرعية الديناميكية التي يمكن إنشاؤها في كل عمود ضمن جزء البيانات Compact بعد الدمج.
ويتيح ذلك التحكم في عدد الأعمدة الفرعية الديناميكية في الجزء Compact بغض النظر عن المعلمات الديناميكية المحددة في نوع البيانات.
على سبيل المثال، إذا كان الجدول يحتوي على عمود من النوع JSON(max\_dynamic\_paths=1024) وكان الإعداد merge\_max\_dynamic\_subcolumns\_in\_compact\_part مضبوطًا على 128،
فبعد الدمج في جزء البيانات Compact سيُخفَّض عدد المسارات الديناميكية إلى 128 في هذا الجزء، ولن يُكتَب إلا 128 مسارًا كأعمدة فرعية ديناميكية.
## merge\_max\_dynamic\_subcolumns\_in\_wide\_part
الحد الأقصى لعدد الأعمدة الفرعية الديناميكية التي يمكن إنشاؤها في كل عمود ضمن جزء البيانات Wide بعد الدمج.
ويتيح ذلك تقليل عدد الملفات التي يتم إنشاؤها في جزء البيانات Wide، بغض النظر عن المعلمات الديناميكية المحددة في نوع البيانات.
على سبيل المثال، إذا كان الجدول يحتوي على عمود من النوع JSON(max\_dynamic\_paths=1024) وكان الإعداد merge\_max\_dynamic\_subcolumns\_in\_wide\_part مضبوطًا على 128،
فبعد الدمج في جزء البيانات Wide، سيُخفَّض عدد المسارات الديناميكية إلى 128 في هذا الجزء، ولن يُكتَب إلا 128 مسارًا كأعمدة فرعية ديناميكية.
## merge\_selecting\_sleep\_ms
الحد الأدنى للوقت الذي يجب انتظاره قبل إعادة محاولة تحديد الأجزاء المراد دمجها بعد
عدم تحديد أي أجزاء. سيؤدي تقليل هذا الإعداد إلى تشغيل مهام التحديد في
background\_schedule\_pool بشكل متكرر، مما ينتج عنه عدد كبير من الطلبات
إلى ZooKeeper في العناقيد واسعة النطاق
## merge\_selecting\_sleep\_slowdown\_factor
يُضرَب وقت الانتظار لمهمة اختيار الدمج في هذا العامل عندما
لا توجد عمليات دمج، ويُقسَم عليه عندما تُسنَد عملية دمج
## merge\_selector\_algorithm
الخوارزمية المستخدمة لاختيار الأجزاء لإسناد عمليات الدمج
## merge\_selector\_base
يؤثر في تضخيم الكتابة لعمليات الدمج
المحددة (إعداد مخصص للمستخدمين الخبراء، لا تغيّره إذا لم تكن تفهم
ما الذي يفعله). يعمل مع محددات الدمج Simple و StochasticSimple
## merge\_selector\_blurry\_base\_scale\_factor
يتحكم في توقيت تفعيل هذا المنطق بالنسبة إلى عدد الأجزاء في
التقسيم. وكلما زادت قيمة العامل، كان التفاعل أكثر تأخرًا.
## merge\_selector\_enable\_heuristic\_to\_lower\_max\_parts\_to\_merge\_at\_once
يُفعِّل نهجًا استدلاليًا لمحدِّد الدمج البسيط، مما يُخفِّض الحد الأقصى لاختيار عمليات الدمج.
وبذلك سيزداد عدد عمليات الدمج المتزامنة، مما قد يساعد في تقليل أخطاء TOO\_MANY\_PARTS،
لكنه في الوقت نفسه سيزيد من تضخيم الكتابة.
## merge\_selector\_enable\_heuristic\_to\_remove\_small\_parts\_at\_right
تمكين آلية استدلالية لاختيار الأجزاء المراد دمجها، بحيث تزيل الأجزاء من الجانب
الأيمن من النطاق إذا كان حجمها أقل من النسبة المحددة (0.01) من sum\_size.
تعمل مع محددات الدمج Simple وStochasticSimple
## merge\_selector\_heuristic\_to\_lower\_max\_parts\_to\_merge\_at\_once\_exponent
يتحكم في قيمة الأس المستخدمة في الصيغ التي تنشئ منحنى الخفض. سيؤدي تقليل قيمة الأس إلى تقليل أحجام الدمج، ما يؤدي إلى زيادة تضخيم الكتابة. وينطبق العكس أيضًا.
## merge\_selector\_window\_size
عدد الأجزاء التي تُفحَص في المرة الواحدة.
## merge\_total\_max\_bytes\_to\_prewarm\_cache
متاح فقط في ClickHouse Cloud. الحد الأقصى لإجمالي حجم الأجزاء التي ستُهيَّأ تهيئة مسبقة إلى ذاكرة التخزين المؤقت أثناء الدمج.
## merge\_tree\_clear\_old\_broken\_detached\_parts\_ttl\_timeout\_seconds
إعداد متقادم، وليس له أي تأثير.
## merge\_tree\_clear\_old\_parts\_interval\_seconds
يحدّد الفاصل الزمني بالثواني الذي ينفّذ عنده ClickHouse عملية تنظيف
الأجزاء القديمة، وWALs، والتعديلات.
القيم الممكنة:
* أي عدد صحيح موجب.
## merge\_tree\_clear\_old\_temporary\_directories\_interval\_seconds
يحدّد الفاصل الزمني، بالثواني، الذي ينفّذ فيه ClickHouse عملية تنظيف
الأدلة المؤقتة القديمة.
القيم الممكنة:
* أي عدد صحيح موجب.
## merge\_tree\_enable\_clear\_old\_broken\_detached
إعداد متقادم، لا تأثير له.
## merge\_with\_recompression\_ttl\_timeout
الحد الأدنى لفترة التأخير بالثواني قبل تكرار عملية دمج باستخدام TTL لإعادة الضغط.
## merge\_with\_ttl\_timeout
الحد الأدنى للتأخير، بالثواني، قبل إعادة تنفيذ عملية دمج مع TTL للحذف.
## merge\_workload
يُستخدم لتنظيم كيفية استخدام الموارد وتقاسمها بين عمليات الدمج
وأحمال العمل الأخرى. وتُستخدم القيمة المحددة كقيمة لإعداد `workload`
لعمليات الدمج في الخلفية لهذا الجدول. وإذا لم تُحدَّد (سلسلة فارغة)،
فسيُستخدم بدلًا من ذلك إعداد الخادم `merge_workload`.
**انظر أيضًا**
* [جدولة أحمال العمل](/ar/concepts/features/configuration/server-config/workload-scheduling)
## min\_absolute\_delay\_to\_close
الحد الأدنى للتأخير المطلق قبل الإغلاق، والتوقف عن خدمة الطلبات، وعدم
إرجاع Ok أثناء التحقق من status.
## min\_age\_to\_force\_merge\_on\_partition\_only
ما إذا كان يجب تطبيق `min_age_to_force_merge_seconds` على القسم بأكمله فقط،
وليس على مجموعة فرعية.
افتراضيًا، يتجاهل هذا الإعداد `max_bytes_to_merge_at_max_space_in_pool` (راجع
`enable_max_bytes_limit_for_min_age_to_force_merge`).
القيم الممكنة:
* true, false
## min\_age\_to\_force\_merge\_seconds
ادمج الأجزاء إذا كان كل جزء ضمن النطاق أقدم من القيمة المحددة في
`min_age_to_force_merge_seconds`.
يتجاهل هذا الإعداد افتراضيًا الإعداد `max_bytes_to_merge_at_max_space_in_pool`
(راجع `enable_max_bytes_limit_for_min_age_to_force_merge`).
القيم الممكنة:
* عدد صحيح موجب.
## min\_bytes\_for\_compact\_part
إعداد قديم لم يعد له أي تأثير.
## min\_bytes\_for\_full\_part\_storage
متاح فقط في ClickHouse Cloud. الحد الأدنى للحجم غير المضغوط، بالبايتات،
لاستخدام نوع التخزين الكامل لجزء البيانات بدلًا من packed
## min\_bytes\_for\_wide\_part
الحد الأدنى لعدد البايتات/الصفوف في جزء بيانات يمكن تخزينه بتنسيق `Wide`.
يمكنك تعيين أحد هذين الإعدادين أو كليهما، أو عدم تعيين أيٍّ منهما.
## min\_bytes\_to\_prewarm\_caches
الحد الأدنى للحجم (بالبايتات غير المضغوطة) المطلوب للتهيئة المسبقة لذاكرة التخزين المؤقت للعلامات وذاكرة التخزين المؤقت للفهرس الأساسي
للأجزاء الجديدة
## min\_bytes\_to\_rebalance\_partition\_over\_jbod
يحدد الحد الأدنى من البايتات المطلوب لتمكين الموازنة عند توزيع
الأجزاء الكبيرة الجديدة على أقراص وحدة التخزين [JBOD](https://en.wikipedia.org/wiki/Non-RAID_drive_architectures).
القيم الممكنة:
* عدد صحيح موجب.
* `0` — تكون الموازنة معطلة.
**الاستخدام**
يجب ألا تقل قيمة الإعداد `min_bytes_to_rebalance_partition_over_jbod`
عن قيمة
[max\_bytes\_to\_merge\_at\_max\_space\_in\_pool](/ar/reference/settings/merge-tree-settings#max_bytes_to_merge_at_max_space_in_pool)
/ 1024. وإلا، فسيُصدر ClickHouse استثناءً.
## min\_columns\_to\_activate\_adaptive\_write\_buffer
يسمح بتقليل استهلاك الذاكرة للجداول التي تحتوي على عدد كبير من الأعمدة باستخدام مخازن الكتابة التكيفية.
القيم الممكنة:
* 0 - غير محدود
* 1 - ممكّن دائمًا
## min\_compress\_block\_size
الحد الأدنى لحجم كتل البيانات غير المضغوطة اللازمة لتطبيق الضغط عند
كتابة الـ mark التالية. يمكنك أيضًا تحديد هذا الإعداد ضمن الإعدادات العامة
(راجع إعداد
[min\_compress\_block\_size](/ar/reference/settings/merge-tree-settings#min_compress_block_size)).
تتجاوز القيمة المحددة عند إنشاء الجدول القيمة العامة
لهذا الإعداد.
## min\_compressed\_bytes\_to\_fsync\_after\_fetch
الحد الأدنى لعدد البايتات المضغوطة اللازمة لإجراء `fsync` للجزء بعد جلبه (0 - معطّل)
## min\_compressed\_bytes\_to\_fsync\_after\_merge
الحد الأدنى لعدد البايتات المضغوطة اللازمة لتنفيذ fsync على الجزء بعد الدمج (0 - معطّل)
## min\_delay\_to\_insert\_ms
الحد الأدنى لتأخير إدراج البيانات في جدول MergeTree، بالمللي ثانية، إذا كان هناك
عدد كبير من الأجزاء غير المدمجة ضمن قسم واحد.
## min\_delay\_to\_mutate\_ms
الحد الأدنى للتأخير قبل إجراء mutation على جدول MergeTree، بالمللي ثانية، إذا كان هناك عدد كبير من عمليات mutation غير المكتملة
## min\_free\_disk\_bytes\_to\_perform\_insert
الحد الأدنى لعدد البايتات التي يجب أن تكون متوفرة كمساحة حرة على القرص
لإدراج البيانات. إذا كان عدد البايتات الحرة المتوفرة أقل من
`min_free_disk_bytes_to_perform_insert`، فسيتم إطلاق استثناء ولن يتم
تنفيذ عملية الإدراج. لاحظ أن هذا الإعداد:
* يأخذ في الاعتبار الإعداد `keep_free_space_bytes`.
* لا يأخذ في الاعتبار مقدار البيانات التي ستتم كتابتها بواسطة عملية
`INSERT`.
* لا يتم التحقق منه إلا إذا تم تحديد عدد بايتات موجب (غير صفري)
القيم الممكنة:
* أي عدد صحيح موجب.
إذا تم تحديد كل من `min_free_disk_bytes_to_perform_insert` و `min_free_disk_ratio_to_perform_insert`،
فإن ClickHouse سيعتمد على القيمة التي ستسمح بتنفيذ
عمليات الإدراج على مقدار أكبر من الذاكرة الحرة.
## min\_free\_disk\_ratio\_to\_perform\_insert
الحد الأدنى لنسبة المساحة الحرة إلى إجمالي مساحة القرص اللازمة لتنفيذ `INSERT`. يجب أن تكون
قيمة عددية عائمة بين 0 و1. لاحظ أن هذا الإعداد:
* يأخذ في الاعتبار الإعداد `keep_free_space_bytes`.
* لا يأخذ في الاعتبار مقدار البيانات التي ستتم كتابتها بواسطة
عملية `INSERT`.
* لا يتم التحقق منه إلا إذا تم تحديد نسبة موجبة (غير صفرية)
القيم الممكنة:
* Float، 0.0 - 1.0
لاحظ أنه إذا تم تحديد كل من `min_free_disk_ratio_to_perform_insert` و
`min_free_disk_bytes_to_perform_insert`، فسيعتمد ClickHouse
على القيمة التي ستسمح بتنفيذ عمليات insert عند توفر مقدار أكبر من
الذاكرة الحرة.
## min\_index\_granularity\_bytes
الحد الأدنى المسموح به لحجم حبيبات البيانات بالبايت.
لتوفير حماية من إنشاء الجداول عن طريق الخطأ بقيمة منخفضة جدًا لـ
`index_granularity_bytes`.
## min\_level\_for\_full\_part\_storage
متاح فقط في ClickHouse Cloud. الحد الأدنى لمستوى الجزء لاستخدام نوع التخزين الكامل لجزء البيانات بدلًا من التخزين مضغوط
## min\_level\_for\_wide\_part
الحد الأدنى لمستوى جزء البيانات لإنشاء جزء بيانات بتنسيق `Wide` بدلًا من `Compact`.
## min\_marks\_to\_honor\_max\_concurrent\_queries
الحد الأدنى لعدد العلامات التي يقرأها الاستعلام لتطبيق الإعداد [max\_concurrent\_queries](#max_concurrent_queries).
ستظل الاستعلامات مقيَّدة بإعدادات `max_concurrent_queries` الأخرى.
القيم الممكنة:
* عدد صحيح موجب.
* `0` — معطَّل (لا يُطبَّق حد `max_concurrent_queries` على أي استعلام).
**مثال**
```xml theme={null}
10
```
## min\_merge\_bytes\_to\_use\_direct\_io
الحد الأدنى لحجم البيانات في عملية الدمج اللازم لاستخدام
وصول I/O المباشر إلى قرص التخزين. عند دمج أجزاء البيانات، يحسب ClickHouse
إجمالي حجم التخزين لجميع البيانات المطلوب دمجها. إذا تجاوز هذا الحجم
`min_merge_bytes_to_use_direct_io` بايت، يقرأ ClickHouse البيانات ويكتبها
إلى قرص التخزين باستخدام واجهة I/O المباشرة (الخيار `O_DIRECT`).
إذا كانت قيمة `min_merge_bytes_to_use_direct_io = 0`، فسيتم تعطيل I/O المباشر.
## min\_parts\_to\_merge\_at\_once
الحد الأدنى لعدد أجزاء البيانات التي يمكن لمنتقي الدمج اختيارها لدمجها دفعة واحدة
(إعداد مخصّص للخبراء، لا تغيّره إذا لم تكن تفهم ما يفعله).
0 - معطّل. يعمل مع منتقِيَي الدمج Simple وStochasticSimple.
## min\_relative\_delay\_to\_close
الحد الأدنى للتأخير مقارنةً بالنسخ المتماثلة الأخرى قبل إغلاق الخدمة، والتوقف عن
خدمة الطلبات، وعدم إرجاع Ok أثناء فحص الحالة.
## min\_relative\_delay\_to\_measure
احسب التأخير النسبي للنسخة المتماثلة فقط إذا كان التأخير المطلق لا يقل عن
هذه القيمة.
## min\_relative\_delay\_to\_yield\_leadership
إعداد متقادِم، لا تأثير له.
## min\_replicated\_logs\_to\_keep
احتفِظ بنحو هذا العدد من آخر السجلات في سجل ZooKeeper، حتى لو كانت
متقادمة. لا يؤثر ذلك في عمل الجداول: إذ يُستخدم فقط لتشخيص سجل ZooKeeper
قبل تنظيفه.
القيم الممكنة:
* أي عدد صحيح موجب.
## min\_rows\_for\_compact\_part
إعداد متقادم، لا تأثير له.
## min\_rows\_for\_full\_part\_storage
متاح فقط في ClickHouse Cloud. الحد الأدنى لعدد الصفوف المطلوب لاستخدام نوع التخزين الكامل
لجزء البيانات بدلًا من التخزين المضغوط
## min\_rows\_for\_wide\_part
الحد الأدنى لعدد الصفوف اللازمة لإنشاء جزء بيانات بتنسيق `Wide` بدلًا من `Compact`.
## min\_rows\_to\_fsync\_after\_merge
الحد الأدنى لعدد الصفوف المطلوب لتنفيذ `fsync` للجزء بعد الدمج (0 - معطّل)
## mutation\_workload
يُستخدم لضبط كيفية استخدام الموارد وتقاسمها بين الـmutations وأعباء العمل
الأخرى. وتُستخدم القيمة المحددة كقيمة لإعداد `workload` لعمليات الـmutations
التي تعمل في الخلفية لهذا الجدول. وإذا لم تُحدَّد (سلسلة فارغة)، فسيُستخدم بدلًا
من ذلك إعداد الخادم `mutation_workload`.
**راجع أيضًا**
* [جدولة أعباء العمل](/ar/concepts/features/configuration/server-config/workload-scheduling)
## non\_replicated\_deduplication\_window
عدد أحدث الكتل التي أُدرجت في جدول
[MergeTree](/ar/reference/engines/table-engines/mergetree-family/mergetree) غير المكرّر
والتي تُخزَّن مجاميع hash الخاصة بها للتحقق من التكرارات.
القيم الممكنة:
* أي عدد صحيح موجب.
* `0` (تعطيل إزالة التكرار).
تُستخدم آلية لإزالة التكرار مشابهة لتلك المستخدمة في الجداول المكرّرة (انظر
إعداد [replicated\_deduplication\_window](#replicated_deduplication_window)).
وتُكتب مجاميع hash الخاصة بالأجزاء المُنشأة إلى ملف محلي على قرص.
## notify\_newest\_block\_number
إخطار SharedJoin أو SharedSet برقم أحدث كتلة. متاح فقط في ClickHouse Cloud.
## nullable\_serialization\_version
يتحكم في طريقة التسلسل المستخدمة لأعمدة `Nullable(T)`.
القيم الممكنة:
* basic — يستخدم التسلسل القياسي لـ `Nullable(T)`.
* allow\_sparse — يتيح لـ `Nullable(T)` استخدام الترميز المتناثر.
## number\_of\_free\_entries\_in\_pool\_to\_execute\_mutation
عندما يكون عدد الخانات الحرة في المجمّع أقل من العدد المحدد، لا
تُنفَّذ mutation للأجزاء. والهدف من ذلك هو إبقاء خيوط حرة لعمليات الدمج
العادية وتجنّب أخطاء "Too many parts".
القيم الممكنة:
* أي عدد صحيح موجب.
**الاستخدام**
يجب أن تكون قيمة الإعداد `number_of_free_entries_in_pool_to_execute_mutation`
أقل من قيمة [background\_pool\_size](/ar/reference/settings/server-settings/settings#background_pool_size)
* [background\_merges\_mutations\_concurrency\_ratio](/ar/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
وإلا، فسيطرح ClickHouse استثناءً.
## number\_of\_free\_entries\_in\_pool\_to\_execute\_optimize\_entire\_partition
عندما يكون عدد الخانات الحرة في المجمّع أقل من العدد المحدد، لا
تُنفَّذ عملية تحسين القسم بالكامل في الخلفية (تُنشأ هذه المهمة
عند تعيين `min_age_to_force_merge_seconds` وتمكين
`min_age_to_force_merge_on_partition_only`). يهدف ذلك إلى ترك خيوط تنفيذ حرة
لعمليات الدمج العادية وتجنّب "Too many parts".
القيم الممكنة:
* عدد صحيح موجب.
يجب أن تكون قيمة الإعداد `number_of_free_entries_in_pool_to_execute_optimize_entire_partition`
أقل من قيمة
[background\_pool\_size](/ar/reference/settings/server-settings/settings#background_pool_size)
* [background\_merges\_mutations\_concurrency\_ratio](/ar/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
وإلا فإن ClickHouse يطرح استثناءً.
## number\_of\_free\_entries\_in\_pool\_to\_lower\_max\_size\_of\_merge
عندما يكون عدد الخانات الشاغرة في المجمّع
(أو في قائمة انتظار النسخ المتماثل) أقل من العدد المحدد، ابدأ بخفض الحجم الأقصى لعملية الدمج المطلوب معالجتها
(أو وضعها في قائمة الانتظار).
يهدف ذلك إلى إتاحة معالجة عمليات الدمج الصغيرة، بحيث لا يمتلئ المجمّع بعمليات دمج طويلة
التشغيل.
القيم الممكنة:
* أي عدد صحيح موجب.
## number\_of\_mutations\_to\_delay
إذا كان الجدول يحتوي على هذا العدد على الأقل
من mutations غير المكتملة، فسيتم إبطاء mutations الجدول اصطناعيًا.
يُعطَّل إذا ضُبط على 0
## number\_of\_mutations\_to\_throw
إذا كان الجدول يحتوي على هذا العدد أو أكثر من عمليات mutation غير المكتملة، فسيتم طرح الاستثناء 'Too many mutations'
يُعطَّل إذا ضُبط على 0
## number\_of\_partitions\_to\_consider\_for\_merge
متاح فقط في ClickHouse Cloud. حتى أعلى N من التقسيمات التي سنأخذها
في الاعتبار عند إجراء الدمج. تُختار التقسيمات بطريقة عشوائية موزونة، بحيث يكون الوزن
هو عدد أجزاء البيانات التي يمكن دمجها في هذا التقسيم.
## object\_serialization\_version
إصدار التسلسل لنوع بيانات JSON. وهو مطلوب للتوافق.
القيم الممكنة:
* `v1`
* `v2`
* `v3`
لا يدعم تغيير إصدار تسلسل البيانات المشتركة إلا الإصدار `v3`.
## object\_shared\_data\_buckets\_for\_compact\_part
عدد الحاويات لتسلسل البيانات المشتركة في JSON في الأجزاء المضغوطة. يعمل مع تسلسلي البيانات المشتركة `map_with_buckets` و`advanced`.
الحد الأقصى المسموح به هو 256.
## object\_shared\_data\_buckets\_for\_wide\_part
عدد الحاويات المستخدمة لتسلسل البيانات المشتركة في JSON داخل الأجزاء واسعة التنسيق. يعمل مع تسلسلي البيانات المشتركة `map_with_buckets` و`advanced`.
الحد الأقصى المسموح به هو 256.
## object\_shared\_data\_serialization\_version
إصدار التسلسل للبيانات المشتركة داخل نوع بيانات JSON.
القيم الممكنة:
* `map` - تخزين البيانات المشتركة على هيئة `Map(String, String)`
* `map_with_buckets` - تخزين البيانات المشتركة في عدة أعمدة منفصلة من `Map(String, String)`. يؤدي استخدام `buckets` إلى تحسين قراءة المسارات الفردية من البيانات المشتركة.
* `advanced` - تسلسل خاص للبيانات المشتركة، صُمم لتحسين قراءة المسارات الفردية من البيانات المشتركة بشكل كبير.
لاحظ أن هذا التسلسل يزيد حجم تخزين البيانات المشتركة على القرص، لأننا نخزن قدرًا كبيرًا من المعلومات الإضافية.
يُحدَّد عدد `buckets` لتسلسلي `map_with_buckets` و`advanced` بواسطة الإعدادين
[object\_shared\_data\_buckets\_for\_compact\_part](#object_shared_data_buckets_for_compact_part)/[object\_shared\_data\_buckets\_for\_wide\_part](#object_shared_data_buckets_for_wide_part).
## object\_shared\_data\_serialization\_version\_for\_zero\_level\_parts
يتيح هذا الإعداد تحديد إصدار تسلسل مختلف
للبيانات المشتركة داخل نوع JSON للأجزاء ذات المستوى الصفري التي تُنشأ أثناء عمليات الإدراج.
ويُوصى بعدم استخدام تسلسل البيانات المشتركة `advanced` للأجزاء ذات المستوى الصفري، لأنه قد يزيد
زمن الإدراج بشكل ملحوظ.
## old\_parts\_lifetime
المدة الزمنية (بالثواني) للاحتفاظ بالأجزاء غير النشطة حمايةً من فقدان البيانات
أثناء إعادة التشغيل المفاجئة للخادم.
القيم الممكنة:
* أي عدد صحيح موجب.
بعد دمج عدة أجزاء في جزء جديد، يضع ClickHouse علامة على الأجزاء
الأصلية باعتبارها غير نشطة، ولا يحذفها إلا بعد مرور `old_parts_lifetime` ثانية.
تُزال الأجزاء غير النشطة إذا لم تكن مستخدمة في الاستعلامات الحالية، أي إذا
كانت قيمة `refcount` للجزء تساوي 1.
لا يُستدعى `fsync` للأجزاء الجديدة، لذلك تظل هذه الأجزاء لبعض الوقت موجودة فقط
في RAM الخاصة بالخادم (ذاكرة التخزين المؤقت لنظام التشغيل). وإذا أُعيد تشغيل الخادم
فجأة، فقد تُفقد الأجزاء الجديدة أو تتلف. ولحماية البيانات، لا تُحذف
الأجزاء غير النشطة فورًا.
أثناء بدء التشغيل، يتحقق ClickHouse من سلامة الأجزاء. وإذا كان الجزء
المُدمَج تالفًا، يعيد ClickHouse الأجزاء غير النشطة إلى القائمة النشطة،
ثم يدمجها مرة أخرى لاحقًا. بعد ذلك يُعاد تسمية الجزء التالف (تُضاف
البادئة `broken_`) ويُنقل إلى المجلد `detached`. وإذا لم يكن الجزء المُدمَج
تالفًا، فتُعاد تسمية الأجزاء الأصلية غير النشطة (تُضاف البادئة `ignored_`)
وتُنقل إلى المجلد `detached`.
القيمة الافتراضية لـ `dirty_expire_centisecs` (وهو إعداد في نواة Linux) هي 30
ثانية (وهي الحد الأقصى للمدة التي تُخزَّن فيها البيانات المكتوبة في RAM فقط)، ولكن
مع الأحمال العالية على نظام القرص قد لا تُكتب البيانات إلا بعد ذلك بوقت أطول بكثير. تجريبيًا،
اختيرت قيمة 480 ثانية لـ `old_parts_lifetime`، وهي مدة يُضمن خلالها
كتابة الجزء الجديد إلى القرص.
## optimize\_row\_order
يتحكم هذا الإعداد في ما إذا كان ينبغي تحسين ترتيب الصفوف أثناء عمليات الإدراج لتحسين
قابلية ضغط جزء الجدول المُدرَج حديثًا.
لا يؤثر هذا الإعداد إلا في جداول MergeTree-engine العادية. ولا يكون له أي تأثير على
جداول محرك MergeTree المتخصصة (مثل CollapsingMergeTree).
تُضغط جداول MergeTree (اختياريًا) باستخدام [ترميزات الضغط](/ar/reference/statements/create/table#column_compression_codec).
وتحقق ترميزات الضغط العامة مثل LZ4 و ZSTD أعلى معدلات ضغط
عندما تُظهر البيانات أنماطًا متكررة. وعادةً ما تُضغط السلاسل الطويلة من القيمة نفسها
بكفاءة عالية.
إذا كان هذا الإعداد مُمكّنًا، يحاول ClickHouse تخزين البيانات في الأجزاء
المُدرَجة حديثًا بترتيب للصفوف يقلل عدد السلاسل ذات القيم المتساوية
عبر أعمدة جزء الجدول الجديد.
وبعبارة أخرى، فإن قلة عدد السلاسل ذات القيم المتساوية تعني أن كل سلسلة
تكون طويلة وتُضغط جيدًا.
يُعد العثور على ترتيب الصفوف الأمثل غير عملي حسابيًا (NP-hard).
لذلك، يستخدم ClickHouse أسلوبًا استدلاليًا للعثور بسرعة على ترتيب للصفوف
يُحسّن معدلات الضغط مقارنةً بترتيب الصفوف الأصلي.
أساليب استدلالية للعثور على ترتيب الصفوف
يمكن عمومًا خلط صفوف الجدول (أو جزء الجدول)
بحرية، لأن SQL تعتبر الجدول نفسه (أو جزء الجدول نفسه) مكافئًا
حتى مع اختلاف ترتيب الصفوف.
تُقيَّد هذه الحرية في خلط الصفوف عندما يكون المفتاح الأساسي معرّفًا
للجدول. في ClickHouse، يفرض المفتاح الأساسي `C1, C2, ..., CN` أن
تُرتَّب صفوف الجدول حسب الأعمدة `C1`, `C2`, ... `Cn` ([clustered index](https://en.wikipedia.org/wiki/Database_index#Clustered)).
ونتيجة لذلك، لا يمكن خلط الصفوف إلا داخل "فئات تكافؤ" للصفوف،
أي الصفوف التي لها القيم نفسها في أعمدة المفتاح الأساسي.
والفكرة هنا أن المفاتيح الأساسية ذات cardinality المرتفعة، مثل المفاتيح الأساسية
التي تتضمن عمود timestamp من النوع `DateTime64`، تؤدي إلى عدد كبير من فئات التكافؤ
الصغيرة. وبالمثل، فإن الجداول ذات المفتاح الأساسي منخفض cardinality تُنشئ عددًا قليلًا من
فئات التكافؤ الكبيرة. وتمثل الجداول التي لا تحتوي على مفتاح أساسي الحالة
القصوى المتمثلة في فئة تكافؤ واحدة تمتد عبر جميع الصفوف.
وكلما قل عدد فئات التكافؤ وكبر حجمها، زادت درجة
الحرية عند إعادة خلط الصفوف.
الأسلوب الاستدلالي المُستخدم للعثور على أفضل ترتيب للصفوف داخل كل فئة
تكافؤ اقترحه D. Lemire و O. Kaser في
[Reordering columns for smaller indexes](https://doi.org/10.1016/j.ins.2011.02.002)
ويعتمد على ترتيب الصفوف داخل كل فئة تكافؤ تصاعديًا بحسب
cardinality للأعمدة غير التابعة للمفتاح الأساسي.
ويتضمن ثلاث خطوات:
1. العثور على جميع فئات التكافؤ استنادًا إلى قيم الصفوف في أعمدة المفتاح الأساسي.
2. لكل فئة تكافؤ، حساب cardinality
للأعمدة غير التابعة للمفتاح الأساسي (أو تقديرها في العادة).
3. لكل فئة تكافؤ، ترتيب الصفوف تصاعديًا
بحسب cardinality للأعمدة غير التابعة للمفتاح الأساسي.
إذا كان هذا الإعداد مُمكّنًا، فستتحمل عمليات الإدراج تكلفة إضافية على CPU لتحليل
ترتيب صفوف البيانات الجديدة وتحسينه. ومن المتوقع أن تستغرق عمليات INSERT وقتًا أطول بنسبة 30-50%
بحسب خصائص البيانات.
كما تتحسن معدلات الضغط في LZ4 أو ZSTD بمتوسط 20-40%.
يعمل هذا الإعداد بأفضل شكل مع الجداول التي لا تحتوي على مفتاح أساسي أو التي لها مفتاح أساسي
منخفض cardinality، أي جدول لا يحتوي إلا على عدد قليل من قيم المفتاح الأساسي المميزة.
أما المفاتيح الأساسية ذات cardinality المرتفعة، مثل التي تتضمن أعمدة timestamp من النوع
`DateTime64`، فلا يُتوقع أن تستفيد من هذا الإعداد.
## packed\_skip\_index\_max\_bytes
.idx2` / `.mrk2` المنفصل. يُتخذ القرار لكل substream عند وقت الكتابة."}]}]} />
الحدّ (بالبايتات المتسلسلة على disk، أي بعد Compression وسلسلة hash
الخاصة بالـ substream) الذي إذا كان أقل منه، يُجمَّع substream لفهرس التخطّي في أرشيف
`skp_idx.packed` واحد لكل part بدلًا من كتابته كملف `skp_idx_.idx2` / `.mrk2`
منفصل. أما substreams الأكبر من ذلك فتظل في تخطيط legacy لكل ملف. ويُتخذ القرار
بشكل مستقل لكل substream عند وقت الكتابة، لذا يمكن أن يحتوي part واحد على
فهارس صغيرة (مثل `minmax`) مجمّعة وأخرى كبيرة (مثل `bloom_filter` ثقيل) كملفات منفصلة.
اضبطه على 0 لتعطيل packing بالكامل (القيمة الافتراضية).
يتكوّن كل substream لفهرس التخطّي فعليًا من ملف data وملف marks؛ ويُحتفَظ بكليهما مؤقتًا
في Memory حتى بلوغ الحدّ قبل اتخاذ قرار spill. لذا فإن Peak memory أثناء
الكتابة يتناسب مع `2 * packed_skip_index_max_bytes * (number of substreams that stay
below the threshold)`.
فهارس النص الكامل غير مدعومة بهذا الإعداد ولا يتم packing لها مطلقًا.
يقلّل packing الضغط على inode عند تعريف عدد كبير من فهارس التخطّي على table (على سبيل المثال
باستخدام `add_minmax_index_for_numeric_columns`).
إن format على disk ذاتي الوصف: يكتشف القارئون `skp_idx.packed` ويقدّمون
substreams المجمّعة من داخله بشفافية. يؤثر تغيير هذا الإعداد في parts المكتوبة حديثًا
فقط؛ أما parts الموجودة فتحتفظ بالتخطيط الذي كانت عليه وقت الكتابة.
قيد معروف: يُبلّغ كل من `system.data_skipping_indices.data_uncompressed_bytes` و
`system.parts.secondary_indices_uncompressed_bytes` عن الحجم compressed لـ substreams المجمّعة
(إذ لا يخزّن فهرس الأرشيف أحجامها غير المضغوطة). وهذا تجميلي في
Monitoring مع نتيجة functional واحدة:
يقارن `distributed_index_analysis_min_indexes_bytes_to_activate` مع
`data_uncompressed`، لذا قد لا يتجاوز فهرس مجمّع ينضغط جيدًا (`set` أو `bloom_filter` على
Strings) حدّ التفعيل حتى لو كان الحجم الحقيقي غير المضغوط سيتجاوزه.
ويكون fallback هو query plan العادية، وليس نتيجة خاطئة.
## part\_minmax\_index\_columns
يحدّد الأعمدة التي يشملها فهرس min-max لكل جزء. وتُفعِّل كل قيمة مجموعة إضافية من الأعمدة فوق المجموعة التي تسبقها.
القيم الممكنة:
* `partition_key_only` — لا تُتتبَّع إلا أعمدة مفتاح التقسيم.
* `with_block_number_offset` — أعمدة مفتاح التقسيم بالإضافة إلى العمودين الافتراضيين المحفوظين `_block_number` و`_block_offset`. يتيح ذلك استبعاد الأجزاء على مستوى الجزء باستخدام هذين العمودين.
## part\_moves\_between\_shards\_delay\_seconds
المدة التي يجب انتظارها قبل/بعد نقل الأجزاء بين الشظايا.
## part\_moves\_between\_shards\_enable
ميزة تجريبية/غير مكتملة لنقل الأجزاء بين الشظايا. لا تأخذ
تعبيرات التشظية في الحسبان.
## parts\_to\_delay\_insert
إذا تجاوز عدد الأجزاء النشطة في قسم واحد
القيمة `parts_to_delay_insert`، فسيتم إبطاء `INSERT` بشكل مصطنع.
القيم الممكنة:
* أي عدد صحيح موجب.
يُطيل ClickHouse تنفيذ `INSERT` بشكل مصطنع (بإضافة 'sleep') حتى تتمكن
عملية الدمج في الخلفية من دمج الأجزاء بسرعة تفوق سرعة إضافتها.
## parts\_to\_throw\_insert
إذا تجاوز عدد الأجزاء النشطة في تقسيم واحد
القيمة `parts_to_throw_insert`، تتم مقاطعة `INSERT` مع الاستثناء `Too many
parts (N). Merges are processing significantly slower than inserts`.
القيم الممكنة:
* أي عدد صحيح موجب.
لتحقيق أقصى أداء لاستعلامات `SELECT`، من الضروري
تقليل عدد الأجزاء التي تتم معالجتها إلى الحد الأدنى، راجع [Merge Tree](/ar/resources/develop-contribute/introduction/architecture#merge-tree).
قبل الإصدار 23.6، كان هذا الإعداد مضبوطًا على 300. يمكنك تعيين قيمة
أعلى، مما سيقلل احتمال حدوث الخطأ `Too many parts`،
لكن في الوقت نفسه قد يتراجع أداء `SELECT`. كذلك، في حال
وجود مشكلة في الدمج (على سبيل المثال، بسبب عدم كفاية مساحة القرص) فستلاحظها
في وقت متأخر مقارنةً بما كنت ستلاحظه عند استخدام القيمة الأصلية 300.
## prefer\_fetch\_merged\_part\_size\_threshold
إذا تجاوز مجموع أحجام الأجزاء هذه العتبة، وكان الوقت المنقضي منذ إنشاء إدخال في سجل النسخ المتماثل أكبر من
`prefer_fetch_merged_part_time_threshold`، فسيُفضَّل جلب الجزء المدمج
من نسخة متماثلة بدلًا من إجراء الدمج محليًا. يهدف ذلك إلى تسريع
عمليات الدمج الطويلة جدًا.
القيم الممكنة:
* أي عدد صحيح موجب.
## prefer\_fetch\_merged\_part\_time\_threshold
إذا تجاوز الوقت المنقضي منذ إنشاء إدخال في سجل النسخ المتماثل (ClickHouse Keeper أو ZooKeeper)
هذه العتبة، وكان مجموع أحجام الأجزاء
أكبر من `prefer_fetch_merged_part_size_threshold`، فسيُفضَّل جلب
جزء مدمج من نسخة متماثلة بدلًا من إجراء الدمج محليًا. يهدف ذلك إلى تسريع
عمليات الدمج الطويلة جدًا.
القيم الممكنة:
* أي عدد صحيح موجب.
## prewarm\_mark\_cache
إذا كانت القيمة true، فسيتم
التسخين المسبق لذاكرة التخزين المؤقت للعلامات عبر حفظ العلامات فيها عند عمليات الإدراج والدمج والجلب، وعند
بدء تشغيل الخادم
## prewarm\_primary\_key\_cache
إذا كانت القيمة true، فستتم تهيئة ذاكرة التخزين المؤقت للفهرس الأساسي مسبقًا
بحفظ العلامات في ذاكرة التخزين المؤقت للعلامات عند عمليات الإدراج والدمج
والجلب وعند بدء تشغيل الخادم
## primary\_key\_compress\_block\_size
حجم كتلة الضغط للمفتاح الأساسي؛ أي الحجم الفعلي للكتلة التي ستُضغط.
## primary\_key\_compression\_codec
ترميز الضغط المستخدم للمفتاح الأساسي. ونظرًا إلى أن المفتاح الأساسي صغير بما يكفي ويكون مخزّنًا مؤقتًا،
فإن الضغط الافتراضي هو ZSTD(3).
## primary\_key\_lazy\_load
حمّل المفتاح الأساسي في الذاكرة عند
أول استخدام بدلًا من تحميله عند تهيئة الجدول. يمكن أن يوفّر ذلك الذاكرة
عند وجود عدد كبير من الجداول.
## primary\_key\_ratio\_of\_unique\_prefix\_values\_to\_skip\_suffix\_columns
إذا تغيّرت قيمة أحد أعمدة المفتاح الأساسي في جزء البيانات بهذه النسبة من المرات على الأقل، فتخطَّ تحميل الأعمدة التالية في الذاكرة. يتيح ذلك تقليل استهلاك الذاكرة عبر عدم تحميل الأعمدة غير المفيدة من المفتاح الأساسي.
## propagate\_types\_serialization\_versions\_to\_nested\_types
إذا كانت القيمة true، فسيتم تمرير إصدارات التسلسل مثل string\_serialization\_version إلى داخل الأنواع المتداخلة مثل Array/Map/Nullable/JSON/etc. وإذا كان هذا الخيار معطّلًا، فسيقتصر تأثير إصدار التسلسل على الأعمدة ذات المستوى الأعلى من هذا النوع وTuple el
## ratio\_of\_defaults\_for\_sparse\_serialization
الحد الأدنى لنسبة عدد القيم *الافتراضية* إلى عدد *جميع* القيم
في عمود. يؤدي ضبط هذه القيمة إلى تخزين العمود باستخدام
التسلسل المتناثر.
إذا كان العمود متناثرًا (أي يحتوي في معظمه على أصفار)، يمكن لـ ClickHouse ترميزه
بتنسيق متناثر وتحسين العمليات الحسابية تلقائيًا، إذ لا تتطلب البيانات
فك الضغط الكامل أثناء الاستعلامات. لتمكين هذا
التسلسل المتناثر، عيّن الإعداد `ratio_of_defaults_for_sparse_serialization`
ليكون أقل من 1.0. وإذا كانت القيمة أكبر من أو تساوي 1.0،
فستُكتب الأعمدة دائمًا باستخدام التسلسل الكامل العادي.
القيم الممكنة:
* قيمة `Float` بين `0` و `1` لتمكين التسلسل المتناثر
* `1.0` (أو أكبر) إذا كنت لا تريد استخدام التسلسل المتناثر
**مثال**
لاحظ أن العمود `s` في الجدول التالي يكون سلسلة فارغة في 95% من
الصفوف. في `my_regular_table` لا نستخدم التسلسل المتناثر، وفي
`my_sparse_table` نعيّن `ratio_of_defaults_for_sparse_serialization` إلى
0.95:
```sql theme={null}
CREATE TABLE my_regular_table
(
`id` UInt64,
`s` String
)
ENGINE = MergeTree
ORDER BY id;
INSERT INTO my_regular_table
SELECT
number AS id,
number % 20 = 0 ? toString(number): '' AS s
FROM
numbers(10000000);
CREATE TABLE my_sparse_table
(
`id` UInt64,
`s` String
)
ENGINE = MergeTree
ORDER BY id
SETTINGS ratio_of_defaults_for_sparse_serialization = 0.95;
INSERT INTO my_sparse_table
SELECT
number,
number % 20 = 0 ? toString(number): ''
FROM
numbers(10000000);
```
لاحظ أن العمود `s` في `my_sparse_table` يشغل مساحة تخزين أقل على القرص:
```sql theme={null}
SELECT table, name, data_compressed_bytes, data_uncompressed_bytes FROM system.columns
WHERE table LIKE 'my_%_table';
```
```response theme={null}
┌─table────────────┬─name─┬─data_compressed_bytes─┬─data_uncompressed_bytes─┐
│ my_regular_table │ id │ 37790741 │ 75488328 │
│ my_regular_table │ s │ 2451377 │ 12683106 │
│ my_sparse_table │ id │ 37790741 │ 75488328 │
│ my_sparse_table │ s │ 2283454 │ 9855751 │
└──────────────────┴──────┴───────────────────────┴─────────────────────────┘
```
يمكنك التحقق مما إذا كان عمود ما يستخدم الترميز المتناثر من خلال عرض
العمود `serialization_kind` في جدول `system.parts_columns`:
```sql theme={null}
SELECT column, serialization_kind FROM system.parts_columns
WHERE table LIKE 'my_sparse_table';
```
يمكنك معرفة أي أجزاء `s` جرى تخزينها باستخدام التسلسل المتناثر:
```response theme={null}
┌─column─┬─serialization_kind─┐
│ id │ Default │
│ s │ Default │
│ id │ Default │
│ s │ Default │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
│ id │ Default │
│ s │ Sparse │
└────────┴────────────────────┘
```
## reduce\_blocking\_parts\_sleep\_ms
متاح فقط في ClickHouse Cloud. الحد الأدنى للوقت الذي يجب انتظاره قبل محاولة
تقليل الأجزاء المُعيقة مرة أخرى إذا لم يتم إسقاط/استبدال أي ranges. سيؤدي
تعيين قيمة أقل إلى تشغيل المهام في background\_schedule\_pool بشكل متكرر، مما
ينتج عنه عدد كبير من الطلبات إلى ZooKeeper في العناقيد واسعة النطاق
## refresh\_parts\_interval
إذا كانت القيمة أكبر من صفر، فستُحدَّث قائمة أجزاء البيانات من نظام الملفات الأساسي للتحقق مما إذا كانت البيانات قد حُدِّثت في الخلفية.
لا يمكن تعيينه إلا إذا كان الجدول موجودًا على أقراص للقراءة فقط (ما يعني أن هذه نسخة متماثلة للقراءة فقط، بينما تُكتب البيانات بواسطة نسخة متماثلة أخرى).
## refresh\_statistics\_interval
الفاصل الزمني لتحديث ذاكرة التخزين المؤقت للإحصاءات، بالثواني. إذا ضُبط على صفر، فسيُعطَّل التحديث.
## remote\_fs\_execute\_merges\_on\_single\_replica\_time\_threshold
عندما تكون قيمة هذا الإعداد أكبر من الصفر، تبدأ نسخة متماثلة واحدة فقط
عملية الدمج فورًا إذا كان الجزء المدمج موجودًا على وحدة التخزين المشتركة.
النسخ المتماثل zero-copy غير جاهز بعد للاستخدام في بيئة الإنتاج.
يكون النسخ المتماثل zero-copy معطّلًا افتراضيًا في ClickHouse الإصدار 22.8
والإصدارات الأحدث.
لا يُنصح باستخدام هذه الميزة في بيئة الإنتاج.
القيم الممكنة:
* أي عدد صحيح موجب.
## remote\_fs\_zero\_copy\_path\_compatible\_mode
يشغّل zero-copy في وضع التوافق أثناء عملية التحويل.
## remote\_fs\_zero\_copy\_zookeeper\_path
مسار ZooKeeper للمعلومات المستقلة عن الجدول الخاصة بـ zero-copy.
## remove\_empty\_parts
أزل الأجزاء الفارغة بعد تشذيبها بواسطة TTL أو mutation أو خوارزمية الدمج collapsing.
## remove\_rolled\_back\_parts\_immediately
إعداد لميزة تجريبية لم تكتمل بعد.
## remove\_unused\_patch\_parts
إزالة أجزاء التصحيح في الخلفية بعد تطبيقها على جميع الأجزاء النشطة.
## replace\_long\_file\_name\_to\_hash
إذا كان اسم ملف العمود طويلًا جدًا (أكثر من 'max\_file\_name\_length'
بايت)، فاستبدله بـ SipHash128
## replicated\_can\_become\_leader
إذا كانت القيمة `true`، فستحاول النسخ المتماثلة للجداول المتماثلة على هذه العقدة تولّي دور القائد.
القيم الممكنة:
* `true`
* `false`
## replicated\_deduplication\_window
عدد أحدث الكتل المُدرجة التي يخزّن ClickHouse Keeper لها قيم التجزئة للتحقق من التكرارات.
القيم الممكنة:
* أي عدد صحيح موجب.
* 0 (تعطيل إزالة التكرار)
ينشئ الأمر `Insert` كتلة واحدة أو أكثر (أجزاء). بالنسبة إلى [insert deduplication](/ar/reference/engines/table-engines/mergetree-family/replication)، عند الكتابة إلى الجداول المتماثلة، يكتب ClickHouse قيم التجزئة الخاصة بالأجزاء المُنشأة إلى ClickHouse Keeper. ولا تُخزَّن قيم التجزئة إلا لأحدث `replicated_deduplication_window` من الكتل. وتُزال أقدم قيم التجزئة من ClickHouse Keeper.
إن تعيين قيمة كبيرة لـ `replicated_deduplication_window` يبطّئ عمليات `Inserts` لأن عددًا أكبر من الإدخالات يحتاج إلى المقارنة. وتُحسَب قيمة التجزئة من تكوين أسماء الحقول وأنواعها وبيانات الجزء المُدرج (تدفّق من البايتات).
## replicated\_deduplication\_window\_for\_async\_inserts
عدد الكتل المُدرجة مؤخرًا باستخدام async insert التي يخزّن ClickHouse Keeper
قيمة التجزئة الخاصة بها للتحقق من التكرارات.
Possible values:
* أي عدد صحيح موجب.
* 0 (تعطيل إزالة التكرار لـ async\_inserts)
سيتم تخزين أمر [Async Insert](/ar/reference/settings/session-settings#async_insert)
مؤقتًا في كتلة واحدة أو أكثر (parts). ولأغراض [insert إزالة التكرار](/ar/reference/engines/table-engines/mergetree-family/replication)،
عند الكتابة إلى جداول متماثلة، يكتب ClickHouse قيم قيمة التجزئة لكل
insert في ClickHouse Keeper. ولا تُخزَّن قيم قيمة التجزئة إلا لأحدث
`replicated_deduplication_window_for_async_inserts` من الكتل. وتُزال أقدم قيم قيمة التجزئة
sums من ClickHouse Keeper.
إن زيادة قيمة `replicated_deduplication_window_for_async_inserts` تؤدي إلى إبطاء
`Async Inserts` لأنها تتطلب مقارنة عدد أكبر من entries.
ويُحتسب قيمة التجزئة استنادًا إلى تكوين أسماء الحقول وأنواعها
وبيانات الـ insert (stream من bytes).
## replicated\_deduplication\_window\_seconds
عدد الثواني التي بعد انقضائها تُزال قيم التجزئة الخاصة بالكتل المُدخلة
من ClickHouse Keeper.
القيم الممكنة:
* أي عدد صحيح موجب.
على غرار [replicated\_إزالة التكرار\_window](#replicated_deduplication_window)،
يحدّد `replicated_deduplication_window_seconds` مدة الاحتفاظ بقيم التجزئة
للكتل لأغراض insert إزالة التكرار. وتُزال قيم التجزئة الأقدم من
`replicated_deduplication_window_seconds` من ClickHouse Keeper،
حتى إذا كانت أقل من ` replicated_deduplication_window`.
يُحتسب الوقت نسبةً إلى وقت أحدث سجل، وليس إلى
الوقت الفعلي. وإذا كان هذا هو السجل الوحيد، فسيُحفَظ إلى الأبد.
## replicated\_deduplication\_window\_seconds\_for\_async\_inserts
عدد الثواني التي تُزال بعدها قيم التجزئة الخاصة بعمليات async inserts من
ClickHouse Keeper.
القيم الممكنة:
* أي عدد صحيح موجب.
على غرار [replicated\_إزالة التكرار\_window\_for\_async\_inserts](#replicated_deduplication_window_for_async_inserts)،
يحدّد `replicated_deduplication_window_seconds_for_async_inserts` مدة
الاحتفاظ بقيم التجزئة الخاصة بالكتل من أجل insert إزالة التكرار في async inserts. وتُزال قيم التجزئة
الأقدم من `replicated_deduplication_window_seconds_for_async_inserts` من
ClickHouse Keeper، حتى إذا كانت أقل من
`replicated_deduplication_window_for_async_inserts`.
يُحتسب الوقت هنا نسبةً إلى وقت أحدث سجل، وليس إلى الوقت الفعلي.
وإذا كان هذا هو السجل الوحيد، فسيُخزَّن إلى الأبد.
## replicated\_fetches\_http\_connection\_timeout
إعداد متقادم، ليس له أي تأثير.
## replicated\_fetches\_http\_receive\_timeout
إعداد متقادم، ليس له أي تأثير.
## replicated\_fetches\_http\_send\_timeout
إعداد مهمل، ولا تأثير له.
## replicated\_fetches\_min\_part\_level
الحد الأدنى لمستوى الجزء الذي سيتم جلبه من النسخ المتماثلة الأخرى. تُؤجَّل الأجزاء التي يكون مستواها أقل من هذه العتبة
(تظل في قائمة انتظار النسخ المتماثل ويُعاد تقييمها في كل دورة جدولة، ولا تُتجاهَل نهائيًا).
استخدم القيمة 1 لتأجيل جلب الأجزاء من المستوى 0 (غير المدمجة)، مما يقلل العبء الإضافي للنسخ المتماثل أثناء الإدخال المكثف للبيانات.
القيمة الافتراضية: 0 (جلب جميع الأجزاء بغض النظر عن المستوى).
## replicated\_fetches\_min\_part\_level\_timeout\_seconds
المهلة، بالثواني، التي بعدها سيتم جلب أي جزء يقع دون replicated\_fetches\_min\_part\_level على أي حال.
استخدم 0 لتعطيل المهلة (تُؤجَّل الأجزاء التي تقع دون الحد الأدنى للمستوى إلى أجل غير مسمى حتى يتم دمجها).
الافتراضي: 300 (فرض الجلب بعد 5 دقائق).
## replicated\_max\_mutations\_in\_one\_entry
الحد الأقصى لعدد أوامر mutation التي يمكن دمجها معًا وتنفيذها ضمن
إدخال MUTATE\_PART واحد (0 تعني بلا حد أقصى)
## replicated\_max\_parallel\_fetches
إعداد متقادم، ليس له أي تأثير.
## replicated\_max\_parallel\_fetches\_for\_host
إعداد قديم لم يعد له أي تأثير.
## replicated\_max\_parallel\_fetches\_for\_table
إعداد متقادم، لا تأثير له.
## replicated\_max\_parallel\_sends
إعداد متقادم، وليس له أي تأثير.
## replicated\_max\_parallel\_sends\_for\_table
إعداد متقادم، بلا تأثير.
## replicated\_max\_ratio\_of\_wrong\_parts
إذا كانت نسبة الأجزاء غير الصحيحة إلى إجمالي عدد الأجزاء أقل من هذه القيمة،
فيُسمح بالتشغيل.
القيم الممكنة:
* Float، 0.0 - 1.0
## search\_orphaned\_parts\_disks
يفحص ClickHouse جميع الأقراص بحثًا عن الأجزاء اليتيمة عند أي ATTACH أو CREATE لجدول،
وذلك حتى لا تفوته أجزاء البيانات الموجودة على أقراص غير معرّفة (غير مشمولة في سياسة التخزين).
قد تنشأ الأجزاء اليتيمة بسبب إعادة تهيئة التخزين غير الآمنة، على سبيل المثال إذا جرى استبعاد قرص من سياسة التخزين.
يحدّد هذا الإعداد نطاق الأقراص التي سيجري البحث فيها وفقًا لخصائص الأقراص.
القيم الممكنة:
* any - النطاق غير مقيّد.
* local - يقتصر النطاق على الأقراص المحلية.
* none - نطاق فارغ، لا تُجرِ بحثًا
## serialization\_info\_version
إصدار معلومات التسلسل المستخدم عند كتابة `serialization.json`.
هذا الإعداد مطلوب لضمان التوافق أثناء ترقيات العنقود.
القيم الممكنة:
* `basic` - تنسيق أساسي.
* `with_types` - تنسيق يتضمن الحقل الإضافي `types_serialization_versions`، مما يتيح إصدارات تسلسل لكل نوع.
وهذا يجعل إعدادات مثل `string_serialization_version` سارية المفعول.
أثناء الترقيات المتدرجة، اضبط هذا على `basic` لكي تُنتج الخوادم الجديدة
أجزاء بيانات متوافقة مع الخوادم القديمة. بعد اكتمال الترقية،
بدّل إلى `WITH_TYPES` لتمكين إصدارات التسلسل لكل نوع.
## share\_nested\_offsets
عند التفعيل (وهو الوضع الافتراضي)، تُعامَل أعمدة Array ذات الأسماء المنقطة التي تشترك في بادئة واحدة (مثل `n.a` و `n.b`)
على أنها جزء من بنية Nested: إذ تشترك في ملف إزاحات واحد على القرص (مثل `n.size0`)،
ويُتحقَّق من تساوي أحجام المصفوفات فيها أثناء `INSERT`.
وعند التعطيل، يحصل كل عمود Array على ملف إزاحات مستقل، ولا تعود الأسماء المنقطة تحمل أي
دلالات خاصة، كما يمكن أن يتعايش عمود قياسي مع أعمدة Array منقطة تشترك في البادئة نفسها
(مثل `n UInt32` إلى جانب `n.a Array(String)`). هذا الإعداد غير قابل للتغيير بعد إنشاء الجدول.
## shared\_merge\_tree\_activate\_coordinated\_merges\_tasks
يُفعّل إعادة جدولة مهام الدمج المنسّق. وقد يكون ذلك مفيدًا حتى عندما
shared\_merge\_tree\_enable\_coordinated\_merges=0، لأن هذا سيُعبّئ إحصاءات منسّق الدمج
ويساعد في حالات التشغيل البارد.
## shared\_merge\_tree\_create\_per\_replica\_metadata\_nodes
يُمكّن من إنشاء العُقدتَين /metadata و /columns لكل نسخة متماثلة في ZooKeeper.
متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_disable\_merges\_and\_mutations\_assignment
إيقاف تعيين عمليات الدمج وتعديلات في shared merge tree. متاح فقط في ClickHouse
Cloud
## shared\_merge\_tree\_empty\_partition\_lifetime
عدد الثواني التي سيتم خلالها الاحتفاظ بالتقسيم في Keeper إذا لم تكن له أي أجزاء.
## shared\_merge\_tree\_enable\_automatic\_empty\_partitions\_cleanup
يُمكّن تنظيف إدخالات Keeper الخاصة بالقسم الفارغ.
## shared\_merge\_tree\_enable\_coordinated\_merges
يُمكّن استخدام استراتيجية الدمج المنسّق
يمكّن كتابة السمات في الأجزاء الافتراضية وتثبيت الكتل في Keeper
## shared\_merge\_tree\_enable\_outdated\_parts\_check
يُفعّل التحقق من الأجزاء القديمة. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_idle\_parts\_update\_seconds
الفاصل الزمني بالثواني لتحديث الأجزاء من دون أن يتم تحفيزه بواسطة watch في ZooKeeper
ضمن shared merge tree. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_initial\_parts\_update\_backoff\_ms
التراجع التدريجي الأولي لتحديث الأجزاء. متوفر فقط في ClickHouse Cloud
## shared\_merge\_tree\_interserver\_http\_connection\_timeout\_ms
مهلات اتصال HTTP بين الخوادم. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_interserver\_http\_timeout\_ms
مهلات اتصال HTTP بين الخوادم. متاح فقط في ClickHouse
Cloud
## shared\_merge\_tree\_leader\_update\_period\_random\_add\_seconds
أضف قيمة موزعة توزيعًا منتظمًا من 0 إلى x ثانية إلى
shared\_merge\_tree\_leader\_update\_period لتجنّب ظاهرة
اندفاع القطيع. هذا الإعداد متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_leader\_update\_period\_seconds
الحد الأقصى للفترة لإعادة التحقق من القائد المسؤول عن تحديث الأجزاء. متاح فقط في
ClickHouse Cloud
## shared\_merge\_tree\_max\_outdated\_parts\_to\_process\_at\_once
الحد الأقصى لعدد الأجزاء القديمة التي ستحاول العقدة القائدة تأكيد إزالتها
ضمن طلب HTTP واحد. هذا الإعداد متاح فقط في ClickHouse Cloud.
## shared\_merge\_tree\_max\_parts\_update\_backoff\_ms
الحد الأقصى لفترة التراجع التدريجي عند تحديث الأجزاء. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_max\_parts\_update\_leaders\_in\_total
الحد الأقصى لعدد القادة المسؤولين عن تحديث الأجزاء. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_max\_parts\_update\_leaders\_per\_az
الحد الأقصى لعدد قادة تحديث الأجزاء. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_max\_replicas\_for\_parts\_deletion
الحد الأقصى لعدد النسخ المتماثلة التي ستشارك في حذف الأجزاء (killer thread). يتوفر فقط في ClickHouse Cloud
## shared\_merge\_tree\_max\_replicas\_to\_merge\_parts\_for\_each\_parts\_range
الحد الأقصى لعدد النُسخ المتماثلة التي ستحاول إسناد عمليات دمج يُحتمل أن تكون متعارضة
(مما يساعد على تجنب التعارضات غير الضرورية في إسناد عمليات الدمج). تعني القيمة 0 أن هذه الميزة معطّلة. وهي
متاحة فقط في ClickHouse Cloud
## shared\_merge\_tree\_max\_suspicious\_broken\_parts
الحد الأقصى للأجزاء التالفة في SMT، وإذا تجاوز العدد ذلك، يُمنع الـ detach التلقائي.
## shared\_merge\_tree\_max\_suspicious\_broken\_parts\_bytes
الحد الأقصى لإجمالي حجم جميع الأجزاء التالفة في SMT، وإذا تجاوز هذا الحد، يُمنع detach التلقائي.
## shared\_merge\_tree\_memo\_ids\_remove\_timeout\_seconds
المدة التي نحتفظ خلالها بمعرّفات memoization الخاصة بعمليات `insert` لتجنّب تنفيذ إجراءات غير صحيحة أثناء
إعادة محاولة `insert`. هذا متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_merge\_coordinator\_election\_check\_period\_ms
الفاصل الزمني بين عمليات تشغيل مؤشر ترابط انتخاب منسّق الدمج
## shared\_merge\_tree\_merge\_coordinator\_factor
معامل تغيير مدة تأخير مؤشر ترابط المنسق
## shared\_merge\_tree\_merge\_coordinator\_fetch\_fresh\_metadata\_period\_ms
الفترة التي يجب أن يزامن فيها منسّق الدمج مع ZooKeeper لجلب بيانات وصفية حديثة
## shared\_merge\_tree\_merge\_coordinator\_max\_merge\_request\_size
عدد عمليات الدمج التي يمكن أن يطلبها المنسّق من MergerMutator دفعة واحدة
## shared\_merge\_tree\_merge\_coordinator\_max\_period\_ms
الحد الأقصى للمدة الفاصلة بين مرات تشغيل مؤشر ترابط منسّق الدمج
## shared\_merge\_tree\_merge\_coordinator\_merges\_prepare\_count
عدد إدخالات الدمج التي ينبغي أن يُعِدّها منسق ويوزعها على workers.
عند ضبطه على 'auto'، يساوي الحد الأقصى لعدد مهام الدمج المسموح بها على replica واحدة مضروبًا في عدد replicas النشطة.
## shared\_merge\_tree\_merge\_coordinator\_min\_period\_ms
الحد الأدنى للفاصل الزمني بين مرات تشغيل خيط منسّق الدمج
## shared\_merge\_tree\_merge\_worker\_fast\_timeout\_ms
المهلة التي سيستخدمها مؤشر ترابط عامل الدمج إذا استلزم الأمر تحديث حالته بعد إجراء فوري
## shared\_merge\_tree\_merge\_worker\_regular\_timeout\_ms
الفاصل الزمني بين مرات تشغيل مؤشر ترابط عامل الدمج
## shared\_merge\_tree\_outdated\_parts\_group\_size
كم عدد النسخ المتماثلة التي ستكون ضمن مجموعة تجزئة rendezvous نفسها لتنظيف الأجزاء القديمة.
متاح فقط في ClickHouse Cloud.
## shared\_merge\_tree\_partitions\_hint\_ratio\_to\_reload\_merge\_pred\_for\_mutations
سيُعاد تحميل شرط الدمج في مهمة اختيار الدمج/التعديلات عندما تكون نسبة `/` أكبر من قيمة هذا الإعداد. يتوفر هذا فقط
في ClickHouse Cloud
## shared\_merge\_tree\_parts\_load\_batch\_size
عدد وظائف جلب البيانات الوصفية للأجزاء التي تُجدوَل دفعةً واحدة. متاح فقط في
ClickHouse Cloud
## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_ms
المدة الزمنية للاحتفاظ بجزء مدموج محليًا دون بدء عملية دمج جديدة تتضمن
هذا الجزء. يتيح ذلك للنسخ المتماثلة الأخرى فرصة جلب هذا الجزء وبدء عملية الدمج هذه.
متاح فقط في ClickHouse Cloud.
## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_rows\_threshold
الحد الأدنى لحجم الجزء (بعدد الصفوف) الذي يؤجَّل عنده إسناد عملية الدمج التالية مباشرةً بعد
دمجه محليًا. متاح فقط في ClickHouse Cloud.
## shared\_merge\_tree\_range\_for\_merge\_window\_size
المدة الزمنية للاحتفاظ بجزء تم دمجه محليًا قبل بدء عملية دمج جديدة تتضمن
هذا الجزء. يمنح ذلك النسخ المتماثلة الأخرى فرصة لجلب الجزء وبدء عملية الدمج هذه.
متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_read\_virtual\_parts\_from\_leader
اقرأ الأجزاء الافتراضية من القائد متى أمكن. هذا الإعداد متاح فقط في ClickHouse
Cloud
## shared\_merge\_tree\_replica\_set\_max\_lifetime\_seconds
عدد مرات محاولة النسخ المتماثلة تحديث مجموعة النسخ المتماثلة في الخلفية. يُضاف انحراف عشوائي إلى وقت التشغيل التالي
بتوزيع منتظم ضمن \[0, value] ثانية. الاستثناء: القيمة = 0 لا تتبع هذه القاعدة؛
إذ يطبّق التنفيذ حدًا أدنى مقداره 200 مللي ثانية، لذلك يُضاف انحراف عشوائي إلى وقت التشغيل التالي ضمن \[0, 200] مللي ثانية.
## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas
إذا كان هذا الإعداد مفعّلًا، فستحاول جميع النسخ المتماثلة جلب بيانات الجزء الموجودة في الذاكرة (مثل المفتاح الأساسي ومعلومات القسم وما إلى ذلك) من النسخ المتماثلة الأخرى التي تتوفر فيها هذه البيانات بالفعل.
## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas\_on\_startup
إذا كان هذا الإعداد مُمكّنًا، فستحاول جميع النسخ المتماثلة عند بدء التشغيل جلب بيانات الأجزاء في الذاكرة (مثل المفتاح
الأساسي، ومعلومات القسم، وما إلى ذلك) من نسخ متماثلة أخرى تتوفر لديها هذه البيانات بالفعل.
## shared\_merge\_tree\_update\_replica\_flags\_delay\_ms
الفاصل الزمني الذي تحاول عنده النسخة المتماثلة إعادة تحميل علاماتها وفقًا للجدولة في الخلفية.
## shared\_merge\_tree\_use\_metadata\_hints\_cache
يُمكّن من طلب تلميحات ذاكرة التخزين المؤقت لنظام الملفات من
ذاكرة التخزين المؤقت الموجودة في الذاكرة
على النسخ المتماثلة الأخرى. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_use\_outdated\_parts\_compact\_format
استخدم التنسيق المضغوط للأجزاء القديمة: فهو يقلل الحمل على Keeper، ويحسّن
معالجة الأجزاء القديمة. متاح فقط في ClickHouse Cloud
## shared\_merge\_tree\_use\_too\_many\_parts\_count\_from\_virtual\_parts
إذا كان مُمكّنًا، فسيعتمد عدّاد Too many parts على البيانات المشتركة في Keeper، لا على حالة النسخة المتماثلة المحلية. يتوفر هذا فقط في ClickHouse Cloud
## shared\_merge\_tree\_use\_zookeeper\_connection\_pool
إذا كان مُمكّنًا، يستخدم SharedMergeTree إحدى جلسات ZooKeeper المجمّعة على مستوى الخادم.
## shared\_merge\_tree\_virtual\_parts\_discovery\_batch
عدد عمليات اكتشاف الأقسام المطلوب تجميعها في دفعة واحدة
## simultaneous\_parts\_removal\_limit
إذا كان هناك عدد كبير من الأجزاء القديمة، فسيحاول مؤشر ترابط التنظيف حذف ما يصل إلى
`simultaneous_parts_removal_limit` من الأجزاء خلال تكرار واحد.
يعني تعيين `simultaneous_parts_removal_limit` إلى `0` أنه غير محدود.
## sleep\_before\_commit\_local\_part\_in\_replicated\_table\_ms
لأغراض الاختبار. لا تغيّره.
## sleep\_before\_loading\_outdated\_parts\_ms
مخصّص للاختبار. لا تغيّره.
## storage\_policy
اسم سياسة قرص التخزين
## string\_serialization\_version
يتحكم هذا الإعداد في تنسيق التسلسل لأعمدة `String` ذات المستوى الأعلى.
لا يسري مفعول هذا الإعداد إلا عندما تكون قيمة `serialization_info_version` مضبوطة على "with\_types".
وعند ضبطه على `with_size_stream`، تُسلسَل أعمدة `String` ذات المستوى الأعلى باستخدام
عمود فرعي منفصل باسم `.size` لتخزين أطوال السلاسل النصية، بدلًا من تضمينها ضمنيًا. يتيح ذلك استخدام أعمدة فرعية
حقيقية باسم `.size`، ويمكن أن يحسّن كفاءة الضغط.
أنواع `String` المتداخلة (مثلًا داخل `Nullable` أو `LowCardinality` أو `Array` أو `Map`)
لا تتأثر، إلا إذا ظهرت داخل `Tuple`.
القيم الممكنة:
* `single_stream` — استخدم تنسيق التسلسل القياسي مع أحجام مضمنة.
* `with_size_stream` — استخدم تدفق أحجام منفصلًا لأعمدة `String` ذات المستوى الأعلى.
## table\_disk
هذا قرص الجدول؛ ويجب أن يشير المسار/نقطة النهاية إلى بيانات الجدول، لا إلى
بيانات قاعدة البيانات. ولا يمكن تعيينه إلا لـ s3\_plain/s3\_plain\_rewritable/web.
## table\_readonly
إذا تم تعيينه على true، فسيكون الجدول في وضع القراءة فقط. وستفشل أي محاولات لإدراج البيانات أو تعديل الجدول.
## temporary\_directories\_lifetime
عدد الثواني التي يتم خلالها الاحتفاظ بأدلة tmp\_. لا ينبغي خفض هذه القيمة
لأن عمليات الدمج والتعديلات قد لا تتمكن من العمل إذا كانت قيمة هذا
الإعداد منخفضة.
## text\_index\_dictionary\_block\_frontcoding\_compression
ضغط front-coding الافتراضي لكتل قاموس الفهرس النصي.
يمكن تجاوز هذا الإعداد باستخدام وسيطة الفهرس الصريحة `dictionary_block_frontcoding_compression`.
## text\_index\_dictionary\_block\_size
حجم كتلة القاموس الافتراضي للفهارس النصية.
يمكن تجاوز هذه القيمة باستخدام وسيطة الفهرس الصريحة `dictionary_block_size`.
## text\_index\_posting\_list\_block\_size
حجم الكتلة الافتراضي لقائمة الترحيل في فهارس النص (بالصفوف).
يمكن تجاوز هذه القيمة باستخدام وسيطة الفهرس الصريحة `posting_list_block_size`.
## text\_index\_posting\_list\_codec
برنامج الترميز الافتراضي لقائمة الترحيلات في الفهارس النصية.
يمكن تجاوزه باستخدام وسيطة الفهرس الصريحة `posting_list_codec`.
## try\_fetch\_recompressed\_part\_timeout
مهلة الانتظار (بالثواني) قبل بدء الدمج مع إعادة الضغط. خلال هذه
المدة، يحاول ClickHouse جلب الجزء المُعاد ضغطه من النسخة المتماثلة التي أُسنِد
إليها هذا الدمج مع إعادة الضغط.
تكون إعادة الضغط بطيئة في معظم الحالات، لذلك لا نبدأ الدمج مع
إعادة الضغط إلا بعد انقضاء هذه المهلة، مع محاولة جلب الجزء المُعاد ضغطه من
النسخة المتماثلة التي أُسنِد إليها هذا الدمج مع إعادة الضغط.
القيم الممكنة:
* أي عدد صحيح موجب.
## ttl\_only\_drop\_parts
يتحكم هذا الإعداد في ما إذا كانت data parts تُحذف بالكامل في جداول MergeTree عندما
تكون جميع الصفوف في ذلك الجزء قد انتهت صلاحيتها وفقًا لإعدادات `TTL` الخاصة بها.
عندما يكون `ttl_only_drop_parts` معطّلًا (وهو الوضع الافتراضي)، لا تُحذف إلا الصفوف التي
انتهت صلاحيتها استنادًا إلى إعدادات `TTL` الخاصة بها.
عندما يكون `ttl_only_drop_parts` مفعّلًا، يُحذف الجزء بالكامل إذا كانت جميع
الصفوف في ذلك الجزء قد انتهت صلاحيتها وفقًا لإعدادات `TTL` الخاصة بها.
## use\_adaptive\_write\_buffer\_for\_dynamic\_subcolumns
يتيح استخدام مخازن الكتابة المؤقتة التكيفية عند كتابة الأعمدة الفرعية الديناميكية
لتقليل استهلاك الذاكرة
## use\_async\_block\_ids\_cache
إذا كانت القيمة true، فسنخزّن قيم hash الخاصة بعمليات async inserts مؤقتًا.
القيم الممكنة:
* `true`
* `false`
ستُولِّد الكتلة المرتبطة بعدة عمليات async inserts عدة قيم hash.
وعندما تكون بعض عمليات insert مكررة، فلن يعيد Keeper سوى
قيمة hash مكررة واحدة في استدعاء RPC واحد، مما سيتسبب في
محاولات RPC إضافية غير ضرورية.
سيراقب هذا التخزين المؤقت path الخاصة بقيم hash في Keeper. وإذا جرت
مراقبة التحديثات في Keeper، فسيُحدَّث التخزين المؤقت بأسرع وقت ممكن، حتى نتمكن
من تصفية عمليات insert المكررة في الذاكرة.
## use\_compact\_variant\_discriminators\_serialization
يُفعّل الوضع المضغوط للتسلسل الثنائي لقيم discriminator في نوع البيانات Variant.
يتيح هذا الوضع استخدام ذاكرة أقل بكثير لتخزين قيم discriminator
في الأجزاء عندما يكون هناك غالبًا variant واحد أو عدد كبير من قيم NULL.
## use\_const\_adaptive\_granularity
استخدم دائمًا دقة حبيبات ثابتة للجزء بأكمله. يتيح ذلك ضغط قيم دقة حبيبات الفهرس في
الذاكرة. وقد يكون هذا مفيدًا في أحمال العمل الكبيرة جدًا
ذات الجداول قليلة الأعمدة.
## use\_metadata\_cache
إعداد مهمل، ولا يؤدي أي وظيفة.
## use\_minimalistic\_checksums\_in\_zookeeper
استخدم تنسيقًا صغيرًا (عشرات البايتات) من أجل part checksums في ZooKeeper بدلًا من
التنسيق المعتاد (عشرات الكيلوبايتات). قبل التمكين، تحقّق من أن جميع النسخ المتماثلة تدعم
التنسيق الجديد.
طريقة تخزين رؤوس أجزاء البيانات في ZooKeeper. عند تمكينه، يخزّن ZooKeeper
بيانات أقل. لمزيد من التفاصيل، راجع [هنا](/ar/reference/settings/server-settings/settings#use_minimalistic_part_header_in_zookeeper).
## use\_primary\_key\_cache
استخدم الذاكرة المؤقتة للفهرس الأساسي
بدلًا من الاحتفاظ بجميع الفهارس في الذاكرة. قد يكون ذلك مفيدًا جدًا للجداول الكبيرة جدًا
## vertical\_merge\_algorithm\_min\_bytes\_to\_activate
الحد الأدنى (التقريبي) للحجم غير المضغوط، بالبايت، في الأجزاء التي يجري دمجها لتفعيل
خوارزمية الدمج العمودي.
## vertical\_merge\_algorithm\_min\_columns\_to\_activate
الحد الأدنى لعدد الأعمدة غير المدرجة ضمن المفتاح الأساسي لتفعيل خوارزمية الدمج العمودي.
## vertical\_merge\_algorithm\_min\_rows\_to\_activate
الحد الأدنى (التقريبي) لإجمالي عدد الصفوف في
الأجزاء قيد الدمج لتفعيل خوارزمية الدمج العمودي.
## vertical\_merge\_optimize\_lightweight\_delete
إذا كانت القيمة true، فسيجري تحسين الحذف خفيف الوزن أثناء الدمج العمودي.
## vertical\_merge\_optimize\_ttl\_delete
إذا كانت القيمة true، فسيُحسَّن حذف الصفوف وفق TTL عند الدمج العمودي. وبدلاً من فرض
الدمج الأفقي، يُقيَّم عامل تصفية TTL ويُمرَّر إلى خوارزمية الدمج التي تضبط علامات التخطي في مصادر الصفوف.
## vertical\_merge\_remote\_filesystem\_prefetch
إذا كانت القيمة true، فسيُستخدَم الجلب المسبق للبيانات من نظام الملفات البعيد للعمود التالي أثناء الدمج
## wait\_for\_unique\_parts\_send\_before\_shutdown\_ms
قبل إيقاف التشغيل، سينتظر الجدول المدة المطلوبة لكي تتمكّن النسخ المتماثلة الأخرى من جلب الأجزاء الفريدة
(الموجودة فقط على النسخة المتماثلة الحالية)؛ وتشير القيمة 0 إلى
التعطيل.
## write\_ahead\_log\_bytes\_to\_fsync
إعداد مهمل، وليس له أي تأثير.
## write\_ahead\_log\_interval\_ms\_to\_fsync
إعداد متقادِم، ولا يؤدي أي وظيفة.
## write\_ahead\_log\_max\_bytes
إعداد متقادم، لا تأثير له.
## write\_final\_mark
إعداد مهمل، ولا تأثير له.
## write\_marks\_for\_substreams\_in\_compact\_parts
يُمكّن هذا الإعداد من كتابة علامة لكل تيار فرعي بدلًا من كتابة علامة لكل عمود في الأجزاء المدمجة.
ويتيح ذلك قراءة الأعمدة الفرعية الفردية من جزء البيانات بكفاءة.
على سبيل المثال، يُسلسَل العمود `t Tuple(a String, b UInt32, c Array(Nullable(UInt32)))` في التيارات الفرعية التالية:
* `t.a` لبيانات String الخاصة بالعنصر `a` من Tuple
* `t.b` لبيانات UInt32 الخاصة بالعنصر `b` من Tuple
* `t.c.size0` لأحجام المصفوفة الخاصة بالعنصر `c` من Tuple
* `t.c.null` لخريطة null لعناصر المصفوفة المتداخلة الخاصة بالعنصر `c` من Tuple
* `t.c` لبيانات UInt32 الخاصة بعناصر المصفوفة المتداخلة للعنصر `c` من Tuple
عند تمكين هذا الإعداد، ستُكتب علامة لكل واحد من هذه التيارات الفرعية الخمسة، ما يعني أننا سنتمكن من قراءة
بيانات كل تيار فرعي على حدة من الـ granule بشكل مستقل عند الحاجة. على سبيل المثال، إذا أردنا قراءة العمود الفرعي `t.c`، فسنقرأ فقط بيانات
التيارات الفرعية `t.c.size0` و`t.c.null` و`t.c`، ولن نقرأ بيانات من التيارين الفرعيين `t.a` و`t.b`. وعند تعطيل هذا الإعداد،
ستُكتب علامة واحدة فقط للعمود الأعلى مستوى `t`، ما يعني أننا سنقرأ دائمًا بيانات العمود بالكامل من الـ granule، حتى إذا كنا نحتاج فقط إلى بيانات بعض التيارات الفرعية.
## zero\_copy\_concurrent\_part\_removal\_max\_postpone\_ratio
الحد الأقصى للنسبة المئوية للأجزاء من المستوى الأعلى التي يمكن تأجيل إزالتها للحصول على نطاقات مستقلة أصغر.
يُنصح بعدم تغييره.
## zero\_copy\_concurrent\_part\_removal\_max\_split\_times
الحد الأقصى لعمق التكرار عند تقسيم نطاقات الأجزاء القديمة المستقلة إلى
نطاقات فرعية أصغر. يُنصح بعدم تغييره.
## zero\_copy\_merge\_mutation\_min\_parts\_size\_sleep\_before\_lock
إذا كان النسخ المتماثل بدون نسخ مفعّلًا، فانتظر مدة عشوائية قبل محاولة الحصول على القفل، وذلك بحسب حجم الأجزاء لعمليتَي الدمج أو التعديل
## zero\_copy\_merge\_mutation\_min\_parts\_size\_sleep\_no\_scale\_before\_lock
إذا كان النسخ المتماثل دون نسخ مُمكّنًا، فانتظر مدة عشوائية تصل إلى 500 مللي ثانية
قبل محاولة الحصول على قفل لإجراء عملية دمج أو mutation.
## zookeeper\_session\_expiration\_check\_period
فترة التحقق من انتهاء جلسة ZooKeeper، بالثواني.
القيم الممكنة:
* أي عدد صحيح موجب.