Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Настройки сеанса distributed_plan_*

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

distributed_plan_default_reader_bucket_count

Экспериментальная возможность
Тип
NonZeroUInt64
По умолчанию
8
История версий
ВерсияЗначение по умолчаниюКомментарий
25.58Новая экспериментальная настройка.

Число задач по умолчанию для параллельного чтения в распределённом запросе. Задачи распределяются между репликами. Используется распределённым планировщиком на основе правил. Оптимизатор на основе стоимости выбирает степень распараллеливания чтения на основе оценочной стоимости и не использует эту настройку.

distributed_plan_default_shuffle_join_bucket_count

Экспериментальная возможность
Тип
NonZeroUInt64
По умолчанию
8
История версий
ВерсияЗначение по умолчаниюКомментарий
25.58Новая экспериментальная настройка.

Число бакетов по умолчанию для распределённого shuffle-hash-join. Используется распределённым планировщиком на основе правил. Оптимизатор на основе стоимости выбирает степень распараллеливания на основе оценочной стоимости и не использует эту настройку.

distributed_plan_execute_locally

Экспериментальная возможность
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.50Новая экспериментальная настройка.

Выполнять локально все задачи распределённого плана запроса. Полезно для тестирования и отладки.

distributed_plan_force_exchange_kind

Экспериментальная возможность
История версий
ВерсияЗначение по умолчаниюКомментарий
25.5Новая экспериментальная настройка.

Принудительно использовать указанный тип операторов Exchange между стадиями распределённого запроса.

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

  • '' - не принудительно использовать какой-либо тип операторов Exchange, предоставить выбор оптимизатору,
  • 'Persisted' - использовать временные файлы в Объектном хранилище,
  • 'Streaming' - передавать данные Exchange по сети.

distributed_plan_force_shuffle_aggregation

Экспериментальная возможность
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.70новая экспериментальная настройка

Используйте стратегию агрегации Shuffle вместо PartialAggregation + Merge в распределённом плане запроса.

distributed_plan_max_rows_to_broadcast

Экспериментальная возможность
Тип
UInt64
По умолчанию
20000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.720000Новая экспериментальная настройка.

Максимальное количество строк, при котором в распределённом плане запроса используется broadcast JOIN вместо shuffle JOIN. Эвристика для распределённого планировщика на основе правил. Когда включён оптимизатор на основе стоимости, выбор между broadcast и shuffle определяется оценочной стоимостью, и эта настройка не влияет на него.

distributed_plan_optimize_exchanges

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.51Новая экспериментальная настройка.

Убирает лишние обмены данными в распределённом плане запроса. Отключите эту настройку для отладки.

distributed_plan_prefer_replicas_over_workers

Экспериментальная возможность
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.40Новая настройка для сериализации распределённого плана на репликах

Сериализует распределённый план запроса для выполнения на репликах.

distributed_plan_workers_num

Экспериментальная возможность
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.60Новая экспериментальная настройка, определяющая, сколько воркеров без сохранения состояния будет арендовано для распределённого запроса. Значение 0 отключает аренду.

Сколько воркеров без сохранения состояния будет использовано для выполнения этого запроса. Значение 0 отключает аренду таких воркеров для распределённых планов.

distributed_plan_workers_provisioning_timeout_ms

Экспериментальная возможность
Тип
UInt64
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
26.910000Новая настройка, ограничивающая время ожидания запроса до того, как арендованные воркеры без сохранения состояния станут доступны перед выполнением; значение `compatibility` ниже 26.9 восстанавливает прежнее поведение без ожидания.

Общее фактическое время в миллисекундах, которое запрос может затратить на подготовку воркеров без сохранения состояния перед выполнением: их аренду у службы обнаружения и проверку доступности. В пределах этого лимита запрос ожидает готовности арендованных воркеров; по его истечении запрос продолжает выполняться с воркерами, проверенными к этому моменту, или завершается ошибкой, если ни один из них не стал доступен. При нулевом значении выполняется только начальный проход аренды и проверки (без повторных попыток).

Navigation