Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

إعدادات جدول MergeTree‏ shared_merge_*

هذه الإعدادات متاحة في system.merge_tree_settings، ويجري توليدها تلقائيًا من الشيفرة المصدرية لـ ClickHouse.

shared_merge_tree_activate_coordinated_merges_tasks

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.90إعدادات جديدة
25.80إعدادات جديدة
25.70إعدادات جديدة
25.60إعدادات جديدة
25.100إعدادات جديدة

يُفعّل إعادة جدولة مهام الدمج المنسّقة. وقد يكون ذلك مفيدًا حتى عندما shared_merge_tree_enable_coordinated_merges=0 لأن هذا سيؤدي إلى تعبئة إحصاءات منسّق الدمج ويساعد في التشغيل البارد.

shared_merge_tree_blobs_list_inline_file_max_bytes

النوع
UInt64
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.90إعداد جديد يخزّن الملفات الصغيرة لجزء blob-list مضمّنةً في ملف blobs.list الموحّد بدلاً من كائنات blobs منفصلة

خزّن ملفات جزء blob-list التي لا يتجاوز حجمها هذا العدد من البايتات (مثل count.txt وmetadata_version.txt وفهارس minmax) مباشرةً داخل ملف blobs.list الموحّد بدلاً من blob منفصل في تخزين الكائنات، مما يوفر عملية كتابة وقراءة واحدة لـ blob لكل ملف صغير. تعطل القيمة 0 التضمين. لا يسري ذلك إلا على الأجزاء التي تستخدم تخزين blob-list (راجع shared_merge_tree_use_blobs_list_for_parts). متاح فقط في ClickHouse Cloud.

shared_merge_tree_create_per_replica_metadata_nodes

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.110تقليل كمية البيانات الوصفية في Keeper.
25.11مزامنة Cloud

يُمكّن من إنشاء العقدتَين ‎/metadata و‎ /columns لكل نسخة متماثلة في ZooKeeper. متاح فقط في ClickHouse Cloud

shared_merge_tree_disable_merges_and_mutations_assignment

النوع
Bool
القيمة الافتراضية
0

إيقاف إسناد عمليات الدمج في shared merge tree. متاح فقط في ClickHouse Cloud

shared_merge_tree_empty_partition_lifetime

النوع
ثوانٍ
القيمة الافتراضية
86400
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.986400إعداد جديد

عدد الثواني التي سيُحتفَظ خلالها بالتقسيم في Keeper إذا لم تكن له أي أجزاء.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.21مُمكَّن افتراضيًا
25.90إعداد جديد

يُفعِّل تنظيف إدخالات Keeper الخاصة بالتقسيم الفارغ.

shared_merge_tree_enable_coordinated_merges

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.61تمكين عمليات الدمج المنسّقة افتراضيًا
25.50إعداد جديد

يُفعّل استراتيجية عمليات الدمج المنسّقة

shared_merge_tree_enable_keeper_parts_extra_data

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.61تمكين عمليات الدمج المنسقة افتراضيًا
25.30إعداد جديد

يُمكّن من كتابة السمات إلى الأجزاء الافتراضية واعتماد الكتل في Keeper

shared_merge_tree_enable_outdated_parts_check

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11مزامنة Cloud

تمكين التحقق من الأجزاء القديمة. متاح فقط في ClickHouse Cloud

shared_merge_tree_idle_parts_update_seconds

النوع
UInt64
القيمة الافتراضية
3600
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.13600مزامنة Cloud

الفاصل الزمني، بالثواني، لتحديث الأجزاء من دون أن يتم تشغيله بواسطة آلية watch في ZooKeeper ضمن shared merge tree. متاح فقط في ClickHouse Cloud

shared_merge_tree_inactive_replica_cutoff_seconds

النوع
ثوانٍ
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.60إعداد جديد يتحكم في المدة التي تظل خلالها النسخة المتماثلة غير النشطة مأخوذة في الحسبان أثناء التنظيف في الخلفية (0 تعني مهلتَي جلسة لـ ZooKeeper)

المدة التي تظل خلالها النسخة المتماثلة غير النشطة مأخوذة في الحسبان أثناء التنظيف في الخلفية (OutdatedPartsQuorumThread): ما دامت النسخة المتماثلة غير نشطة لمدة تقل عن هذا العدد من الثواني، فإنها تظل تؤخر إزالة الأجزاء القديمة وحذف mutations المكتملة. وتعني القيمة 0 استخدام القيمة الافتراضية، وهي مهلتا جلسة لـ ZooKeeper. في ClickHouse Cloud فقط

shared_merge_tree_initial_parts_update_backoff_ms

النوع
UInt64
القيمة الافتراضية
50
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.250إعداد جديد

مهلة التراجع الأولية لتحديث الأجزاء. متاح فقط في ClickHouse Cloud

shared_merge_tree_interserver_http_connection_timeout_ms

النوع
UInt64
القيمة الافتراضية
100
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.2100إعداد جديد

مهلات اتصال HTTP بين الخوادم. متاح فقط في ClickHouse Cloud

shared_merge_tree_interserver_http_timeout_ms

النوع
UInt64
القيمة الافتراضية
10000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.110000مزامنة Cloud

مهلات الاتصال لاتصالات HTTP بين الخوادم. متاح فقط في ClickHouse Cloud

shared_merge_tree_leader_update_period_random_add_seconds

النوع
UInt64
القيمة الافتراضية
10
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.110مزامنة Cloud

يضيف قيمة موزعة توزيعًا منتظمًا من 0 إلى x ثانية إلى shared_merge_tree_leader_update_period لتجنب ظاهرة القطيع المندفع. متاح فقط في ClickHouse Cloud

shared_merge_tree_leader_update_period_seconds

النوع
UInt64
القيمة الافتراضية
30
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.130مزامنة Cloud

الحد الأقصى للمدة لإعادة التحقق من القائد المسؤول عن تحديث الأجزاء. متاح فقط في ClickHouse Cloud

shared_merge_tree_max_outdated_parts_to_process_at_once

النوع
UInt64
القيمة الافتراضية
1000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11000مزامنة Cloud

الحد الأقصى لعدد الأجزاء القديمة التي سيحاول القائد تأكيد إزالتها ضمن طلب HTTP واحد. متاح فقط في ClickHouse Cloud.

shared_merge_tree_max_parts_update_backoff_ms

النوع
UInt64
القيمة الافتراضية
5000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.25000إعداد جديد

الحد الأقصى لمدة التراجع عند تحديث الأجزاء. متاح فقط في ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_in_total

النوع
UInt64
القيمة الافتراضية
6
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.16مزامنة Cloud

الحد الأقصى لإجمالي عدد قادة تحديث الأجزاء. متاح فقط في ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_per_az

النوع
UInt64
القيمة الافتراضية
2
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.12مزامنة Cloud

الحد الأقصى لعدد القادة المسؤولين عن تحديث الأجزاء. متوفر فقط في ClickHouse Cloud

shared_merge_tree_max_replicas_for_parts_deletion

النوع
UInt64
القيمة الافتراضية
10
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.110مزامنة Cloud

الحد الأقصى لعدد النسخ المتماثلة التي ستشارك في حذف الأجزاء (خيط التنفيذ killer). متاح فقط في ClickHouse Cloud

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

النوع
UInt64
القيمة الافتراضية
5
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.15مزامنة Cloud

الحد الأقصى لعدد النسخ المتماثلة التي ستحاول إسناد عمليات دمج يحتمل أن تكون متعارضة (مما يساعد على تجنب التعارضات غير الضرورية في إسناد عمليات الدمج). تعني القيمة 0 أن هذه الميزة معطّلة. هذا الإعداد متاح فقط في ClickHouse Cloud

shared_merge_tree_max_suspicious_broken_parts

النوع
UInt64
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.20الحد الأقصى للأجزاء المعطوبة في SMT؛ وإذا تجاوز العدد هذا الحد، يُمنع الفصل التلقائي

الحد الأقصى للأجزاء المعطوبة في SMT؛ وإذا تجاوز العدد هذا الحد، يُمنع الفصل التلقائي.

shared_merge_tree_max_suspicious_broken_parts_bytes

النوع
UInt64
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.20الحد الأقصى لإجمالي حجم جميع الأجزاء التالفة في SMT. وإذا تجاوز هذا الحد، يُمنع الفصل التلقائي

الحد الأقصى لإجمالي حجم جميع الأجزاء التالفة في SMT. وإذا تجاوز هذا الحد، يُمنع الفصل التلقائي.

shared_merge_tree_memo_ids_remove_timeout_seconds

النوع
Int64
القيمة الافتراضية
1800
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11800مزامنة Cloud

المدة التي نحتفظ فيها بمعرّفات التذكّر المؤقت لعمليات الإدراج لتجنّب الإجراءات الخاطئة أثناء إعادة محاولات الإدراج. متاح فقط في ClickHouse Cloud

shared_merge_tree_merge_coordinator_distribution_algorithm

النوع
MergeCoordinatorDistributionAlgorithm
القيمة الافتراضية
sainte_lague
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.8sainte_lagueتفعيل توزيع Sainte-Lague افتراضيًا.
26.7water_fillingإعداد جديد يتحكم في الخوارزمية التي يستخدمها منسّق الدمج لتوزيع عمليات الدمج بين النسخ المتماثلة

الخوارزمية التي يستخدمها خيط منسّق الدمج لتوزيع عمليات الدمج بين النسخ المتماثلة.

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

  • water_filling
  • sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

النوع
مللي ثانية
القيمة الافتراضية
30000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.530000إعداد جديد

الفاصل الزمني بين مرات تشغيل خيط تنفيذ انتخاب منسّق الدمج

shared_merge_tree_merge_coordinator_factor

النوع
Float
القيمة الافتراضية
1.1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.51.100000023841858إعداد جديد
25.101.100000023841858خفض وقت انتظار coordinator بعد الحمل

معامل تغيير مدة تأخير خيط coordinator

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

النوع
مللي ثانية
القيمة الافتراضية
10000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.510000إعداد جديد

الفاصل الزمني الذي ينبغي أن يتزامن عنده merge coordinator مع ZooKeeper للحصول على بيانات وصفية حديثة

shared_merge_tree_merge_coordinator_max_merge_request_size

النوع
UInt64
القيمة الافتراضية
20
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.520إعداد جديد

عدد عمليات الدمج التي يمكن للمنسّق طلبها من MergerMutator دفعة واحدة

shared_merge_tree_merge_coordinator_max_period_ms

النوع
مللي ثانية
القيمة الافتراضية
10000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.510000إعداد جديد

الحد الأقصى للفاصل الزمني بين مرات تشغيل خيط منسق الدمج

shared_merge_tree_merge_coordinator_merges_prepare_count

النوع
UInt64Auto
القيمة الافتراضية
auto
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.4autoاضبط الإعداد على auto: الحد الأقصى لمهام الدمج لكل نسخة متماثلة * عدد النسخ المتماثلة النشطة
25.5100إعداد جديد

عدد إدخالات الدمج التي ينبغي أن يُعدّها المنسّق ويوزّعها على العمّال. عند ضبطه على 'auto'، فإنه يساوي الحد الأقصى لعدد مهام الدمج المسموح بها على نسخة متماثلة واحدة مضروبًا في عدد النسخ المتماثلة النشطة.

shared_merge_tree_merge_coordinator_min_period_ms

النوع
مللي ثانية
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.51إعداد جديد

الحد الأدنى للفاصل الزمني بين مرات تشغيل خيط الخاصة بـ merge coordinator

shared_merge_tree_merge_worker_fast_timeout_ms

النوع
مللي ثانية
القيمة الافتراضية
100
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.5100إعداد جديد

مهلة الانتظار التي يستخدمها خيط عامل الدمج إذا احتاج إلى تحديث حالته بعد تنفيذ إجراء فوري

shared_merge_tree_merge_worker_regular_timeout_ms

النوع
مللي ثانية
القيمة الافتراضية
10000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.5إعداد جديد10000

الفاصل الزمني بين مرات تشغيل خيط عامل الدمج

shared_merge_tree_outdated_parts_group_size

النوع
UInt64
القيمة الافتراضية
2
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.92إعداد جديد

يحدّد عدد النسخ المتماثلة التي ستكون ضمن مجموعة rendezvous hash نفسها عند تنظيف الأجزاء القديمة. متاح فقط في ClickHouse Cloud.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

النوع
Float
القيمة الافتراضية
0.5

سيُعاد تحميل شرط الدمج في مهمة اختيار الدمج/التعديل عندما تكون نسبة <candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> أعلى من هذا الإعداد. هذا متاح فقط في ClickHouse Cloud

shared_merge_tree_parts_load_batch_size

النوع
UInt64
القيمة الافتراضية
32

عدد مهام جلب البيانات الوصفية للأجزاء التي تُجدوَل في المرة الواحدة. متاح فقط في ClickHouse Cloud

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

النوع
UInt64
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.10مزامنة Cloud

المدة الزمنية للاحتفاظ بجزء مدمج محليًا دون بدء عملية دمج جديدة تتضمن هذا الجزء. يتيح ذلك للنسخ المتماثلة الأخرى فرصة جلب هذا الجزء وبدء عملية الدمج. متاح فقط في ClickHouse Cloud.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

النوع
UInt64
القيمة الافتراضية
1000000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11000000مزامنة Cloud

الحد الأدنى لحجم الجزء (بعدد الصفوف) لتأجيل إسناد عملية الدمج التالية مباشرةً بعد دمجه محليًا. متاح فقط في ClickHouse Cloud.

shared_merge_tree_range_for_merge_window_size

النوع
UInt64
القيمة الافتراضية
10
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.110مزامنة Cloud

حجم النافذة (وفق أرقام الـ block) المستخدم لتوزيع إسناد الدمج بين النسخ المتماثلة. وتُسنَد الأجزاء ضمن النافذة نفسها إلى النسخ المتماثلة نفسها. متاح فقط في ClickHouse Cloud

shared_merge_tree_read_virtual_parts_from_leader

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11مزامنة Cloud

تتم قراءة الأجزاء الافتراضية من القائد عند الإمكان. هذا الإعداد متاح فقط في ClickHouse Cloud

shared_merge_tree_replica_set_max_lifetime_seconds

النوع
ثوانٍ
القيمة الافتراضية
1800
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.41800زيادة الفاصل الزمني الافتراضي لتحديث مجموعة النسخ المتماثلة في الخلفية إلى 30 دقيقة
26.2300إعداد جديد

مدى تكرار محاولة النسخ المتماثلة تحديث مجموعة النسخ المتماثلة في الخلفية. يُضاف انحراف عشوائي إلى وقت المحاولة التالية بتوزيع منتظم ضمن [0, value] ثانية. استثناء: لا تتبع القيمة = 0 هذه القاعدة؛ إذ يطبّق التنفيذ حدًا أدنى قدره 200 مللي ثانية، ولذلك يُضاف انحراف عشوائي إلى وقت المحاولة التالية ضمن [0, 200] مللي ثانية.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.10إعداد جديد لجلب بيانات الأجزاء من النسخ المتماثلة الأخرى

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

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.60إعداد جديد يتيح لـ SMT تنزيل بيانات الأجزاء من النسخ المتماثلة بدلًا من S3 عند بدء التشغيل

إذا كان هذا الخيار مُمكّنًا، فستحاول جميع النسخ المتماثلة عند بدء التشغيل جلب بيانات الأجزاء المخزنة في الذاكرة (مثل المفتاح الأساسي ومعلومات partition وما إلى ذلك) من نسخ متماثلة أخرى تكون هذه البيانات متوفرة فيها بالفعل.

shared_merge_tree_update_replica_flags_delay_ms

النوع
مللي ثانية
القيمة الافتراضية
30000
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.830000إعداد جديد

الفترة التي ستحاول فيها النسخة المتماثلة إعادة تحميل علاماتها وفقًا للجدولة الخلفية.

shared_merge_tree_use_blobs_list_for_parts

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.90إعداد جديد يخزّن خريطة blobs لكل ملف في جزء SharedMergeTree ضمن عقدة Keeper موحّدة واحدة بدلاً من عقدة لكل ملف

يخزّن أجزاء جدول SharedMergeTree (بتنسيقَي Wide وCompact) في عقدة بيانات وصفية موحّدة واحدة من نوع blob-list، بدلاً من عقدة Keeper لكل ملف. ويقلّص بيانات وصفية ‏Keeper لكل جزء من O(files) إلى ثابت صغير، مع الإبقاء على blob واحد في تخزين الكائنات لكل ملف. متاح فقط في ClickHouse Cloud.

shared_merge_tree_use_metadata_hints_cache

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.11مزامنة Cloud

يتيح طلب تلميحات ذاكرة التخزين المؤقت لنظام الملفات من ذاكرة التخزين المؤقت داخل الذاكرة على النُسخ المتماثلة الأخرى. متاح فقط في ClickHouse Cloud

shared_merge_tree_use_outdated_parts_compact_format

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.91تمكين الأجزاء القديمة v3 افتراضيًا
25.10مزامنة Cloud

استخدم تنسيق compact للأجزاء القديمة: يقلّل الحمل على Keeper، ويحسّن معالجة الأجزاء القديمة. متاح فقط في ClickHouse Cloud

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.10مزامنة Cloud

إذا كان هذا الإعداد مُمكّنًا، فسيعتمد عدّاد Too many parts على البيانات المشتركة في Keeper بدلًا من الحالة المحلية للنسخة المتماثلة. متاح فقط في ClickHouse Cloud

shared_merge_tree_use_zookeeper_connection_pool

النوع
Bool
القيمة الافتراضية
0
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.30إعداد جديد

عند تمكينه، يستخدم SharedMergeTree إحدى جلسات ZooKeeper المجمّعة على مستوى الخادم.

shared_merge_tree_virtual_parts_discovery_batch

النوع
UInt64
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
25.81إعداد جديد

عدد عمليات اكتشاف الأقسام التي ينبغي تجميعها في دفعة واحدة

shared_merge_tree_virtual_parts_partition_atomic_discovery

النوع
Bool
القيمة الافتراضية
1
سجل الإصدارات
الإصدارالقيمة الافتراضيةالتعليق
26.71إعداد جديد

إعداد متقادم، لا يفعل شيئًا.

Navigation