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

distributed_plan_default_reader_bucket_count

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

distributed_plan_default_shuffle_join_bucket_count

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

distributed_plan_execute_locally

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

distributed_plan_fallback_to_local_execution

Если план запроса содержит шаг, не поддерживающий распределённое выполнение, причина записывается в лог, а запрос выполняется на initiator вместо генерации исключения. Отключите, чтобы вместо этого получать исключение. Действует только при включённой настройке make_distributed_plan (закрытая предварительная версия).

distributed_plan_force_exchange_kind

Принудительно использовать указанный тип операторов Exchange между стадиями распределённого запроса. Возможные значения:
  • ” - не принудительно использовать какой-либо тип операторов Exchange, предоставить выбор оптимизатору,
  • ‘Persisted’ - использовать временные файлы в Объектном хранилище,
  • ‘Streaming’ - передавать данные Exchange по сети.

distributed_plan_force_shuffle_aggregation

Используйте стратегию агрегации Shuffle вместо PartialAggregation + Merge в распределённом плане запроса. Игнорируется в случаях, когда стратегия Shuffle не может дать корректный результат, например для GROUPING SETS или когда агрегация должна выдавать результаты в порядке бакетов.

distributed_plan_max_rows_to_broadcast

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

distributed_plan_optimize_exchanges

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

distributed_plan_prefer_replicas_over_workers

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

distributed_plan_read_in_order

Разрешает оптимизацию чтения в порядке сортировки для ORDER BY в распределённом плане запроса, чтобы отсортированное чтение по ключу сортировки таблицы могло пропустить сортировку и завершиться раньше вместо сканирования и сортировки. По умолчанию отключено: преобразование, распределяющее сортировку, предполагает, что оборачиваемая им сортировка не зависит от того, что её входные данные уже упорядочены. Однако сортировка, которая от этого зависит, может получать строки через EXCHANGE, не сохраняющий порядок. В настоящее время безопасны только структуры, в которых между чтением и сортировкой нет EXCHANGE.

distributed_plan_workers_num

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

distributed_plan_workers_provisioning_timeout_ms

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