Другое настройки сеанса

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

Количество ключей, при котором адаптивный агрегатор замораживает локальную хеш-таблицу потока (см. enable_adaptive_aggregator). При меньших значениях замороженные таблицы остаются в кэше, при больших — могут содержать больше часто встречающихся ключей. При значении 0 таблицы замораживаются при первой возможности, поэтому алгоритм ведёт себя аналогично сегментированному агрегатору (enable_sharding_aggregator): каждый ключ направляется в соответствии со своим хешем и агрегируется одним владельцем, но это происходит на этапе слияния, а не в результате обмена между потоками во время сканирования.

Объём памяти, при достижении которого адаптивный агрегатор замораживает локальную хеш-таблицу потока (см. enable_adaptive_aggregator). Таблица замораживается при первом достижении этого значения или adaptive_aggregator_freeze_threshold. Размер — это объём байтов, выделенных самой локальной таблицей (буфер её хеш-таблицы плюс её арены), который проверяется между блоками. Ограничение в байтах важно, когда ключи или состояния агрегации имеют большую ширину: одного порога по количеству ключей было бы недостаточно, и такие таблицы могли бы превысить размер кешей CPU. При значении по умолчанию таблицы с обычной шириной ключей и состояний по-прежнему замораживаются по количеству ключей. 0 отключает ограничение в байтах, поэтому решение принимается только на основе порога по количеству ключей.

Добавляет HTTP-заголовок CORS.

Если в индексе таблицы используется пространственно-заполняющая кривая, например ORDER BY mortonEncode(x, y) или ORDER BY hilbertEncode(x, y), и запрос содержит условия для её аргументов, например x >= 10 AND x <= 20 AND y >= 20 AND y <= 30, используйте пространственно-заполняющую кривую для анализа индекса.

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

Включает устаревшее поведение сервера ClickHouse в операциях ANY INNER|LEFT JOIN.

Когда устаревшее поведение включено:

• Результаты операций t1 ANY LEFT JOIN t2 и t2 ANY RIGHT JOIN t1 не совпадают, поскольку ClickHouse использует логику отображения ключей таблиц слева направо по схеме «многие к одному».
• Результаты операций ANY INNER JOIN содержат все строки из левой таблицы, как и операции SEMI LEFT JOIN.

Когда устаревшее поведение отключено:

• Результаты операций t1 ANY LEFT JOIN t2 и t2 ANY RIGHT JOIN t1 совпадают, поскольку ClickHouse использует логику, обеспечивающую отображение ключей по схеме «один ко многим» в операциях ANY RIGHT JOIN.
• Результаты операций ANY INNER JOIN содержат по одной строке на каждый ключ из левой и правой таблиц.

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

• 0 — Устаревшее поведение отключено.
• 1 — Устаревшее поведение включено.

См. также:

• Строгость JOIN

Ограничивает максимальный размер адаптивного буфера, используемого при записи в архивы (например, tar-архивы

Тип дескриптора для запросов Arrow Flight. 'path' отправляет имя набора данных как дескриптор PATH. 'command' отправляет SQL-запрос как дескриптор команды (требуется для Dremio).

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

• 'path' — Использовать FlightDescriptor::Path (по умолчанию; работает с большинством серверов Arrow Flight)
• 'command' — Использовать FlightDescriptor::Command с запросом SELECT (требуется для Dremio)

Если установлено значение true, все потоки, выполняющие S3-запросы к одной и той же конечной точке резервного копирования, замедляются после того, как любой S3-запрос сталкивается с ошибкой S3, допускающей повторную попытку, например 'Slow Down'. Если установлено значение false, каждый поток обрабатывает задержку S3-запросов независимо от остальных.

Действует только в ClickHouse Cloud. Количество фоновых потоков для упреждающей загрузки новых частей данных в файловый кэш, если включен параметр cache_populated_by_fetch. 0 — отключить.

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

Отменяет HTTP-запросы только для чтения (например, SELECT), если клиент закрывает соединение, не дожидаясь ответа.

значение по умолчанию в Cloud: 1.

Проверяет контрольные суммы при чтении. Этот параметр включен по умолчанию и в продакшне должен быть включен всегда. Не стоит ожидать какой-либо выгоды от отключения этого параметра. Его можно использовать только для экспериментов и бенчмарков. Параметр применим только к таблицам семейства MergeTree. Для других движков таблиц и при получении данных по сети контрольные суммы проверяются всегда.

Применяет универсальное сжатие к телу ответа, например compression=gz. Обратите внимание, что эта настройка не связана с Content-Encoding (HTTP-сжатием) и устаревшим параметром compress (встроенным сжатием ClickHouse). Указание расширения сжатого файла в URL-пути имеет тот же эффект.

Это настройка HTTP-интерфейса, определяющая формат ответа: она применяется до выполнения запроса (буферы ответа настраиваются заранее), поэтому её необходимо указывать через URL-параметр HTTP-запроса, расширение файла в URL-пути или профиль пользователя, а не в предложении SETTINGS запроса (где она не действует и будет отклонена).

Время ожидания соединения в миллисекундах, если пул соединений переполнен.

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

• Положительное целое число.
• 0 — бесконечный тайм-аут.

Максимальное число попыток установить соединение с каждой репликой для движка таблицы Distributed.

Если установлено значение true, запрос SELECT будет преобразован в конъюнктивную нормальную форму (CNF). В некоторых случаях запрос, переписанный в CNF, может выполняться быстрее (объяснение см. в этом issue на Github).

Например, обратите внимание, что следующий запрос SELECT не изменяется (поведение по умолчанию):

EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = false;

Результат:

┌─explain────────────────────────────────────────────────────────┐
│ SELECT x                                                       │
│ FROM                                                           │
│ (                                                              │
│     SELECT number AS x                                         │
│     FROM numbers(20)                                           │
│     WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ ) AS a                                                         │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))     │
│ SETTINGS convert_query_to_cnf = 0                              │
└────────────────────────────────────────────────────────────────┘

Давайте зададим convert_query_to_cnf значение true и посмотрим, что изменится:

EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = true;

Обратите внимание, что предложение WHERE переписано в CNF, но результирующий набор остаётся тем же — булева логика не изменилась:

┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SELECT x                                                                                                              │
│ FROM                                                                                                                  │
│ (                                                                                                                     │
│     SELECT number AS x                                                                                                │
│     FROM numbers(20)                                                                                                  │
│     WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │
│ ) AS a                                                                                                                │
│ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5))     │
│ SETTINGS convert_query_to_cnf = 1                                                                                     │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

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

Останавливать подсчёт, как только в функции countMatches шаблон регулярного выражения даёт совпадение нулевой длины.

Использовать INNER JOIN вместо соединения через запятую/CROSS JOIN, если в предложении WHERE есть условия соединения. Значения: 0 — не переписывать, 1 — переписывать по возможности для соединения через запятую/CROSS JOIN, 2 — принудительно переписывать все соединения через запятую, CROSS JOIN — по возможности

Позволяет считать типы данных без явных модификаторов NULL or NOT NULL в определении столбца типом Nullable.

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

• 1 — Типы данных в определениях столбцов по умолчанию имеют тип Nullable.
• 0 — Типы данных в определениях столбцов по умолчанию не имеют тип Nullable.

Проверять переполнение при арифметических операциях и сравнениях Decimal

Включает или отключает проверку дедупликации для materialized view, получающих данные из таблиц Replicated*.

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

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

Если параметр включен, ClickHouse выполняет дедупликацию блоков в materialized view, зависящих от таблиц Replicated*. Этот параметр полезен, чтобы materialized view не содержали дублирующихся данных, если операция вставки повторяется из-за сбоя.

См. также

• Обработка NULL в операторах IN

Когда параметр включен (по умолчанию), для запросов FINAL к таблицам, у которых столбцы ключа партиции не входят в ключ сортировки, отсечение партиций не выполняется. Это безопасное с точки зрения корректности поведение, добавленное в 26.3: FINAL может потребоваться выполнить дедупликацию строк с одинаковым первичным ключом, но находящихся в разных партициях, а отсечение партиций молча исключило бы такие строки из входных данных для дедупликации.

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

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

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

• 0 — Применять отсечение партиций до FINAL (поведение до 26.3, быстрее, но в общем случае небезопасно).
• 1 — Откладывать отсечение партиций до выполнения FINAL (по умолчанию, безопасно с точки зрения корректности).

Если установлено значение true, в результат запроса DESCRIBE включаются только имена столбцов и типы

Диалект, используемый для разбора запроса.

Поддерживаемые значения:

• clickhouse (по умолчанию) — стандартный ClickHouse SQL.
• kusto — Kusto Query Language. Требует экспериментальной настройки allow_experimental_kusto_dialect.
• prql — PRQL. Требует экспериментальной настройки allow_experimental_prql_dialect.
• polyglot — транспилирует SQL из других диалектов (MySQL, PostgreSQL и т. д.) в ClickHouse SQL. Требует экспериментальной настройки allow_experimental_polyglot_dialect.
• promql — PromQL (Prometheus Query Language), выполняемый для таблицы TimeSeries, настроенной с помощью параметров promql_database, promql_table и promql_evaluation_time.
• clickhouse_json — вместо текста SQL запрос интерпретируется как JSON AST (результат работы parseQueryToJSON). Запрос SET по-прежнему распознаётся в обычной форме, что позволяет переключиться обратно на другой диалект. Требует экспериментальной настройки enable_json_ast_dialect.

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

Используется для теневого трафика, бенчмарков и фаззинга.

Не влияет на вторичные запросы.

Действует только для собственного TCP-протокола.

Определяет, что происходит, когда объём данных превышает один из лимитов.

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

• throw: сгенерировать исключение (по умолчанию).
• break: прекратить выполнение запроса и вернуть частичный результат, как если бы исходные данные исчерпались.

Повышает производительность запросов FINAL, избегая слияний между разными партициями.

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

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

• true (по умолчанию) — сгенерировать исключение.
• false — вместо этого возвращать NULL для таких строк.

Если параметр включен, разрешены только идентификаторы, содержащие буквенно-цифровые символы и символы подчеркивания.

Включает или отключает пропуск пустых файлов в таблицах движка URL.

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

• 0 — SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
• 1 — SELECT возвращает пустой результат, если файл пуст.

Если параметр включен, ClickHouse будет возвращать точное значение статистики rows_before_limit_at_least, но ценой того, что данные до LIMIT придется прочитать полностью

Задает режим по умолчанию для запроса EXCEPT. Возможные значения: пустая строка, 'ALL', 'DISTINCT'. Если значение пустое, запрос без режима сгенерирует исключение.

Исключает указанные индексы пропуска данных из построения и хранения при операциях INSERT. Исключённые индексы пропуска данных всё равно будут строиться и сохраняться при слиянии или явным запросом MATERIALIZE INDEX.

Не имеет эффекта, если materialize_skip_indexes_on_insert равно false.

Пример:

CREATE TABLE tab
(
    a UInt64,
    b UInt64,
    INDEX idx_a a TYPE minmax,
    INDEX idx_b b TYPE set(3)
)
ENGINE = MergeTree ORDER BY tuple();

SET exclude_materialize_skip_indexes_on_insert='idx_a'; -- idx_a will be not be updated upon insert
--SET exclude_materialize_skip_indexes_on_insert='idx_a, idx_b'; -- neither index would be updated on insert

INSERT INTO tab SELECT number, number / 50 FROM numbers(100); -- only idx_b is updated

-- since it is a session setting it can be set on a per-query level
INSERT INTO tab SELECT number, number / 50 FROM numbers(100, 100) SETTINGS exclude_materialize_skip_indexes_on_insert='idx_b';

ALTER TABLE tab MATERIALIZE INDEX idx_a; -- this query can be used to explicitly materialize the index

SET exclude_materialize_skip_indexes_on_insert = DEFAULT; -- reset setting to default

Выполнять некоррелированные подзапросы EXISTS как скалярные подзапросы. Как и для скалярных подзапросов, используется кэш, а к результату применяется свёртка констант.

Значение по умолчанию в Cloud: 0.

Формат, используемый по умолчанию для EXPLAIN PLAN.

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

• pretty (значение по умолчанию с 26.7) — для actions, compact и pretty по умолчанию используется true, что даёт компактный, удобочитаемый план с аннотациями действий.
• legacy — формат вывода до 26.7.

Если в операторе EXPLAIN явно указаны параметры actions, compact или pretty (например, EXPLAIN actions = 0, compact = 0, pretty = 0 SELECT ...), они всегда переопределяют эту настройку.

Для EXPLAIN PLAN с json = 1 или distributed = 1 сохраняются прежние значения по умолчанию (legacy, до 26.7) независимо от этой настройки, если только actions, compact или pretty не заданы явно. Формат pretty не может представлять результаты JSON или распределённые планы по сегментам, поэтому эти режимы корректно отображаются только в формате legacy.

Возвращает результат EXPLAIN SYNTAX в виде одной записи (со встроенными переводами строк), а не отдельной записи для каждой строки, благодаря чему результат представляет собой одну строку, которую можно извлечь (например, SELECT count() FROM (EXPLAIN SYNTAX ...) возвращает 1).

Явное указание параметра single_record в операторе EXPLAIN SYNTAX (например, EXPLAIN SYNTAX single_record = 0 SELECT ...) всегда переопределяет эту настройку.

Установите значение false, чтобы восстановить вывод в формате, использовавшемся до версии 26.8: одна запись на строку, или задайте для compatibility любую версию ниже 26.8.

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

Максимальное количество пар, которое может вернуть функция extractKeyValuePairs. Используется как защита от чрезмерного потребления памяти.

Определяет, нужно ли учитывать экстремальные значения (минимальные и максимальные значения в столбцах результата запроса). Принимает значения 0 или 1. По умолчанию — 0 (отключено). Подробнее см. в разделе «Экстремальные значения».

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

ClickHouse выбирает наиболее подходящую из устаревших реплик таблицы.

Используется при выполнении SELECT из distributed таблицы, указывающей на реплицируемые таблицы.

По умолчанию: 1 (включено).

Стратегия партиционирования по умолчанию для file-like движков. Применяется только к запросам CREATE, в которых путь не содержит glob или плейсхолдер {_partition_id}. Для пути с {_partition_id} всегда используется wildcard. Для пути с другим glob стратегия партиционирования не используется, а PARTITION BY игнорируется. Если для этого параметра установлено значение wildcard, но путь не содержит {_partition_id}, стратегия партиционирования не используется; движки таблиц, которые не могут сохранить это решение в аргументах движка (например, HDFS), отклоняют такой CREATE.

Максимальное количество операций предварительного чтения. Ноль означает отсутствие ограничений. Если нужно ограничить количество операций предварительного чтения, рекомендуется использовать настройку filesystem_prefetches_max_memory_usage

Добавляет к запросу предложение WHERE, оборачивая его в подзапрос. Несколько фильтров объединяются с помощью AND. HTTP-интерфейс позволяет указывать несколько URL-параметров filter, которые объединяются с помощью AND в заданном порядке и со значением этой настройки.

Это настройка построения запроса: движок применяет её к разобранному запросу, оборачивая его как производную таблицу. Поэтому она сочетается с существующим запросом и работает при любом протоколе: её можно передать через URL-параметр HTTP-запроса, предложение SETTINGS в запросе или профиль пользователя.

Она применяется к запросам SELECT / UNION, возвращающим результат. Для запросов записи (INSERT … SELECT, CREATE … AS SELECT) она действует только при указании в собственном предложении SETTINGS исходного SELECT; значение, унаследованное от профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не передаётся исходному SELECT — как и любая другая настройка.

Автоматически применяет модификатор FINAL ко всем таблицам в запросе, для которых применим FINAL, включая таблицы, участвующие в JOIN, таблицы в подзапросах, а также distributed таблицы.

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

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

Пример:

CREATE TABLE test
(
    key Int64,
    some String
)
ENGINE = ReplacingMergeTree
ORDER BY key;

INSERT INTO test FORMAT Values (1, 'first');
INSERT INTO test FORMAT Values (1, 'second');

SELECT * FROM test;
┌

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

Задаёт формат данных для столбцов типа Nested.

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

• 1 — столбец Nested преобразуется в отдельные массивы.
• 0 — столбец Nested остаётся единым массивом кортежей.

Использование

Если для этой настройки установлено значение 0, можно использовать произвольный уровень вложенности.

Примеры

Запрос:

SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;

Результат:

┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n.a` Array(UInt32),
    `n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Запрос:

SET flatten_nested = 0;

CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;

Результат:

┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Переопределяет FORMAT запроса для входных и выходных данных. Имеет приоритет над форматом, указанным в запросе и расширении файла. Более специфичные настройки input_format и output_format имеют приоритет над этой общей настройкой format для соответствующего направления.

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

Форматы кадрирования не зависят от выходных форматов: они инкапсулируют байты, создаваемые любым выходным форматом, разделяя и при необходимости кодируя эти фрагменты. Конкатенация полезных нагрузок всех пакетов data, totals и extremes в точности соответствует тому, что выходной формат создал бы без кадрирования. Вспомогательные пакеты (прогресс, журналы, события профилирования, исключения) представлены в JSON.

Одно преднамеренное исключение: выходной формат, который не выводит итоги и экстремумы в обычном выводе, поскольку не может их представить (семейство JSONCompactEachRow), при кадрировании всё же помещает их в пакеты totals и extremes. Для таких форматов конкатенация только пакетов data в точности соответствует выводу без кадрирования, а пакеты totals и extremes содержат дополнительные строки, отсутствующие в выводе без кадрирования.

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

Успешный поток завершается финальным пакетом progress с итоговыми счётчиками (result_rows, result_bytes, memory_usage), записываемым после завершающих пакетов log и profile_events, отправленных при журналировании завершения запроса, как и финальный пакет прогресса собственного протокола. При ошибке последним становится пакет exception, за одним исключением: если ошибка возникает после того, как часть потока пакетов уже записана в ответ и больше не может быть отброшена (ошибка возникает при записи пакета, не удаётся доставить сам пакет exception либо поток ответа завершается ошибкой при сбросе или закрытии), кадрирование завершается с закрытием: поток прекращается без завершающего пакета exception, а клиент вместо разбираемого завершающего пакета получает усечённый ответ и прерванное HTTP-соединение. После частичного потока пакетов ничего не добавляется, поэтому обычное тело HTTP-ошибки никогда не смешивается с ним.

Всё, что запрос включает только через собственную секцию SETTINGS — формат кадрирования, send_logs_level или send_profile_events, — становится известно лишь после разбора запроса, поэтому соответствующие журналы и события профилирования собираются только начиная с выполнения запроса. Журналы и события профилирования этапов разбора, планирования и анализа собираются только тогда, когда настройка задана в сеансе или URL. Например, запрос, который завершается ошибкой во время анализа (например, из-за ссылки на неизвестную таблицу) и включает send_logs_level только в собственной секции SETTINGS, передаёт лишь пакет exception, но не журналы этапа анализа; чтобы собрать их, задайте send_logs_level в сеансе или URL.

То же ограничение позднего обнаружения относится к send_logs_source_regexp: очередь журналов фильтрует записи по источнику в момент захвата каждой записи, поэтому регулярное выражение, заданное только в собственной секции SETTINGS запроса, действует лишь начиная с выполнения запроса. Пакеты log этапов разбора, планирования и анализа фильтруются по значению настройки из сеанса или URL (если там настройка не задана, они не фильтруются), поэтому могут включать источники, не соответствующие регулярному выражению уровня запроса; и наоборот, записи, отброшенные более узким регулярным выражением из сеанса или URL, не восстанавливаются более широким регулярным выражением уровня запроса. Задайте send_logs_source_regexp в сеансе или URL, чтобы фильтровать весь жизненный цикл запроса.

В настоящее время настройка применяется к HTTP-протоколу и игнорируется для других интерфейсов.

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

• None — прозрачно направляет всё применимое (данные, итоги, экстремумы, прогресс) в выходной формат и игнорирует всё неприменимое (метрики, журналы), поэтому по умолчанию всё работает как есть.
• EventStream — оформляет пакеты как HTTP-события, отправляемые сервером (text/event-stream). Каждый пакет отправляется как событие с соответствующим именем: data, totals, extremes, progress, log, profile_events, exception. Прогресс и другие вспомогательные пакеты отправляются в формате JSON. Поскольку события, отправляемые сервером, используют текстовый протокол, в котором переводы строк (включая возврат каретки, \r) считаются разделителями, блок форматированных данных кодируется в Base64 и помещается в единственное поле события data. При декодировании оно содержит полностью отформатированную полезную нагрузку со всеми переводами строк; в Content-Type для этого указывается параметр payload=base64. Таким способом можно передать любой выходной формат с точным сохранением байтов — как текстовый, так и бинарный.
• JSONEachPacketBase64 — каждый пакет представляет собой объект JSON в отдельной строке, а форматированные данные кодируются в Base64, например: {"packet":"data","data":"eyJ4IjoxfQo="}. Подходит для бинарных выходных форматов.
• JSONEachPacketString — каждый пакет представляет собой объект JSON в отдельной строке, а форматированные данные помещаются в строку, например: {"packet":"data","data":"{\"x\":1}\n"}.

JSONEachPacketString помещает байты полезной нагрузки в JSON-строку без их проверки или повторного кодирования. Столбцы String и FixedString могут содержать произвольные байты, поэтому текстовые выходные форматы (такие как JSONEachRow, TSV или CSV) могут выводить для таких значений недопустимые последовательности UTF-8 — так же, как собственный формат JSONEachRow ClickHouse при значении по умолчанию output_format_json_validate_utf8 = 0, — и в результате поток NDJSON может не быть допустимым UTF-8. Используйте JSONEachPacketBase64 для передачи произвольных байтов с точным сохранением байтов.

Пример:

curl "http://localhost:8123/?framing_output_format=JSONEachPacketString" -d "SELECT number FROM numbers(3) FORMAT JSONEachRow"

Результат:

{"packet":"data","data":"{\"number\":\"0\"}\n{\"number\":\"1\"}\n{\"number\":\"2\"}\n"}
{"packet":"profile_events","profile_events":[{"host_name":"localhost","current_time":"2026-07-11 00:00:00","thread_id":"0","type":"increment","name":"SelectedRows","value":"3"}]}
{"packet":"progress","progress":{"read_rows":"3","read_bytes":"24","total_rows_to_read":"3","result_rows":"3","result_bytes":"24","elapsed_ns":"1265958"}}

Включает или отключает fsync при записи файлов .sql. По умолчанию включено.

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

Если false, функции h3, например h3CellAreaM2, генерируют исключение при недопустимых входных данных. Если true, они возвращают 0 или значение по умолчанию.

Если все четыре аргумента функций geoDistance, greatCircleDistance, greatCircleAngle имеют тип Float64, то возвращается Float64, а для внутренних вычислений используется двойная точность. В предыдущих версиях ClickHouse эти функции всегда возвращали Float32.

Функция 'geoToH3' принимает (lon, lat), если установлено значение 'lon_lat', и (lat, lon), если установлено значение 'lat_lon'.

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

Функция 'h3ToGeo' возвращает (lon, lat), если установлено значение true, иначе — (lat, lon).

Тайм-аут в миллисекундах на получение пакета Hello от реплик во время рукопожатия.

Тайм-аут на установление соединения с репликой для Hedged requests

Задаёт максимальное количество совпадений подсветки на строку в функции highlight. Используйте её, чтобы предотвратить чрезмерное использование памяти при подсветке часто повторяющихся шаблонов в больших текстах.

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

• Положительное целое число.

Размер динамического списка кандидатов при поиске по индексу векторного сходства, также называемый ef_search.

Время действия HSTS. Значение 0 отключает HSTS.

Тайм-аут закрытия бездействующих TCP-соединений по истечении указанного количества секунд.

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

• Положительное целое число (0 — закрыть немедленно, через 0 секунд).

Если включено, добавляет 'ORDER BY rand()' в SELECT-запросы без предложения ORDER BY. Применяется только при глубине подзапроса = 0. Подзапросы и INSERT INTO … SELECT не затрагиваются. Если конструкция верхнего уровня — UNION, 'ORDER BY rand()' добавляется во все дочерние части независимо. Полезно только для тестирования и разработки (отсутствие ORDER BY — источник недетерминированных результатов запроса).

Переопределяет формат входных данных запроса. Имеет приоритет над форматом, указанным в запросе.

Интервал в микросекундах для проверки отмены выполнения запроса и отправки Прогресса.

Задаёт режим по умолчанию для запроса INTERSECT. Возможные значения: пустая строка, 'ALL', 'DISTINCT'. Если указана пустая строка, запрос без режима сгенерирует исключение.

Если включено, функции 'least' и 'greatest' возвращают NULL, если один из аргументов равен NULL.

Использует в именах столбцов больших литералов Tuple имена всех элементов вместо хеша. Эта настройка существует только из соображений совместимости. Имеет смысл установить значение 'true' при выполнении rolling update кластера с версии ниже 21.7 на версию выше.

Задаёт максимальное число строк в результате запроса. Корректирует значение, заданное в предложении LIMIT. Значение передаётся в LIMIT и допускает всё, что допускает LIMIT, включая отрицательные значения (отсчёт ведётся с конца результата) и дробные значения в диапазоне (0, 1) (интерпретируются как доля результата).

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

• 0 — число строк не ограничено.
• Положительное целое число — точное число строк.
• Отрицательное целое число — вернуть последние N строк.
• Вещественное число в открытом диапазоне (0, 1) — вернуть указанную долю результата.

Этот параметр влияет на запросы SELECT / UNION, возвращающие результат. Для запросов записи (INSERT … SELECT, CREATE … AS SELECT) он действует, только если исходный SELECT содержит его в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не передаётся в исходный SELECT — как и любой другой параметр.

Асинхронно загружать метки MergeTree

Значение по умолчанию в Cloud: 1.

Определяет, сколько секунд запрос на блокировку ожидает, прежде чем завершиться ошибкой.

Тайм-аут блокировки используется для защиты от взаимных блокировок при выполнении операций чтения и записи в таблицах. Когда время ожидания истекает и запрос на блокировку завершается ошибкой, сервер ClickHouse генерирует исключение "Locking attempt timed out! Possible deadlock avoided. Client should retry." с кодом ошибки DEADLOCK_AVOIDED.

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

• Положительное целое число (в секундах).
• 0 — тайм-аут блокировки отсутствует.

Когда используется механизм приоритизации запросов (см. настройку priority), запросы с низким приоритетом ждут завершения запросов с более высоким приоритетом. Эта настройка указывает время ожидания.

Формирует распределённый план запроса.

При включении автоматически корректируются настройки, управляющие возможностями, которые пока не поддерживаются распределёнными планами запросов:

• enable_parallel_replicas = 0 и automatic_parallel_replicas_mode = 0 — распределённый план самостоятельно распределяет работу;
• correlated_subqueries_use_in_memory_buffer = 0;
• use_skip_indexes_on_data_read = 0;
• compile_expressions = 0;
• query_plan_direct_read_from_text_index = 0.

При создании таблицы Merge без явного указания схемы или при использовании табличной функции merge схема определяется как объединение не более указанного количества подходящих таблиц. Если таблиц больше, схема будет определена по первым таблицам в указанном количестве.

Если параметр включен, таблицы MongoDB возвращают ошибку, когда не удается сформировать запрос MongoDB. В противном случае ClickHouse читает всю таблицу и обрабатывает ее локально. Этот параметр не действует, если allow_experimental_analyzer=0.

Не добавлять псевдонимы в список выражений верхнего уровня при переписывании запроса с несколькими JOIN

Приводить имена функций к каноническому виду

Задаёт количество строк, пропускаемых перед началом возврата строк запроса. Корректирует смещение, заданное предложением OFFSET. Значение передаётся в OFFSET и может принимать всё, что допускает OFFSET, включая отрицательные значения и дроби в (0, 1).

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

• 0 — строки не пропускаются.
• Положительное целое число.
• Отрицательное целое число.
• Вещественное число в открытом диапазоне (0, 1) — пропускается соответствующая доля результата.

Пример

Входная таблица:

CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);

Запрос:

SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;

Результат:

┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘

Этот параметр определяет поведение запросов SELECT / UNION, возвращающих результат. Для запроса записи (INSERT … SELECT, CREATE … AS SELECT) он действует только тогда, когда исходный SELECT содержит его в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не передаётся исходному SELECT — как и любой другой параметр.

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

Это настройка построения запроса: движок применяет её к разобранному запросу, оборачивая его в производную таблицу. Поэтому она сочетается с существующим запросом и работает по любому протоколу: её можно задать через URL-параметр HTTP-запроса, предложение SETTINGS в запросе или профиль пользователя.

Она применяется к запросам SELECT / UNION, возвращающим результаты. Для запроса записи (INSERT … SELECT, CREATE … AS SELECT) она действует, только если исходный SELECT содержит её в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не передаётся в исходный SELECT — как и любая другая настройка.

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

Задаёт номер страницы для постраничной выдачи. Эквивалентна offset = limit * (page - 1). Может быть задана только при установленном limit и неустановленном offset. Нумерация страниц начинается с 1. Поддерживает отрицательные и дробные значения так же, как limit и offset.

Это настройка построения запроса: движок применяет её к разобранному запросу, оборачивая его в производную таблицу. Поэтому она сочетается с существующим запросом и работает по любому протоколу: её можно передать через URL-параметр HTTP-запроса, предложение SETTINGS в запросе или профиль пользователя.

Она влияет на запросы SELECT / UNION, возвращающие результаты. Для запроса записи (INSERT … SELECT, CREATE … AS SELECT) она действует только в том случае, если исходный SELECT содержит её в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не передаётся исходному SELECT — как и любая другая настройка.

Чтение указанного снимка на уровне запроса для инкрементального режима Paimon. Если значение >0, модуль чтения будет получать только дельту для указанного snapshot_id, не продвигая зафиксированную водяную метку. По умолчанию: -1 (отключено)

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

Позволяет запросу вернуть частичный результат после отмены.

Записывает в журнал статистику индекса по каждой части

Блокирует сервер в цикле ожидания запроса на указанное количество секунд.

Исходный диалект SQL для транспайлера polyglot (например, 'sqlite', 'mysql', 'postgresql', 'snowflake', 'duckdb').

Приблизительная вероятность сбоя при выполнении внутренних запросов PostgreSQL (для репликации). Допустимое значение — в интервале [0.0f, 1.0f]

Собирает статистику селективности предикатов в system.predicate_statistics_log. Если установлено значение N > 0, выборка включает примерно 1/N запросов (по Query id). 0 означает, что сбор отключён.

Максимальный размер буфера предвыборки для чтения из файловой системы. Значения свыше 256 МиБ принудительно ограничиваются до 256 МиБ, так как буфер чтения не требует большего размера.

Позволяет выводить имена глубоко вложенных типов в удобочитаемом виде с отступами в запросе DESCRIBE и функции toTypeName().

Пример:

CREATE TABLE test (a Tuple(b String, c Tuple(d Nullable(UInt64), e Array(UInt32), f Array(Tuple(g String, h Map(String, Array(Tuple(i String, j UInt64))))), k Date), l Nullable(String))) ENGINE=Memory;
DESCRIBE TABLE test FORMAT TSVRaw SETTINGS print_pretty_type_names=1;

a   Tuple(
    b String,
    c Tuple(
        d Nullable(UInt64),
        e Array(UInt32),
        f Array(Tuple(
            g String,
            h Map(
                String,
                Array(Tuple(
                    i String,
                    j UInt64
                ))
            )
        )),
        k Date
    ),
    l Nullable(String)
)

Приоритет запроса. 1 — наивысший приоритет, большее значение — более низкий приоритет; 0 — приоритеты не используются.

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

Интервал в миллисекундах, с которым собираются данные query_metric_log для отдельных запросов.

Если задано любое отрицательное значение, используется значение collect_interval_milliseconds из настройки query_metric_log, а если оно отсутствует — значение 1000 по умолчанию.

Чтобы отключить сбор данных для отдельного запроса, установите query_metric_log_interval в 0.

Значение по умолчанию: -1

Время ожидания в очереди запросов, если число одновременных запросов превышает максимальное.

Время ожидания при чтении из RabbitMQ перед повторной попыткой.

0 — ограничений режима «только для чтения» нет. 1 — только запросы на чтение, а также изменение явно разрешённых настроек. 2 — только запросы на чтение, а также изменение настроек, кроме настройки 'readonly'.

Максимальное количество итераций для определения типов столбцов в рекурсивных CTE. Типы столбцов определяются итеративным применением getLeastSupertype к нерекурсивной и рекурсивной частям UNION ALL до достижения сходимости. Установите 0, чтобы отключить расширение типов и использовать только типы из нерекурсивной части.

Устанавливает максимальное число совпадений одного регулярного выражения для одной строки. Используйте эту настройку, чтобы предотвратить переполнение памяти при использовании жадного регулярного выражения в функции extractAllGroupsHorizontal.

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

• Положительное целое число.

Отклонять шаблоны, проверка которых с помощью hyperscan, вероятно, потребует больших затрат ресурсов (из-за взрывного роста числа состояний NFA)

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

Минимальное количество байт для удалённого чтения (url, s3), при котором выполняется seek вместо чтения с пропуском данных.

• Тип: String

• Значение по умолчанию: Пустая строка

Эта настройка позволяет задать шаблон переименования файлов, обработанных табличной функцией file. Если параметр задан, все файлы, прочитанные табличной функцией file, будут переименованы по указанному шаблону с плейсхолдерами, но только если их обработка завершилась успешно.

• %a — Полное имя исходного файла (например, "sample.csv").
• %f — Имя исходного файла без расширения (например, "sample").
• %e — Расширение исходного файла с точкой (например, ".csv").
• %t — Временная метка (в микросекундах).
• %% — Знак процента ("%").

• Опция: --rename_files_after_processing="processed_%f_%t%e"

• Запрос: SELECT * FROM file('sample.csv')

Если файл sample.csv успешно прочитан, он будет переименован в processed_sample_1683473210851438.csv

Указывает, сколько времени (в секундах) ждать, пока неактивные реплики выполнят запросы ALTER, OPTIMIZE или TRUNCATE.

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

• 0 — Не ждать.
• Отрицательное целое число — Ждать неограниченно долго.
• Положительное целое число — Количество секунд ожидания.

Используется в планировании рабочих нагрузок. Минимальный объём оперативной памяти, резервируемый для выполнения запроса на одном сервере. Резервирование выполняется через иерархию WORKLOAD с использованием значения настройки запроса workload. Если для рабочей нагрузки недостаточно доступной памяти, запрос не запускается и остаётся в состоянии pending, пока резервирование не станет возможным. Значение 0 означает, что резервирование не выполняется. Эта настройка действует только в том случае, если создан ресурс MEMORY RESERVATION.

Заменяет движок таблицы ReplicatedMergeTree на SharedMergeTree при RESTORE.

Значение по умолчанию в Cloud: 1.

Определяет, что делать, если объём результата превышает одно из ограничений.

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

• throw: сгенерировать исключение (по умолчанию).
• break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные были исчерпаны.

Использование 'break' похоже на использование LIMIT. Break прерывает выполнение только на уровне блока. Это означает, что количество возвращённых строк будет больше, чем max_result_rows, кратно max_block_size и зависит от max_threads.

Пример

SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';

SELECT *
FROM numbers_mt(100000)
FORMAT Null;

6666 rows in set. ...

Включает возобновляемый BACKUP FROM SNAPSHOT: неудачную попытку можно повторить без повторного копирования элементов уже завершённых батчей. Доступно только в ClickHouse Cloud для пунктов назначения S3 и AzureBlobStorage в виде каталогов. В сборках ClickHouse с открытым исходным кодом, где сам BACKUP FROM SNAPSHOT недоступен, включение этой настройки приводит к ошибке BACKUP с WRONG_BACKUP_SETTINGS.

Если включено, ClickHouse будет возвращать точное значение статистики rows_before_aggregation, которая показывает количество строк, прочитанных до агрегации

Если включено, сервер планирует выполнение запроса в фоновом режиме, немедленно возвращает пустой успешный результат и выполняет запрос до завершения независимо от состояния подключения.

Фоновый запрос не сохраняется после перезапуска сервера. При остановке сервера к нему применяются те же настройки сервера, что и к обычному запросу: shutdown_wait_unfinished_queries определяет, отменить запрос или дождаться его завершения (записи в очереди в любом случае отбрасываются без записи в system.query_log), а shutdown_wait_unfinished ограничивает время ожидания сервером.

Отслеживайте запрос по его query_id: в system.processes во время выполнения и в system.query_log после завершения и сброса записи журнала запросов на диск.

Применяется к запросам, полученным по нативным TCP- и HTTP-протоколам. При использовании HTTP передавайте настройку как URL-параметр. Её нельзя изменить с помощью SET; включайте её для каждого запроса либо на уровне пользователя или профиля.

Основной сценарий использования — длительный INSERT ... SELECT, который не должен быть потерян при разрыве клиентского подключения.

Включает алгоритм пакетной фильтрации для индексов. Предполагается, что он всегда эффективнее, но эта настройка оставлена для совместимости и дополнительного контроля.

Оборачивает запрос в подзапрос с явным списком выражений SELECT. Если значение не пустое, запрос, формирующий результат, оборачивается в SELECT <expr_list> FROM (<query>).

Это настройка построения запроса, которую движок применяет к разобранному запросу, оборачивая его в производную таблицу. Поэтому она сочетается с существующим запросом и работает с любым протоколом: её можно передать через URL-параметр HTTP-запроса, предложение SETTINGS в запросе или профиль пользователя.

Она задаёт форму запросов SELECT / UNION, формирующих результат. Для запроса записи (INSERT … SELECT, CREATE … AS SELECT) она действует, только если исходный SELECT содержит её в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не распространяется на исходный SELECT — это то же правило нераспространения, что и для любой другой настройки.

Включает или отключает последовательную согласованность для запросов SELECT. Требует, чтобы insert_quorum_parallel был отключен (по умолчанию он включен).

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

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

Использование

Когда последовательная согласованность включена, ClickHouse позволяет клиенту выполнять запрос SELECT только на тех репликах, которые содержат данные из всех предыдущих запросов INSERT, выполненных с insert_quorum. Если клиент обращается к неполной реплике, ClickHouse выдаст исключение. Запрос SELECT не будет включать данные, которые еще не были записаны в кворум реплик.

Когда insert_quorum_parallel включен (по умолчанию), select_sequential_consistency не работает. Это связано с тем, что параллельные запросы INSERT могут записываться в разные наборы кворумных реплик, поэтому нет гарантии, что одна реплика получит все записи.

См. также:

• insert_quorum
• insert_quorum_timeout
• insert_quorum_parallel

Задаёт неявный часовой пояс для текущего сеанса или запроса. Неявный часовой пояс применяется к значениям типа DateTime/DateTime64, для которых часовой пояс явно не указан. Этот параметр имеет приоритет над неявным часовым поясом, глобально настроенным на уровне сервера. Значение '' (пустая строка) означает, что неявный часовой пояс текущего сеанса или запроса совпадает с часовым поясом сервера.

Чтобы получить часовой пояс сеанса и часовой пояс сервера, можно использовать функции timeZone() и serverTimeZone().

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

• Любое имя часового пояса из system.time_zones, например Europe/Berlin, UTC или Zulu

Примеры:

SELECT timeZone(), serverTimeZone() FORMAT CSV

"Europe/Berlin","Europe/Berlin"

SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV

"Asia/Novosibirsk","Europe/Berlin"

Назначьте внутреннему DateTime без явно заданного часового пояса часовой пояс сеанса 'America/Denver':

SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV

1999-12-13 07:23:23.123

CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');

SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
0 rows in set.

SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
┌

Это происходит из-за различий в конвейерах разбора:

• toDateTime() без явно указанного часового пояса, используемая в первом запросе SELECT, учитывает настройку session_timezone и глобальный часовой пояс.
• Во втором запросе значение DateTime разбирается из строки и наследует тип и часовой пояс существующего столбца d. Поэтому ни настройка session_timezone, ни глобальный часовой пояс не учитываются.

См. также

• timezone

Определяет, что произойдёт, если объём данных превысит одно из ограничений.

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

• throw: сгенерировать исключение (по умолчанию).
• break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные закончились.

Для одиночного JOIN при неоднозначности идентификатора использовать левую таблицу

Избыточные псевдонимы не используются (не подставляются) в пользовательских функциях, что упрощает их использование.

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

• 1 — Псевдонимы пропускаются (заменяются своими выражениями) в UDF.
• 0 — Псевдонимы не пропускаются (не заменяются своими выражениями) в UDF.

Пример

Разница между включенным и отключенным состоянием:

Запрос:

SET skip_redundant_aliases_in_udf = 0;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));

EXPLAIN SYNTAX SELECT test_03274(4 + 2);

Результат:

SELECT ((4 + 2) + 1 AS y, y + 2)

Запрос:

SET skip_redundant_aliases_in_udf = 1;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));

EXPLAIN SYNTAX SELECT test_03274(4 + 2);

Результат:

SELECT ((4 + 2) + 1, ((4 + 2) + 1) + 2)

Время паузы после получения запроса в TCPHandler

Управляет форматом передачи данных, используемым для сжатия snappy при универсальных путях файлового ввода-вывода, таких как file и url. HTTP Content-Encoding: snappy всегда использует формат framing и не учитывает эту настройку.

Обратите внимание: необработанный блоковый формат snappy, создаваемый одним вызовом snappy::Compress (например, полезная нагрузка протокола Prometheus remote, обрабатываемая SnappyBasicReadBuffer), представляет собой отдельный формат передачи данных, специфичный для протокола, и не управляется этой настройкой.

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

• basic — блоковый формат Hadoop snappy. Совместим с файлами, которые Hadoop читает и записывает. Поддерживает и чтение, и запись.
• framed — формат framing для Snappy, стандартный стриминг-формат, определённый Google. Поддерживает и чтение, и запись.

Добавляет к запросу простое предложение ORDER BY, оборачивая его в подзапрос. Принимает разделённый запятыми список идентификаторов или позиционных ссылок на столбцы (положительных целых чисел) с необязательным префиксом + (ASC) или - (DESC). Пример: sort=a,-b сортирует по a по возрастанию, а по b — по убыванию; sort=1,-2 сортирует по первому столбцу по возрастанию, а по второму — по убыванию. Нельзя использовать вместе с order.

Это настройка построения запроса, которую движок применяет к разобранному запросу, оборачивая его в производную таблицу. Поэтому она сочетается с существующим запросом и работает с любым протоколом: её можно передать через URL-параметр HTTP-запроса, предложение SETTINGS внутри запроса или профиль пользователя.

Она влияет на запросы SELECT / UNION, возвращающие результаты. Для запроса записи (INSERT … SELECT, CREATE … AS SELECT) она действует, только если исходный SELECT содержит её в собственном предложении SETTINGS; значение, унаследованное из профиля или сеанса либо заданное в самом операторе INSERT / CREATE, не распространяется на исходный SELECT — как и в случае с любой другой настройкой.

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

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

• throw: сгенерировать исключение.
• break: остановить выполнение запроса и вернуть частичный результат.

Управляет тем, будет ли функция splitBy*() с аргументом max_substrings > 0 включать оставшуюся часть строки в последний элемент результирующего массива.

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

• 0 - Оставшаяся часть строки не будет включена в последний элемент результирующего массива.
• 1 - Оставшаяся часть строки будет включена в последний элемент результирующего массива. Такое поведение соответствует функции split() в Spark и методу 'string.split()' в Python.

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

При запуске сервера отключает планирование refreshable materialized views, как если бы была выполнена команда SYSTEM STOP VIEWS. Позже их можно вручную запустить с помощью SYSTEM START VIEWS или SYSTEM START VIEW <name>. Это также относится к вновь созданным представлениям. Не влияет на materialized views, не являющиеся refreshable.

Время в секундах, в течение которого соединение должно оставаться неактивным, прежде чем TCP начнет отправлять keepalive-пакеты

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

Разрешает или запрещает пустые INSERT-запросы; по умолчанию включена (при пустой вставке генерируется ошибка). Применяется только к INSERT-запросам, выполняемым через clickhouse-client или gRPC-интерфейс.

Читать из таблицы последних образцов таблицы TimeSeries вместо основной таблицы образцов, если весь запрошенный временной диапазон целиком укладывается в окно TTL таблицы последних образцов (см. настройку recent_samples_ttl_seconds движка таблицы TimeSeries).

Проверяет, не слишком ли низка скорость выполнения (не ниже min_execution_speed), по истечении указанного времени в секундах.

Определяет, что происходит, когда объём данных превышает одно из ограничений.

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

• throw: сгенерировать исключение (по умолчанию).
• break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные закончились.

Включает сравнение значений NULL как равных для оператора IN.

По умолчанию значения NULL сравнивать нельзя, поскольку NULL означает неопределённое значение. Поэтому сравнение expr = NULL всегда должно возвращать false. При включении этой настройки выражение NULL = NULL для оператора IN возвращает true.

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

• 0 — Сравнение значений NULL в операторе IN возвращает false.
• 1 — Сравнение значений NULL в операторе IN возвращает true.

Пример

Рассмотрим таблицу null_in:

┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
│    3 │     3 │
└──────┴───────┘

Запрос:

SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;

Результат:

┌──idx─┬────i─┐
│    1 │    1 │
└──────┴──────┘

Запрос:

SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;

Результат:

┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
└──────┴───────┘

См. также

• Обработка NULL в операторах IN

Обходить замороженные данные (теневой каталог) наряду с данными самой таблицы при запросе system.remote_data_paths

Задает режим объединения результатов SELECT-запросов. Эта настройка используется только при работе с UNION, если явно не указаны UNION ALL или UNION DISTINCT.

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

• 'DISTINCT' — ClickHouse выводит строки, полученные в результате объединения запросов, удаляя дублирующиеся строки.
• 'ALL' — ClickHouse выводит все строки, полученные в результате объединения запросов, включая дублирующиеся строки.
• '' — ClickHouse генерирует исключение при использовании UNION.

См. примеры в разделе UNION.

Отправлять неизвестный пакет вместо N-го пакета данных

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

• true (по умолчанию) — сгенерировать исключение.
• false — вместо этого возвращать NULL для таких строк.

Ожидать, пока закоммиченные изменения действительно станут видимыми в последнем снимке

Имя рабочей нагрузки, используемой для доступа к ресурсам

Записывать полные пути (включая s3://) в файлы метаданных Iceberg.

Позволяет задать максимальный логарифм окна для ZSTD (не используется для семейства MergeTree)