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

distributed_plan_default_reader_bucket_count

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

distributed_plan_default_shuffle_join_bucket_count

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

distributed_plan_exchange_compression_method

Кодек для сжатия пакетов при потоковом обмене между задачами плана выполнения распределённого запроса. При обмене через временные файлы используется кодек сервера по умолчанию. Возможные значения:
  • '' — использовать кодек, заданный в network_compression_method.
  • NONE — без сжатия.
  • LZ4 — использовать кодек LZ4.
  • LZ4HC — использовать кодек LZ4HC с уровнем по умолчанию 9. Сжимает во много раз медленнее, чем LZ4.
  • ZSTD — использовать кодек ZSTD с уровнем, заданным в distributed_plan_exchange_zstd_compression_level.

distributed_plan_exchange_zstd_compression_level

Уровень сжатия ZSTD для потокового обмена в плане выполнения распределённого запроса. Используется, только если настройка distributed_plan_exchange_compression_method имеет значение ZSTD. Возможные значения:
  • Целое число от 1 до 22. Чем выше уровень, тем сильнее сжатие, но тем медленнее оно выполняется.

distributed_plan_execute_locally

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

distributed_plan_fallback_to_local_execution

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

distributed_plan_force_exchange_kind

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

distributed_plan_force_shuffle_aggregation

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

distributed_plan_join_runtime_filters

При использовании make_distributed_plan фильтры JOIN времени выполнения, построенные на одной стадии, передаются на стадии, читающие проверяемую сторону, чтобы те отфильтровывали строки до их отправки. Если фильтр не поступил, строки передаются без фильтрации. Требуется включённая настройка enable_join_runtime_filters.

distributed_plan_max_buffered_log_rows

Когда send_logs_level пересылает координатору журналы задач воркеров без сохранения состояния, каждая задача воркера буферизует между опросами статуса не более указанного количества строк журнала. Строки сверх этого предела отбрасываются, а их количество сообщается клиенту. 0 означает отсутствие ограничения (строки никогда не отбрасываются, но если опрос статуса зависнет, буфер может расти без ограничений).

distributed_plan_max_rows_to_broadcast

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

distributed_plan_optimize_exchanges

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

distributed_plan_partial_aggregation_before_shuffle

Выполняет частичную агрегацию на узлах, читающих данные, до того как распределённая агрегация перераспределит их по ключам GROUP BY. Благодаря этому при перераспределении каждый узел передаёт одно состояние агрегации на группу, а не все входные строки, и каждый бакет выполняет слияние состояний своих ключей. Планировщик на основе правил по-прежнему перераспределяет входные строки, если статистика столбцов показывает, что частичная агрегация не сократит объём данных хотя бы вдвое. При включённой настройке enable_cascades_optimizer данная настройка позволяет оптимизатору выбирать такое слияние для каждого бакета на основе стоимости. Действует только вместе с make_distributed_plan = 1 и не действует при включённой настройке distributed_plan_force_shuffle_aggregation, которая перераспределяет входные строки.

distributed_plan_prefer_replicas_over_workers

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

distributed_plan_read_in_order

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

distributed_plan_worker_cluster

Имя кластера stateless-worker, на котором выполняется распределённый план выполнения данного запроса. Если значение пустое (по умолчанию), используется предварительно настроенный кластер по умолчанию; другие кластеры задаются в stateless_worker_client.clusters.

distributed_plan_workers_num

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

distributed_plan_workers_provisioning_timeout_ms

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