هذه الإعدادات متوفّرة في system.settings، وهي مُولَّدة تلقائيًا من المصدر.
distributed_cache_alignment
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.7 | 0 | إعادة تسمية لـ distributed_cache_read_alignment |
لا يكون لهذا أي تأثير إلا في ClickHouse Cloud. هذا إعداد لأغراض الاختبار، فلا تغيّره
distributed_cache_bypass_connection_pool
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 0 | إعداد لـ ClickHouse Cloud |
لا يكون له تأثير إلا في ClickHouse Cloud. يسمح بتجاوز مجمع اتصالات distributed cache
distributed_cache_client_id
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 26.9 | إعداد جديد (لاختبارات CI فقط) لتجاوز معرّف عميل distributed cache لكل استعلام. | |
| 26.8 | إعداد جديد (لاختبارات CI فقط) لتجاوز معرّف عميل distributed cache لكل استعلام. |
لا يسري مفعوله إلا في ClickHouse Cloud. يُستخدم هذا الإعداد لاختبارات CI فقط، ويستبدل معرّف عميل distributed cache المُهيأ في registry لطلبات هذا الاستعلام إذا لم تكن قيمته فارغة. يتيح للاختبارات توزيع البيانات على مجموعة محدودة من معرّفات العملاء، مع إبقاء البيانات نفسها مرتبطة بمعرّف العميل نفسه. يتطلب ذلك تمكين ci_mode في config عميل distributed cache؛ وإذا لم يكن مُمكّنًا (وهو الإعداد الافتراضي، كما في بيئة production)، يفشل أي استعلام يمرّر عملية قراءة أو كتابة عبر distributed cache بالخطأ SUPPORT_IS_DISABLED بدلًا من الرجوع بصمت إلى معرّف العميل المُهيأ. ولا تتأثر الاستعلامات التي لا تصل مطلقًا إلى distributed cache، لذا تُتجاهل القيمة فيها.
distributed_cache_connect_backoff_max_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.8 | 50 | إعداد جديد |
يسري فقط في ClickHouse Cloud. الحد الأقصى لمدة backoff، بالمللي ثانية، عند إنشاء اتصال بـ distributed cache.
distributed_cache_connect_backoff_min_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.8 | 0 | إعداد جديد |
لا يكون لهذا تأثير إلا في ClickHouse Cloud. الحد الأدنى لمدة backoff، بالمللي ثانية، عند إنشاء اتصال distributed cache.
distributed_cache_connect_max_tries
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.8 | 5 | تم تغيير قيمة الإعداد |
| 25.1 | 20 | لـ Cloud فقط |
| 24.10 | 20 | إعداد خاص بـ ClickHouse Cloud |
لا يكون له تأثير إلا في ClickHouse Cloud. عدد محاولات الاتصال بـ distributed cache عند فشل الاتصال
distributed_cache_connect_timeout_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.10 | 50 | إعداد جديد |
يسري فقط في ClickHouse Cloud. مهلة الاتصال عند إنشاء اتصال بخادم Distributed Cache.
distributed_cache_credentials_refresh_period_seconds
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.6 | 5 | إعداد خاص جديد |
لا يكون له تأثير إلا في ClickHouse Cloud. وهي مدة تحديث بيانات الاعتماد.
distributed_cache_data_packet_ack_window
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 5 | إعداد في ClickHouse Cloud |
لا يكون له تأثير إلا في ClickHouse Cloud. نافذة لإرسال ACK لتسلسل DataPacket ضمن طلب قراءة واحد من distributed cache
distributed_cache_discard_connection_if_unread_data
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.11 | 1 | إعداد جديد |
| 24.10 | 1 | إعداد جديد |
لا يكون لهذا أي تأثير إلا في ClickHouse Cloud. يتجاهل الاتصال إذا كانت هناك بيانات غير مقروءة.
distributed_cache_fetch_metrics_only_from_current_az
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 1 | إعداد خاص بـ ClickHouse Cloud |
لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. يجلب المقاييس من منطقة التوافر الحالية فقط في system.distributed_cache_metrics و system.distributed_cache_events
distributed_cache_file_cache_name
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 26.1 | إعداد جديد. |
يكون له تأثير فقط في ClickHouse Cloud. إعداد يُستخدم فقط لاختبارات CI — اسم ذاكرة التخزين المؤقت لنظام الملفات المراد استخدامها مع distributed cache.
distributed_cache_log_mode
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | on_error | إعداد خاص بـ ClickHouse Cloud |
لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. وضع الكتابة في system.distributed_cache_log
distributed_cache_max_unacked_inflight_packets
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 10 | إعداد لـ ClickHouse Cloud |
لا يؤثر هذا إلا في ClickHouse Cloud. الحد الأقصى لعدد الحزم قيد الإرسال غير المؤكَّدة في طلب قراءة واحد من distributed cache
distributed_cache_min_bytes_for_seek
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.1 | 0 | إعداد خاص جديد. |
لا يسري إلا في ClickHouse Cloud. الحد الأدنى لعدد البايتات اللازمة لإجراء seek في distributed cache.
distributed_cache_min_inflight_bytes_to_discard_connection_on_seek
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 26.9 | 4194304 | إعداد جديد لإغلاق اتصال distributed cache وإعادة فتحه عند إجراء seek إذا كان سيستلزم ذلك تجاهل عدد كبير جدًا من البايتات قيد الإرسال. القيمة الافتراضية هي 4 MiB؛ وتعيد القيمة 0 السلوك السابق (إعادة استخدام الاتصال دائمًا عبر معرّف نطاق القراءة). |
| 26.8 | 4194304 | إعداد جديد لإغلاق اتصال distributed cache وإعادة فتحه عند إجراء seek إذا كان سيستلزم ذلك تجاهل عدد كبير جدًا من البايتات قيد الإرسال. القيمة الافتراضية هي 4 MiB؛ وتعيد القيمة 0 السلوك السابق (إعادة استخدام الاتصال دائمًا عبر معرّف نطاق القراءة). |
| 26.7 | 4194304 | إعداد جديد لإغلاق اتصال distributed cache وإعادة فتحه عند إجراء seek إذا كان سيستلزم ذلك تجاهل عدد كبير جدًا من البايتات قيد الإرسال. القيمة الافتراضية هي 4 MiB؛ وتعيد القيمة 0 السلوك السابق (إعادة استخدام الاتصال دائمًا عبر معرّف نطاق القراءة). |
لا يؤثر هذا الإعداد إلا في ClickHouse Cloud. عند إجراء seek بعيدًا عن الموضع الحالي لتدفق مفتوح من distributed cache، إذا تجاوز العدد التقديري للبايتات قيد الإرسال التي يجب تجاهلها لمواصلة إعادة استخدام الاتصال (عبر آلية معرّف نطاق القراءة) هذه القيمة، فأغلق الاتصال وافتح اتصالًا جديدًا بدلًا منه. يجنّب ذلك استنزاف كمية كبيرة من البيانات غير المستخدمة عند تكرار عمليات seek. تؤدي القيمة 0 إلى تعطيل ذلك وإعادة استخدام الاتصال دائمًا.
distributed_cache_pool_behaviour_on_limit
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.1 | wait | Cloud فقط |
| 24.10 | allocate_bypassing_pool | إعداد لـ ClickHouse Cloud |
لا يكون له تأثير إلا في ClickHouse Cloud. يحدد سلوك اتصال distributed cache عند الوصول إلى حدّ الـ pool
distributed_cache_prefer_bigger_buffer_size
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.10 | 0 | إعداد جديد. |
لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. وهو مماثل لـ filesystem_cache_prefer_bigger_buffer_size، ولكن لذاكرة التخزين المؤقت الموزعة.
distributed_cache_read_only_from_current_az
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.5 | 1 | إعداد جديد |
لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. يتيح القراءة فقط من منطقة التوافر الحالية. وإذا كان معطّلًا، فستتم القراءة من جميع خوادم التخزين المؤقت في جميع مناطق التوافر.
distributed_cache_read_request_max_tries
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.8 | 10 | تم تغيير قيمة الإعداد |
| 25.4 | 20 | إعداد جديد |
لا يكون لهذا تأثير إلا في ClickHouse Cloud. عدد مرات إعادة محاولة طلب قراءة distributed cache عند عدم نجاحه
distributed_cache_receive_response_wait_milliseconds
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 60000 | إعداد لـ ClickHouse Cloud |
لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. مدة الانتظار بالمللي ثانية لتلقّي بيانات الطلب من distributed cache
distributed_cache_receive_timeout_milliseconds
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 10000 | إعداد خاص بـ ClickHouse Cloud |
لا يسري إلا في ClickHouse Cloud. مدة الانتظار بالمللي ثانية لتلقي أي نوع من الاستجابة من ذاكرة التخزين المؤقت الموزعة
القيمة الافتراضية في Cloud: 20000.
distributed_cache_receive_timeout_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.10 | 3000 | إعداد جديد |
لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. مهلة انتظار استلام البيانات من خادم distributed cache، بالميلي ثانية. إذا لم يتم استلام أي بايت خلال هذه المدة، فسيتم رفع استثناء.
distributed_cache_registry_show_certificate_and_signature
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 26.6 | 0 | إعداد جديد لإظهار العمودين `certificate` و`signature` في `system.distributed_cache_registry`. |
لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. يعرض العمودين certificate وsignature في جدول system.distributed_cache_registry. تكون هذه الأعمدة فارغة افتراضيًا للحفاظ على المخرجات موجزة؛ فعِّل هذا الإعداد لفحصها.
distributed_cache_send_timeout_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.10 | 3000 | إعداد جديد |
لا يكون له تأثير إلا في ClickHouse Cloud. المهلة الزمنية لإرسال البيانات إلى خادم distributed cache، بالمللي ثانية. إذا احتاج عميل إلى إرسال بعض البيانات ولم يتمكن من إرسال أي بايتات خلال هذه المدة، فسيتم إطلاق استثناء.
distributed_cache_tcp_keep_alive_timeout_ms
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.10 | 2900 | إعداد جديد |
يكون له تأثير فقط في ClickHouse Cloud. وهي المدة، بالمللي ثانية، التي يجب أن يظل خلالها الاتصال بخادم distributed cache في حالة خمول قبل أن يبدأ TCP بإرسال رسائل keepalive.
distributed_cache_throw_on_error
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 0 | إعداد خاص بـ ClickHouse Cloud |
لا يسري هذا الإعداد إلا في ClickHouse Cloud. أعِد إطلاق الاستثناء الذي يحدث أثناء الاتصال بـ distributed cache أو الاستثناء الوارد من distributed cache. وإلا، فسيتم الرجوع إلى تخطي distributed cache عند حدوث خطأ
distributed_cache_use_clients_cache_for_read
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 25.12 | 1 | إعداد جديد |
يؤثر فقط في ClickHouse Cloud. يستخدم clients cache لطلبات القراءة.
distributed_cache_wait_connection_from_pool_milliseconds
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 24.10 | 100 | إعداد خاص بـ ClickHouse Cloud |
يكون لهذا الإعداد تأثير فقط في ClickHouse Cloud. وقت الانتظار بالمللي ثانية للحصول على اتصال من مجمع الاتصالات إذا كانت قيمة distributed_cache_pool_behaviour_on_limit هي wait
distributed_cache_write_request_max_tries
سجل الإصدارات
| الإصدار | القيمة الافتراضية | التعليق |
|---|---|---|
| 26.4 | 10 | إعداد جديد |
لا يكون لهذا تأثير إلا في ClickHouse Cloud. عدد محاولات تنفيذ طلب كتابة إلى distributed cache عند عدم نجاحه