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

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

Включает или отключает оптимизацию на уровне плана запроса: если финальная агрегация передаёт результаты в ORDER BY с LIMIT n, а план гарантирует точность выборки в каждом бакете, на этапе финального преобразования агрегации материализуются только n лучших групп из каждого двухуровневого бакета в этом порядке. Результат точен: у группы, не входящей в n лучших групп своего бакета, есть как минимум n групп, опережающих её в глобальном порядке, поэтому она не может войти в глобальный top n. Действует только при значении 1 настройки query_plan_enable_optimizations.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию агрегации в порядке выполнения на уровне плана запроса. Действует только в том случае, если значение настройки query_plan_enable_optimizations равно 1.

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

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

Разрешает преобразовывать ANY JOIN в SEMI или ANTI JOIN, если фильтр после JOIN для совпавших или несовпавших строк всегда принимает значение false

Разрешает преобразовывать JOIN в подзапрос с IN, если выходные столбцы относятся только к левой таблице. Может приводить к неверным результатам с JOIN, отличными от ANY JOIN (например, с ALL JOIN, который используется по умолчанию).

Разрешает преобразовывать OUTER JOIN в INNER JOIN, если фильтр после JOIN всегда исключает значения по умолчанию

Позволяет выполнять фильтрацию при полнотекстовом поиске, используя в плане запроса только инвертированный текстовый индекс.

Показывать в EXPLAIN PLAN внутренние псевдонимы (например, __table1) вместо псевдонимов, указанных в исходном запросе.

Включает многопоточность после вычисления оконных функций, что позволяет выполнять потоковую обработку параллельно

Включает или отключает оптимизацию запросов на уровне плана запроса.

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

• 0 — отключить все оптимизации на уровне плана запроса
• 1 — включить оптимизации на уровне плана запроса (при этом отдельные оптимизации по-прежнему можно отключить их собственными настройками)

Включает или отключает оптимизацию на уровне плана запроса, которая перемещает выражения после этапов сортировки. Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию на уровне плана запроса, которая опускает фильтры ниже в плане выполнения. Применяется только в том случае, если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию на уровне плана запроса, объединяющую фильтр по столбцам элементов ARRAY JOIN с шагом ARRAY JOIN. Массивы фильтруются в пространстве элементов до развёртывания, поэтому отфильтрованные элементы никогда не развёртываются и не реплицируются. Действует только при значении 1 настройки query_plan_enable_optimizations.

Применять сегментирование для JOIN, если ключи JOIN в обеих таблицах содержат префикс PRIMARY KEY. Поддерживается для алгоритмов hash, parallel_hash, full_sorting_merge и parallel_full_sorting_merge. Обычно не ускоряет запросы, но может снизить потребление памяти.

Определяет, какая сторона JOIN должна использоваться как build-таблица (также называемая inner — она помещается в hash-таблицу при hash JOIN) в плане запроса. Эта настройка поддерживается только для strictness ALL с условием JOIN ON. Возможные значения:

• 'auto': позволить planner'у определить, какую таблицу использовать как build-таблицу.
• 'false': никогда не менять таблицы местами (build-таблицей является правая таблица).
• 'true': всегда менять таблицы местами (build-таблицей является левая таблица).

Включает или отключает оптимизацию на уровне плана запроса, которая перемещает ARRAY JOIN выше в плане выполнения. Работает только в том случае, если для настройки query_plan_enable_optimizations установлено значение 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию на уровне плана запроса, которая переносит более крупные поддеревья плана запроса в union, чтобы открыть возможности для дальнейших оптимизаций. Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Управляет максимальным значением, при котором можно использовать план запроса для отложенной оптимизации индексирования в JOIN. Если значение равно нулю, ограничение отсутствует.

Управляет максимальным значением LIMIT, при котором можно использовать план запроса для оптимизации отложенной материализации. Если равно нулю, ограничение отсутствует.

Определяет максимальное значение LIMIT, при котором выполняется оценка плана запроса для оптимизации TopK с использованием индекса пропуска данных minmax и динамической фильтрации по порогу. Если значение равно 0, ограничение отсутствует.

Эта настройка также управляет поведением enable_group_by_top_k_optimization.

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

Максимальное количество строк во множестве условия IN, для которого механизм сопоставления проекций вычисляет и сравнивает хеши содержимого при определении равенства двух множеств. Множества, размер которых превышает это значение, считаются несовпадающими, и проекция пропускается. Ноль полностью отключает сравнение хешей содержимого: сопоставление проекций никогда не бывает успешным для узлов, содержащих множества условия IN.

Используется механизмом сопоставления aggregate projection (и любым будущим механизмом сопоставления проекций, которому потребуется сравнивать множества условия IN). Вычисление хеша содержимого имеет сложность O(N log N) по числу элементов множества; эта настройка ограничивает затраты на этапе планирования, когда в запросе или проекции присутствует много условий IN.

Максимальная длина описания шага в EXPLAIN PLAN.

Разрешает объединять выражения в шаг JOIN при оптимизации порядка JOIN.

Включает или отключает оптимизацию на уровне плана запроса, которая объединяет последовательные фильтры. Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

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

Позволяет объединять фильтр с условием JOIN и преобразовывать CROSS JOIN в INNER.

Позволяет объединять фильтры в плане запроса.

Управляет минимальным количеством столбцов полезной нагрузки из левой части, необходимым для включения оптимизации отложенной индексации в JOIN. 0 означает, что оптимизация отключена.

Позволяет выполнять SELECT count() ... WHERE <text search predicate> непосредственно по числу элементов в списках проводок текстового индекса, без материализации подходящих строк. Работает только при включённой настройке query_plan_direct_read_from_text_index.

Определяет, какие алгоритмы порядка JOIN следует применять при оптимизации плана запроса. Доступны следующие алгоритмы:

• 'greedy' - базовый жадный алгоритм — работает быстро, но не всегда даёт наилучший порядок JOIN
• 'dpsize' - реализует алгоритм DPsize, который в настоящее время поддерживает только INNER JOIN, — перебирает все возможные порядки JOIN и находит оптимальный, но может работать медленно для запросов с большим количеством таблиц и предикатов JOIN.
• 'dpsub' - реализует алгоритм DPsub, который поддерживает как INNER JOIN, так и другие типы JOIN, — перебирает все возможные порядки JOIN и находит оптимальный, но может работать медленно для запросов с большим количеством таблиц и предикатов JOIN.
• 'dphyp' - реализует алгоритм DPhyp (Dynamic Programming via Hypergraph Partitioning), который в настоящее время поддерживает только INNER JOIN, — исследует то же пространство поиска, что и dpsize, но перебирает только пары связанных подграфов, создавая меньше промежуточных JOIN в разреженных графах JOIN, ценой отказа от рассмотрения декартовых произведений Можно указать несколько алгоритмов в виде списка, разделённого запятыми, например dphyp,greedy. Они применяются по порядку; если алгоритм не может обработать запрос (например, из-за OUTER JOIN или несвязанных компонентов), в качестве резервного варианта используется следующий.

Оптимизирует порядок JOIN в рамках одного подзапроса. Пока поддерживается только в очень ограниченном числе случаев. Значение задаёт максимальное количество таблиц, для которых выполняется оптимизация.

Максимальное число частичных планов, которые оптимизатор порядка JOIN может перебрать, прежде чем прекратить поиск и перейти к следующему алгоритму в query_plan_optimize_join_order_algorithm. Это детерминированно ограничивает время оптимизации (независимо от реального времени) на плотных графах JOIN, таких как клики или звёзды, где пространство поиска растёт экспоненциально. Установите 0, чтобы отключить ограничение. Не влияет на значение по умолчанию query_plan_optimize_join_order_limit, при котором поиск всегда остаётся значительно ниже этого предела.

Если значение не равно нулю, оптимизатор порядка JOIN использует случайно сгенерированные кардинальности и NDV вместо реальной статистики. Если задано значение 1, генерируется начальное значение генератора случайных чисел; если задано значение > 1, это значение используется напрямую как начальное значение генератора случайных чисел. Это предназначено для тестирования и помогает выявлять ошибки, вызванные различным порядком JOIN.

Оптимизирует чтение с FINAL в ReplacingMergeTree путем построения множества первичных ключей и его использования при анализе индекса.

Использовать план запроса для оптимизации отложенной материализации.

Использовать оптимизацию отложенной материализации при чтении локальных файлов Parquet с помощью табличной функции file и движка таблицы File: в запросах ORDER BY ... LIMIT n столбцы, не требующиеся для сортировки и фильтрации, считываются только для n строк, оставшихся после применения LIMIT. Действует только при включенной настройке query_plan_optimize_lazy_materialization.

Использовать оптимизацию отложенной материализации при чтении файлов Parquet из объектного хранилища (включая таблицы Iceberg): в запросах ORDER BY ... LIMIT n столбцы, не необходимые для сортировки и фильтрации, считываются только для n строк, оставшихся после применения LIMIT. Действует только при включенной настройке query_plan_optimize_lazy_materialization.

Разрешает проталкивать фильтр в выражение PREWHERE для поддерживаемых хранилищ

Включает или отключает оптимизацию на уровне плана запроса, которая перемещает LIMIT ниже в плане выполнения. Настройка действует только в том случае, если значение query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию на уровне плана запроса, которая перемещает функции, уменьшающие объём (length, lengthUTF8, empty, notEmpty), ниже этапов Sorting и Filter в плане выполнения. Результат фиксированного размера заменяет широкий аргумент типа String / FixedString, поэтому его больше не нужно передавать через эти этапы. Преобразование применяется только в том случае, если столбец-аргумент не требуется выше этапа, ниже которого он проталкивается.

Действует только при значении 1 настройки query_plan_enable_optimizations.

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

• 0 — Отключить
• 1 — Включить

Включает или отключает оптимизацию на уровне плана запроса для запросов ORDER BY ... LIMIT BY. Когда столбцы LIMIT BY являются префиксом предложения ORDER BY, LIMIT BY применяется в каждом параллельном отсортированном потоке до слияния потоков в один, что уменьшает количество строк, обрабатываемых на этапе финального слияния и на последующих стадиях конвейера. Ускоряет запросы, в которых LIMIT BY отбрасывает значительную часть строк.

Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию чтения in-order на уровне плана запроса. Действует, только если значение настройки query_plan_enable_optimizations равно 1.

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

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

Сохранять упорядоченное чтение из левой таблицы при выполнении операций JOIN, чтобы его можно было использовать на последующих этапах.

Включает или отключает оптимизацию на уровне плана запроса, которая удаляет избыточные шаги DISTINCT. Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Включает или отключает оптимизацию на уровне плана запроса, удаляющую избыточные шаги сортировки, например во вложенных запросах. Действует только в том случае, если для настройки query_plan_enable_optimizations установлено значение 1.

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

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

Включает или отключает оптимизацию на уровне плана запроса, которая пытается удалять неиспользуемые столбцы (как входные, так и выходные) из шагов плана запроса. Действует только если значение настройки query_plan_enable_optimizations равно 1.

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

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

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

Включает или отключает оптимизацию на уровне плана запроса, которая использует порядок сортировки в хранилище при сортировке для оконных функций. Действует только если значение параметра query_plan_enable_optimizations равно 1.

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

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

Сокращает обработку JOIN, условие ON которого сворачивается в константу false, заменяя пустым источником каждую входную сторону, которая не может дать ни одной строки результата (обе стороны для INNER/CROSS/SEMI, непредохраняемую сторону для LEFT/RIGHT), чтобы не читать сторону, не участвующую в результате. Применяется при использовании анализатора (enable_analyzer = 1) и к нераспределённым планам.

Включает или отключает оптимизацию на уровне плана запроса, которая разбивает фильтры на выражения. Действует только в том случае, если значение настройки query_plan_enable_optimizations равно 1.

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

• 0 - Отключить
• 1 - Включить

Разрешает добавлять подсказку (дополнительный предикат) для фильтрации, построенной на основе инвертированного текстового индекса, в плане запроса.

Включает или отключает оптимизацию на уровне плана запроса, которая продвигает ORDER BY ... LIMIT n через JOIN, если ключ сортировки ссылается только на столбцы сохраняемой стороны JOIN (LEFT/RIGHT). Ограничивает, сколько строк должен вернуть вход сохраняемой стороны до выполнения JOIN. Действует только если для настройки query_plan_enable_optimizations установлено значение 1.

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

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

Включает или отключает оптимизацию на уровне плана запроса, которая пытается использовать индекс векторного сходства. Действует только в том случае, если значение настройки query_plan_enable_optimizations равно 1.

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

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