> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# إعدادات الجلسة لـ distributed_cache_*

> إعدادات جلسة ClickHouse ضمن المجموعة المُولَّدة distributed_cache_*.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>النوع</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>القيمة الافتراضية</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          يمكن تغييره دون إعادة التشغيل
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'متاح فقط في ClickHouse Cloud'}
        </div>;
};

هذه الإعدادات متوفّرة في [system.settings](/docs/ar/reference/system-tables/settings)، وهي مُولَّدة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="distributed_cache_alignment">
  ## distributed\_cache\_alignment
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.7"},{"label": "0"},{"label": "إعادة تسمية لـ distributed_cache_read_alignment"}]}]} />

لا يكون لهذا أي تأثير إلا في ClickHouse Cloud. هذا إعداد لأغراض الاختبار، فلا تغيّره

<div id="distributed_cache_bypass_connection_pool">
  ## distributed\_cache\_bypass\_connection\_pool
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "إعداد لـ ClickHouse Cloud"}]}]} />

لا يكون له تأثير إلا في ClickHouse Cloud. يسمح بتجاوز مجمع اتصالات distributed cache

<div id="distributed_cache_connect_backoff_max_ms">
  ## distributed\_cache\_connect\_backoff\_max\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "50"},{"label": "إعداد جديد"}]}]} />

يسري فقط في ClickHouse Cloud. الحد الأقصى لمدة backoff، بالمللي ثانية، عند إنشاء اتصال بـ distributed cache.

<div id="distributed_cache_connect_backoff_min_ms">
  ## distributed\_cache\_connect\_backoff\_min\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "إعداد جديد"}]}]} />

لا يكون لهذا تأثير إلا في ClickHouse Cloud. الحد الأدنى لمدة backoff، بالمللي ثانية، عند إنشاء اتصال distributed cache.

<div id="distributed_cache_connect_max_tries">
  ## distributed\_cache\_connect\_max\_tries
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "5"},{"label": "تم تغيير قيمة الإعداد"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "20"},{"label": "لـ Cloud فقط"}]}, {"id": "row-3","items": [{"label": "24.10"},{"label": "20"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

لا يكون له تأثير إلا في ClickHouse Cloud. عدد محاولات الاتصال بـ distributed cache عند فشل الاتصال

<div id="distributed_cache_connect_timeout_ms">
  ## distributed\_cache\_connect\_timeout\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "50"},{"label": "إعداد جديد"}]}]} />

يسري فقط في ClickHouse Cloud. مهلة الاتصال عند إنشاء اتصال بخادم Distributed Cache.

<div id="distributed_cache_credentials_refresh_period_seconds">
  ## distributed\_cache\_credentials\_refresh\_period\_seconds
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "5"},{"label": "إعداد خاص جديد"}]}]} />

لا يكون له تأثير إلا في ClickHouse Cloud. وهي مدة تحديث بيانات الاعتماد.

<div id="distributed_cache_data_packet_ack_window">
  ## distributed\_cache\_data\_packet\_ack\_window
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "5"},{"label": "إعداد في ClickHouse Cloud"}]}]} />

لا يكون له تأثير إلا في ClickHouse Cloud. نافذة لإرسال ACK لتسلسل DataPacket ضمن طلب قراءة واحد من distributed cache

<div id="distributed_cache_discard_connection_if_unread_data">
  ## distributed\_cache\_discard\_connection\_if\_unread\_data
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "إعداد جديد"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

لا يكون لهذا أي تأثير إلا في ClickHouse Cloud. يتجاهل الاتصال إذا كانت هناك بيانات غير مقروءة.

<div id="distributed_cache_fetch_metrics_only_from_current_az">
  ## distributed\_cache\_fetch\_metrics\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "1"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. يجلب المقاييس من منطقة التوافر الحالية فقط في system.distributed\_cache\_metrics و system.distributed\_cache\_events

<div id="distributed_cache_file_cache_name">
  ## distributed\_cache\_file\_cache\_name
</div>

<CloudOnlyBadge />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": ""},{"label": "إعداد جديد."}]}]} />

يكون له تأثير فقط في ClickHouse Cloud. إعداد يُستخدم فقط لاختبارات CI — اسم ذاكرة التخزين المؤقت لنظام الملفات المراد استخدامها مع distributed cache.

<div id="distributed_cache_log_mode">
  ## distributed\_cache\_log\_mode
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCacheLogMode" default_value="on_error" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "on_error"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. وضع الكتابة في system.distributed\_cache\_log

<div id="distributed_cache_max_unacked_inflight_packets">
  ## distributed\_cache\_max\_unacked\_inflight\_packets
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10"},{"label": "إعداد لـ ClickHouse Cloud"}]}]} />

لا يؤثر هذا إلا في ClickHouse Cloud. الحد الأقصى لعدد الحزم قيد الإرسال غير المؤكَّدة في طلب قراءة واحد من distributed cache

<div id="distributed_cache_min_bytes_for_seek">
  ## distributed\_cache\_min\_bytes\_for\_seek
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "إعداد خاص جديد."}]}]} />

لا يسري إلا في ClickHouse Cloud. الحد الأدنى لعدد البايتات اللازمة لإجراء seek في distributed cache.

<div id="distributed_cache_pool_behaviour_on_limit">
  ## distributed\_cache\_pool\_behaviour\_on\_limit
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCachePoolBehaviourOnLimit" default_value="wait" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "wait"},{"label": "Cloud فقط"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "allocate_bypassing_pool"},{"label": "إعداد لـ ClickHouse Cloud"}]}]} />

لا يكون له تأثير إلا في ClickHouse Cloud. يحدد سلوك اتصال distributed cache عند الوصول إلى حدّ الـ pool

<div id="distributed_cache_prefer_bigger_buffer_size">
  ## distributed\_cache\_prefer\_bigger\_buffer\_size
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "0"},{"label": "إعداد جديد."}]}]} />

لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. وهو مماثل لـ `filesystem_cache_prefer_bigger_buffer_size`، ولكن لذاكرة التخزين المؤقت الموزعة.

<div id="distributed_cache_read_only_from_current_az">
  ## distributed\_cache\_read\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

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

<div id="distributed_cache_read_request_max_tries">
  ## distributed\_cache\_read\_request\_max\_tries
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "10"},{"label": "تم تغيير قيمة الإعداد"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "20"},{"label": "إعداد جديد"}]}]} />

لا يكون لهذا تأثير إلا في ClickHouse Cloud. عدد مرات إعادة محاولة طلب قراءة distributed cache عند عدم نجاحه

<div id="distributed_cache_receive_response_wait_milliseconds">
  ## distributed\_cache\_receive\_response\_wait\_milliseconds
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="60000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "60000"},{"label": "إعداد لـ ClickHouse Cloud"}]}]} />

لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. مدة الانتظار بالمللي ثانية لتلقّي بيانات الطلب من distributed cache

<div id="distributed_cache_receive_timeout_milliseconds">
  ## distributed\_cache\_receive\_timeout\_milliseconds
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10000"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

لا يسري إلا في ClickHouse Cloud. مدة الانتظار بالمللي ثانية لتلقي أي نوع من الاستجابة من ذاكرة التخزين المؤقت الموزعة

القيمة الافتراضية في Cloud: `20000`.

<div id="distributed_cache_receive_timeout_ms">
  ## distributed\_cache\_receive\_timeout\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="3000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "3000"},{"label": "إعداد جديد"}]}]} />

لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. مهلة انتظار استلام البيانات من خادم distributed cache، بالميلي ثانية. إذا لم يتم استلام أي بايت خلال هذه المدة، فسيتم رفع استثناء.

<div id="distributed_cache_registry_show_certificate_and_signature">
  ## distributed\_cache\_registry\_show\_certificate\_and\_signature
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "إعداد جديد لإظهار العمودين `certificate` و`signature` في `system.distributed_cache_registry`."}]}]} />

لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. يعرض العمودين `certificate` و`signature` في جدول `system.distributed_cache_registry`. تكون هذه الأعمدة فارغة افتراضيًا للحفاظ على المخرجات موجزة؛ فعِّل هذا الإعداد لفحصها.

<div id="distributed_cache_send_timeout_ms">
  ## distributed\_cache\_send\_timeout\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="3000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "3000"},{"label": "إعداد جديد"}]}]} />

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

<div id="distributed_cache_tcp_keep_alive_timeout_ms">
  ## distributed\_cache\_tcp\_keep\_alive\_timeout\_ms
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="2900" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "2900"},{"label": "إعداد جديد"}]}]} />

يكون له تأثير فقط في ClickHouse Cloud. وهي المدة، بالمللي ثانية، التي يجب أن يظل خلالها الاتصال بخادم distributed cache في حالة خمول قبل أن يبدأ TCP بإرسال رسائل keepalive.

<div id="distributed_cache_throw_on_error">
  ## distributed\_cache\_throw\_on\_error
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

لا يسري هذا الإعداد إلا في ClickHouse Cloud. أعِد إطلاق الاستثناء الذي يحدث أثناء الاتصال بـ distributed cache أو الاستثناء الوارد من distributed cache. وإلا، فسيتم الرجوع إلى تخطي distributed cache عند حدوث خطأ

<div id="distributed_cache_use_clients_cache_for_read">
  ## distributed\_cache\_use\_clients\_cache\_for\_read
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

يؤثر فقط في ClickHouse Cloud. يستخدم clients cache لطلبات القراءة.

<div id="distributed_cache_wait_connection_from_pool_milliseconds">
  ## distributed\_cache\_wait\_connection\_from\_pool\_milliseconds
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "100"},{"label": "إعداد خاص بـ ClickHouse Cloud"}]}]} />

يكون لهذا الإعداد تأثير فقط في ClickHouse Cloud. وقت الانتظار بالمللي ثانية للحصول على اتصال من مجمع الاتصالات إذا كانت قيمة distributed\_cache\_pool\_behaviour\_on\_limit هي wait

<div id="distributed_cache_write_request_max_tries">
  ## distributed\_cache\_write\_request\_max\_tries
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "10"},{"label": "إعداد جديد"}]}]} />

لا يكون لهذا تأثير إلا في ClickHouse Cloud. عدد محاولات تنفيذ طلب كتابة إلى distributed cache عند عدم نجاحه