Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки сеанса distributed_background_*

Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.

distributed_background_insert_batch

Псевдонимы: distributed_directory_monitor_batch_inserts

Тип
Bool
По умолчанию
0

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

Когда отправка батчами включена, движок таблицы Distributed пытается отправить несколько файлов со вставленными данными за одну операцию, а не по отдельности. Отправка батчами повышает производительность кластера за счёт более эффективного использования ресурсов сервера и сети.

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

  • 1 — Включено.
  • 0 — Отключено.

distributed_background_insert_max_sleep_time_ms

Псевдонимы: distributed_directory_monitor_max_sleep_time_ms

Тип
Milliseconds
По умолчанию
30000

Максимальный интервал отправки данных для движка таблицы Distributed. Ограничивает экспоненциальный рост интервала, заданного настройкой distributed_background_insert_sleep_time_ms.

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

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

distributed_background_insert_sleep_time_ms

Псевдонимы: distributed_directory_monitor_sleep_time_ms

Тип
Milliseconds
По умолчанию
100

Базовый интервал отправки данных для движка таблицы Distributed. При возникновении ошибок фактический интервал увеличивается экспоненциально.

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

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

distributed_background_insert_split_batch_on_failure

Псевдонимы: distributed_directory_monitor_split_batch_on_failure

Тип
Bool
По умолчанию
0

Включает или отключает разбиение батчей при сбоях.

Иногда отправка конкретного батча на удалённый сегмент может завершиться ошибкой из-за сложного конвейера на принимающей стороне (например, MATERIALIZED VIEW с GROUP BY) вследствие ошибки Memory limit exceeded или подобных ей. В таком случае повторные попытки не помогут (и это заблокирует распределённую отправку для таблицы), а вот отправка файлов из этого батча по одному может позволить успешно выполнить INSERT.

Поэтому установка этого параметра в 1 отключает батчинг для таких батчей (то есть временно отключает distributed_background_insert_batch для батчей, завершившихся ошибкой).

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

  • 1 — Включено.
  • 0 — Отключено.

distributed_background_insert_timeout

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

Тип
UInt64
По умолчанию
0

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

Navigation