> ## 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_background_*

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

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>;
};

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

<div id="distributed_background_insert_batch">
  ## distributed\_background\_insert\_batch
</div>

**الأسماء البديلة**: `distributed_directory_monitor_batch_inserts`

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

يُمكّن/يعطّل إرسال البيانات المُدخلة على دفعات.

عند تمكين الإرسال على دفعات، يحاول محرك الجدول إرسال عدة ملفات من البيانات المُدخلة ضمن عملية واحدة بدلًا من إرسالها كلٌّ على حدة. ويُحسّن الإرسال على دفعات أداء العنقود من خلال الاستفادة بشكل أفضل من موارد الخادم والشبكة.

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

* 1 — مُمكّن.
* 0 — مُعطّل.

<div id="distributed_background_insert_max_sleep_time_ms">
  ## distributed\_background\_insert\_max\_sleep\_time\_ms
</div>

**الأسماء البديلة**: `distributed_directory_monitor_max_sleep_time_ms`

<SettingsInfoBlock type="مللي ثانية" default_value="30000" />

الحد الأقصى للفاصل الزمني الذي يستخدمه محرك الجدول لإرسال البيانات. ويحدّ من الزيادة الأُسية للفاصل الزمني المحدد في إعداد [distributed\_background\_insert\_sleep\_time\_ms](/docs/ar/reference/settings/session-settings/distributed-background#distributed_background_insert_sleep_time_ms).

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

* عدد صحيح موجب من المللي ثانية.

<div id="distributed_background_insert_sleep_time_ms">
  ## distributed\_background\_insert\_sleep\_time\_ms
</div>

**الأسماء البديلة**: `distributed_directory_monitor_sleep_time_ms`

<SettingsInfoBlock type="مللي ثانية" default_value="100" />

الفاصل الزمني الأساسي الذي يستخدمه محرك الجدول لإرسال البيانات. ويزداد الفاصل الزمني الفعلي أُسّيًا في حال حدوث أخطاء.

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

* عدد صحيح موجب بالمللي ثانية.

<div id="distributed_background_insert_split_batch_on_failure">
  ## distributed\_background\_insert\_split\_batch\_on\_failure
</div>

**الأسماء البديلة**: `distributed_directory_monitor_split_batch_on_failure`

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

يُمكّن/يعطّل تقسيم الدُفعات عند حدوث فشل.

أحيانًا قد يفشل إرسال دفعة معيّنة إلى الشارد البعيد بسبب مسار معالجة معقّد لاحقًا (مثل `MATERIALIZED VIEW` مع `GROUP BY`) نتيجة الخطأ `Memory limit exceeded` أو أخطاء مشابهة. في هذه الحالة، لن تفيد إعادة المحاولة (وقد يؤدي ذلك إلى تعطّل عمليات الإرسال الموزعة لهذا الجدول)، لكن إرسال ملفات تلك الدفعة واحدًا تلو الآخر قد ينجح في تنفيذ INSERT.

لذلك، فإن تعيين هذا الإعداد إلى `1` سيعطّل التجميع لهذه الدُفعات (أي سيعطّل مؤقتًا `distributed_background_insert_batch` للدُفعات الفاشلة).

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

* 1 — ممكّن.
* 0 — معطّل.

<Note>
  يؤثر هذا الإعداد أيضًا في الدُفعات التالفة (التي قد تظهر بسبب إنهاء غير طبيعي للخادم (الآلة) وعدم استخدام `fsync_after_insert`/`fsync_directories` مع محرك الجدول).
</Note>

<Note>
  يجب عدم الاعتماد على التقسيم التلقائي للدُفعات، لأن ذلك قد يضر بالأداء.
</Note>

<div id="distributed_background_insert_timeout">
  ## distributed\_background\_insert\_timeout
</div>

**الأسماء البديلة**: `insert_distributed_timeout`

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

المهلة الزمنية لاستعلام insert إلى Distributed. لا يُستخدم هذا الإعداد إلا عند تفعيل insert\_distributed\_sync. وتعني القيمة صفر عدم وجود مهلة زمنية.