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

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

Включает адаптивный алгоритм GROUP BY: каждый поток агрегирует данные в локальную хеш-таблицу, пока число ключей не достигнет adaptive_aggregator_freeze_threshold (или объём памяти не достигнет adaptive_aggregator_freeze_threshold_bytes), после чего таблица замораживается. Строки уже встречавшихся (частых) ключей продолжают обновляться в этой таблице, а новые (редкие) ключи по хешу направляются в очереди отдельных бакетов и агрегируются ровно один раз при параллельном слиянии по бакетам. Частые ключи остаются в небольших таблицах, помещающихся в кэше, а редкие ключи хранятся и обрабатываются один раз, а не по одному разу для каждого потока.

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

Включает адаптивную выгрузку данных из памяти во внешнее хранилище. На данный момент поддерживается только Grace JOIN.

Включает DISTINCT в подзапросах IN. Это компромиссная настройка: при включении она может значительно уменьшить размер временных таблиц, передаваемых для распределённых подзапросов IN, и существенно ускорить передачу данных между сегментами, поскольку отправляются только уникальные значения. Однако включение этой настройки требует дополнительных затрат на слияние на каждом узле, так как необходимо выполнять дедупликацию (DISTINCT). Используйте эту настройку, если передача данных по сети является узким местом, а дополнительные затраты на слияние допустимы.

Разрешает использовать экспериментальный кодек сжатия ALP.

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

Включает оптимизатор Cascades, основанный на оценке стоимости, для распределённых планов запросов. Настройка действует только вместе с make_distributed_plan = 1; сама по себе она не влияет на планирование запросов на одном узле.

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

Включает или отключает возврат результатов типа Date32 с расширенным диапазоном значений (по сравнению с типом Date) или DateTime64 с расширенным диапазоном значений (по сравнению с типом DateTime).

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

• 0 — Функции возвращают Date или DateTime для аргументов всех типов.
• 1 — Функции возвращают Date32 или DateTime64 для аргументов типа Date32 или DateTime64, а в остальных случаях — Date или DateTime.

В таблице ниже показано, как эта настройка влияет на поведение различных функций даты и времени.

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

Если установлено значение true, разрешает использование текстового индекса.

Включает раннюю свёртку констант с коротким замыканием для and и or на этапе анализа запроса. Если параметр включен, подходящие недостижимые ветви со скалярными подзапросами анализируются для сохранения их типов и проверки семантики запроса, но не выполняются. Если требуются скалярная мощность или значения времени выполнения, оптимизация переключается на обычный анализ.

Распространяет операторы WITH на запросы UNION и все подзапросы

Включает оптимизацию фильтрации TopK при агрегации в запросах GROUP BY keys ORDER BY <prefix of keys> LIMIT K, а также в запросах GROUP BY keys LIMIT K без ORDER BY (в этом случае допустим любой набор из K групп, поэтому синтезируется сортировка по всем ключам).

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

Оптимизация отключается, если запрошенный LIMIT превышает query_plan_max_limit_for_top_k_optimization или жесткий предел 100000, поскольку потребление памяти и CPU кучей растет с увеличением запрошенного LIMIT.

Оптимизация не применяется к формам запросов, в которых удаление групп может изменить результат, включая WITH TOTALS, HAVING, QUALIFY, оконные функции, ROLLUP/CUBE/GROUPING SETS, LIMIT WITH TIES, COLLATE для любого из сопоставленных ключей GROUP BY (COLLATE для более позднего столбца ORDER BY после полного префикса ключа не влияет на то, какие группы попадут в результат, поэтому не отключает оптимизацию), ORDER BY по агрегату или по чему-либо, что не является начальным префиксом ключей GROUP BY, а также запросы, в которых задан max_rows_to_group_by или exact_rows_before_limit.

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

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

Включает преобразование полезной нагрузки hash JOIN в построчный формат.

Включает или отключает использование pread для файлов HDFS. По умолчанию используется hdfsPread. Если параметр отключен, для чтения файлов HDFS используются hdfsRead и hdfsSeek.

Включает или отключает сжатие данных в ответе на HTTP-запрос.

Дополнительные сведения см. в описании HTTP-интерфейса.

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

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

Включает кэш разрешения идентификаторов в анализаторе запросов. Кэш повторно использует уже разрешённые узлы псевдонимов, чтобы предотвратить разрастание AST, когда на один и тот же псевдоним ссылаются несколько раз. Установите false, чтобы отключить кэширование, если есть подозрение на некорректные результаты.

Выводит трассировку стека создателя задачи, если при выполнении задачи возникает исключение. По умолчанию отключён, чтобы избежать снижения производительности.

Включает значение clickhouse_json для настройки dialect.

Если для dialect установлено значение clickhouse_json, запросы интерпретируются как JSON AST (результат parseQueryToJSON), а не как текст SQL. Запрос SET по-прежнему разбирается как обычный SQL, чтобы можно было переключить диалект обратно.

Пример:

SET enable_json_ast_dialect = 1;
SET dialect = 'clickhouse_json';

-- Subsequent queries are parsed as JSON ASTs:
{"type":"SelectWithUnionQuery", ...}

Включает отложенную репликацию столбцов в JOIN, ARRAY JOIN и захватах лямбда-выражений функций высшего порядка (например, arrayMap), что позволяет избежать многократного ненужного копирования одних и тех же строк в памяти.

Включает материализованные CTE; эта настройка имеет приоритет над enable_global_with_statement

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

Перемещает больше условий из WHERE в PREWHERE и выполняет чтение с диска и фильтрацию в несколько этапов, если есть несколько условий, объединённых оператором побитового И

Генерировать именованные Tuple в функции tuple(), если все имена уникальны и могут использоваться как идентификаторы без кавычек.

Включает или отключает сортировку с использованием синтаксиса ORDER BY ALL, см. ORDER BY.

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

• 0 — Отключает ORDER BY ALL.
• 1 — Включает ORDER BY ALL.

Пример

Запрос:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

Результат:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴────┴─────┘

Используйте хеш-таблицу с ключами в виде 16-байтных упакованных ссылок на строки (PackedStringRef) для GROUP BY с одним ключом типа String, не допускающим NULL. Ключи длиной до 11 байт хранятся непосредственно в упакованной ссылке; для более длинных ключей используются ссылки на arena. Этот метод быстрее для большинства рабочих нагрузок, но может быть медленнее устаревшего при GROUP BY с очень небольшим числом различных ключей длиннее 11 байт (особенно длиной 12..24 байта): устаревшая хеш-таблица хранит ключи непосредственно в ячейке, а упакованная при каждой проверке разыменовывает указатель на arena. При отключении используется устаревший метод на основе StringHashTable (использовавшийся по умолчанию до версии 26.8).

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

Если значение равно true, данные можно напрямую разбирать в столбцы с пользовательской сериализацией (например, Sparse) в соответствии с подсказками по сериализации, полученными из таблицы.

Разрешает агрегированию с эффективным использованием памяти (см. distributed_aggregation_memory_efficient) выдавать бакеты не по порядку. Это может повысить производительность при неравномерном распределении размеров бакетов, так как реплика может отправлять инициатору бакеты с более высокими идентификаторами, пока ещё обрабатывает тяжёлые бакеты с более низкими идентификаторами. Недостаток — потенциально более высокое использование памяти.

Разрешает использовать экспериментальный кодек сжатия Quantized.

Если параметр включен, результаты SELECT-запросов берутся из кэша запросов.

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

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

Включает максимально подробное логирование запросов к S3. Имеет смысл только для отладки.

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

Если отключено, объявления в родительских предложениях WITH будут иметь ту же область видимости, как если бы они были объявлены в текущей области видимости.

Обратите внимание, что это настройка совместимости для анализатора, позволяющая выполнять некоторые некорректные запросы, которые мог выполнять старый анализатор.

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

Это эффективно для ключей высокой кардинальности при равномерном распределении данных, но может работать хуже при сильно неравномерном распределении ключей или в запросах с очень малым числом различных ключей.

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

• 0 — Оптимизация сегментированной агрегации отключена.
• 1 — Оптимизация сегментированной агрегации включена.

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

Это необходимо для запросов, в которых важна внутренняя согласованность частей данных. Пример:

SELECT
    count()
FROM events
WHERE (_part, _part_offset) IN (
    SELECT _part, _part_offset
    FROM events
    WHERE user_id = 42
)

Без этой настройки внешние и внутренние запросы могут работать с разными снимками данных, что может приводить к некорректным результатам.

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

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

Разрешает совместно использовать объекты Set, созданные для подзапросов IN, в разных задачах одной мутации. Это снижает использование памяти и потребление CPU

Разрешает непрерывные запросы SELECT ... FROM t STREAM [CURSOR '{...}']. Если настройка отключена, любое табличное выражение, использующее модификатор STREAM, отклоняется на этапе построения плана выполнения. Это основной переключатель для возможности стриминг-запросов; дополнительные возможности могут управляться собственными настройками.

Разрешает использовать экспериментальный кодек сжатия SZ3.

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

Позволяет создавать типы данных Time и Time64.

Разрешает ARRAY JOIN с несколькими массивами разной длины. Когда этот параметр включен, массивы будут приведены к длине самого длинного.

Позволяет включать и отключать декодирование/кодирование пути в URI в таблицах с движком URL.

По умолчанию отключено.

Если включено, во время FINAL дублирующиеся строки удаляются путём пометки строк как удалённых и их последующей фильтрации вместо слияния строк

Если параметр включен, результаты запросов SELECT сохраняются в кэше запросов.

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

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

Разрешает использовать экспериментальный кодек сжатия ZXC.