> ## 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/ru/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" />

Включает или отключает отправку вставленных данных батчами.

Когда отправка батчами включена, движок таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed) пытается отправить несколько файлов со вставленными данными за одну операцию, а не по отдельности. Отправка батчами повышает производительность кластера за счёт более эффективного использования ресурсов сервера и сети.

Возможные значения:

* 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="Milliseconds" default_value="30000" />

Максимальный интервал отправки данных для движка таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed). Ограничивает экспоненциальный рост интервала, заданного настройкой [distributed\_background\_insert\_sleep\_time\_ms](/docs/ru/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="Milliseconds" default_value="100" />

Базовый интервал отправки данных для движка таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed). При возникновении ошибок фактический интервал увеличивается экспоненциально.

Возможные значения:

* Положительное целое число миллисекунд.

<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` для движка таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed)).
</Note>

<Note>
  Не следует полагаться на автоматическое разбиение батчей, так как это может ухудшить производительность.
</Note>

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

**Псевдонимы**: `insert_distributed_timeout`

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

Тайм-аут для запроса вставки в Distributed. Этот параметр используется только при включенном insert\_distributed\_sync. Нулевое значение означает отсутствие тайм-аута.