> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Другие настройки сеанса
> Настройки сеанса ClickHouse в сгенерированной группе «Other».
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Тип
{type}
По умолчанию
{default_value}
{changeable_without_restart &&
Изменяется без перезапуска
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const CloudOnlyBadge = () => {
return
{'Только в ClickHouse Cloud'}
;
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Бета
;
}
return ;
};
export const ExperimentalBadge = () => {
return ;
};
Эти настройки доступны в [system.settings](/docs/ru/reference/system-tables/settings) и автоматически генерируются на основе [исходного кода](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
Добавляет HTTP-заголовок CORS.
## analyze\_index\_with\_space\_filling\_curves
Если в индексе таблицы используется пространственно-заполняющая кривая, например `ORDER BY mortonEncode(x, y)` или `ORDER BY hilbertEncode(x, y)`, и запрос содержит условия для её аргументов, например `x >= 10 AND x <= 20 AND y >= 20 AND y <= 30`, используйте пространственно-заполняющую кривую для анализа индекса.
## analyzer\_inline\_views
Если включено, анализатор подставляет обычные (нематериализованные, непараметризованные) представления их определяющими подзапросами, что позволяет применять оптимизации поверх границ представлений, такие как pushdown предикатов и отсечение столбцов.
## any\_join\_distinct\_right\_table\_keys
Включает устаревшее поведение сервера ClickHouse в операциях `ANY INNER|LEFT JOIN`.
Используйте эту настройку только для обратной совместимости, если ваши сценарии использования зависят от устаревшего поведения `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](/docs/ru/reference/statements/select/join#settings)
## archive\_adaptive\_buffer\_max\_size\_bytes
Ограничивает максимальный размер адаптивного буфера, используемого при записи в архивы (например, tar-архивы
## arrow\_flight\_request\_descriptor\_type
Тип дескриптора для запросов Arrow Flight. 'path' отправляет имя набора данных как дескриптор PATH. 'command' отправляет SQL-запрос как дескриптор команды (требуется для Dremio).
Возможные значения:
* 'path' — Использовать FlightDescriptor::Path (по умолчанию; работает с большинством серверов Arrow Flight)
* 'command' — Использовать FlightDescriptor::Command с запросом SELECT (требуется для Dremio)
## backup\_slow\_all\_threads\_after\_retryable\_s3\_error
Если установлено значение `true`, все потоки, выполняющие S3-запросы к одной и той же конечной точке резервного копирования, замедляются
после того, как любой S3-запрос сталкивается с ошибкой S3, допускающей повторную попытку, например 'Slow Down'.
Если установлено значение `false`, каждый поток обрабатывает задержку S3-запросов независимо от остальных.
## cache\_warmer\_threads
Действует только в ClickHouse Cloud. Количество фоновых потоков для упреждающей загрузки новых частей данных в файловый кэш, если включен параметр [cache\_populated\_by\_fetch](/docs/ru/reference/settings/merge-tree-settings#cache_populated_by_fetch). 0 — отключить.
## calculate\_text\_stack\_trace
Вычислять текстовую трассировку стека при исключениях во время выполнения запроса. Это значение используется по умолчанию. Для этого требуется поиск символов, который может замедлить фаззинг-тесты при выполнении большого количества ошибочных запросов. В обычных условиях отключать этот параметр не следует.
## cancel\_http\_readonly\_queries\_on\_client\_close
Отменяет HTTP-запросы только для чтения (например, SELECT), если клиент закрывает соединение, не дожидаясь ответа.
значение по умолчанию в Cloud: `1`.
## checksum\_on\_read
Проверяет контрольные суммы при чтении. Этот параметр включен по умолчанию и в продакшне должен быть включен всегда. Не стоит ожидать какой-либо выгоды от отключения этого параметра. Его можно использовать только для экспериментов и бенчмарков. Параметр применим только к таблицам семейства MergeTree. Для других движков таблиц и при получении данных по сети контрольные суммы проверяются всегда.
## connection\_pool\_max\_wait\_ms
Время ожидания соединения в миллисекундах, если пул соединений переполнен.
Возможные значения:
* Положительное целое число.
* 0 — бесконечный тайм-аут.
## connections\_with\_failover\_max\_tries
Максимальное число попыток установить соединение с каждой репликой для движка таблицы Distributed.
## convert\_query\_to\_cnf
Если установлено значение `true`, запрос `SELECT` будет преобразован в конъюнктивную нормальную форму (CNF). В некоторых случаях запрос, переписанный в CNF, может выполняться быстрее (объяснение см. в этом [issue на Github](https://github.com/ClickHouse/ClickHouse/issues/11749)).
Например, обратите внимание, что следующий запрос `SELECT` не изменяется (поведение по умолчанию):
```sql theme={null}
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;
```
Результат:
```response theme={null}
┌─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` и посмотрим, что изменится:
```sql theme={null}
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, но результирующий набор остаётся тем же — булева логика не изменилась:
```response theme={null}
┌─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
## count\_matches\_stop\_at\_empty\_match
Останавливать подсчёт, как только в функции `countMatches` шаблон регулярного выражения даёт совпадение нулевой длины.
## cross\_to\_inner\_join\_rewrite
Использовать INNER JOIN вместо соединения через запятую/CROSS JOIN, если в предложении WHERE есть условия соединения. Значения: 0 — не переписывать, 1 — переписывать по возможности для соединения через запятую/CROSS JOIN, 2 — принудительно переписывать все соединения через запятую, CROSS JOIN — по возможности
## data\_type\_default\_nullable
Позволяет считать типы данных без явных модификаторов [NULL or NOT NULL](/docs/ru/reference/statements/create/table#null-or-not-null-modifiers) в определении столбца типом [Nullable](/docs/ru/reference/data-types/nullable).
Возможные значения:
* 1 — Типы данных в определениях столбцов по умолчанию имеют тип `Nullable`.
* 0 — Типы данных в определениях столбцов по умолчанию не имеют тип `Nullable`.
## decimal\_check\_overflow
Проверять переполнение при арифметических операциях и сравнениях Decimal
## deduplicate\_blocks\_in\_dependent\_materialized\_views
Включает или отключает проверку дедупликации для materialized view, получающих данные из таблиц Replicated\*.
Возможные значения:
* 0 — Отключено.
* 1 — Включено.
Если параметр включен, ClickHouse выполняет дедупликацию блоков в materialized view, зависящих от таблиц Replicated\*.
Этот параметр полезен, чтобы materialized view не содержали дублирующихся данных, если операция вставки повторяется из-за сбоя.
**См. также**
* [Обработка NULL в операторах IN](/docs/ru/concepts/features/operations/insert/deduplicating-inserts-on-retries#insert-deduplication-with-materialized-views)
## defer\_partition\_pruning\_after\_final
Когда параметр включен (по умолчанию), для запросов `FINAL` к таблицам, у которых
столбцы ключа партиции не входят в ключ сортировки, отсечение партиций не выполняется. Это безопасное с точки зрения корректности поведение,
добавленное в 26.3: `FINAL` может потребоваться выполнить дедупликацию строк с одинаковым
первичным ключом, но находящихся в разных партициях, а отсечение партиций молча исключило бы такие строки из
входных данных для дедупликации.
Когда параметр отключен, отсечение партиций применяется даже с `FINAL`, что восстанавливает поведение
до 26.3. Это может быть значительно быстрее для запросов с предикатами `WHERE` по
столбцу партиции, но корректно только в тех случаях, когда строки с одинаковым первичным ключом не могут существовать
в разных партициях — например, в таблицах журналов событий, где столбец партиции задается при вставке
и никогда не изменяется.
Этот параметр влияет только на партиционированные таблицы, у которых столбцы ключа партиции не входят
в ключ сортировки; для остальных таблиц отсечение партиций применяется всегда.
Возможные значения:
* 0 — Применять отсечение партиций до `FINAL` (поведение до 26.3, быстрее, но в общем случае небезопасно).
* 1 — Откладывать отсечение партиций до выполнения `FINAL` (по умолчанию, безопасно с точки зрения корректности).
## describe\_compact\_output
Если установлено значение true, в результат запроса DESCRIBE включаются только имена столбцов и типы
## диалект
Диалект, который будет использоваться для разбора запроса
## discard\_query\_data
Если настройка включена, сервер не отправляет клиенту строки результата запроса. При этом запрос по-прежнему полностью выполняется и записывается в журнал на сервере, а клиент по-прежнему получает остальные пакеты.
Используется для теневого трафика, бенчмарков и фаззинга.
Не влияет на вторичные запросы.
Действует только для собственного TCP-протокола.
## distinct\_overflow\_mode
Определяет, что происходит, когда объём данных превышает один из лимитов.
Возможные значения:
* `throw`: сгенерировать исключение (по умолчанию).
* `break`: прекратить выполнение запроса и вернуть частичный результат, как если бы
исходные данные исчерпались.
## do\_not\_merge\_across\_partitions\_select\_final
Повышает производительность запросов FINAL, избегая слияний между разными партициями.
Если включено, при выполнении запросов SELECT FINAL части из разных партиций не будут сливаться друг с другом. Вместо этого слияние будет происходить отдельно в пределах каждой партиции. Это может значительно повысить производительность запросов при работе с партиционированными таблицами.
## dynamic\_throw\_on\_type\_mismatch
При применении функции к столбцу [Dynamic](/docs/ru/reference/data-types/dynamic) со стандартной реализацией
управляет тем, что происходит со строками, фактический тип которых несовместим с функцией:
* `true` (по умолчанию) — сгенерировать исключение.
* `false` — вместо этого возвращать `NULL` для таких строк.
## enforce\_strict\_identifier\_format
Если параметр включен, разрешены только идентификаторы, содержащие буквенно-цифровые символы и символы подчеркивания.
## engine\_url\_skip\_empty\_files
Включает или отключает пропуск пустых файлов в таблицах движка [URL](/docs/ru/reference/engines/table-engines/special/url).
Возможные значения:
* 0 — `SELECT` генерирует исключение, если пустой файл несовместим с запрошенным форматом.
* 1 — `SELECT` возвращает пустой результат, если файл пуст.
## exact\_rows\_before\_limit
Если параметр включен, ClickHouse будет возвращать точное значение статистики rows\_before\_limit\_at\_least, но ценой того, что данные до LIMIT придется прочитать полностью
## except\_default\_mode
Задает режим по умолчанию для запроса EXCEPT. Возможные значения: пустая строка, 'ALL', 'DISTINCT'. Если значение пустое, запрос без режима сгенерирует исключение.
## exclude\_materialize\_skip\_indexes\_on\_insert
Исключает указанные индексы пропуска данных из построения и хранения при операциях INSERT. Исключённые индексы пропуска данных всё равно будут строиться и сохраняться [при слиянии](/docs/ru/reference/settings/merge-tree-settings#materialize_skip_indexes_on_merge) или явным
запросом [MATERIALIZE INDEX](/docs/ru/reference/statements/alter/skipping-index#materialize-index).
Не имеет эффекта, если [materialize\_skip\_indexes\_on\_insert](/docs/ru/reference/settings/session-settings/materialize#materialize_skip_indexes_on_insert) равно false.
Пример:
```sql theme={null}
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
```
## execute\_exists\_as\_scalar\_subquery
Выполнять некоррелированные подзапросы EXISTS как скалярные подзапросы. Как и для скалярных подзапросов, используется кэш, а к результату применяется свёртка констант.
Значение по умолчанию в Cloud: `0`.
## explain\_query\_plan\_default
Формат, используемый по умолчанию для `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`.
**Псевдонимы**: `extract_kvp_max_pairs_per_row`
Максимальное количество пар, которое может вернуть функция `extractKeyValuePairs`. Используется как защита от чрезмерного потребления памяти.
## extremes
Определяет, нужно ли учитывать экстремальные значения (минимальные и максимальные значения в столбцах результата запроса). Принимает значения 0 или 1. По умолчанию — 0 (отключено).
Подробнее см. в разделе «Экстремальные значения».
## fallback\_to\_stale\_replicas\_for\_distributed\_queries
Принудительно отправляет запрос на устаревшую реплику, если актуальные данные недоступны. См. [Репликация](/docs/ru/reference/engines/table-engines/mergetree-family/replication).
ClickHouse выбирает наиболее подходящую из устаревших реплик таблицы.
Используется при выполнении `SELECT` из distributed таблицы, указывающей на реплицируемые таблицы.
По умолчанию: 1 (включено).
## file\_like\_engine\_default\_partition\_strategy
Стратегия партиционирования по умолчанию для file-like движков.
## filesystem\_prefetches\_limit
Максимальное количество операций предварительного чтения. Ноль означает отсутствие ограничений. Если нужно ограничить количество операций предварительного чтения, рекомендуется использовать настройку `filesystem_prefetches_max_memory_usage`
## final
Автоматически применяет модификатор [FINAL](/docs/ru/reference/statements/select/from#final-modifier) ко всем таблицам в запросе, для которых применим [FINAL](/docs/ru/reference/statements/select/from#final-modifier), включая таблицы, участвующие в JOIN, таблицы в подзапросах, а также
distributed таблицы.
Возможные значения:
* 0 - отключено
* 1 - включено
Пример:
```sql theme={null}
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;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
┌─key─┬─some──┐
│ 1 │ first │
└─────┴───────┘
SELECT * FROM test SETTINGS final = 1;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
SET final = 1;
SELECT * FROM test;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
```
## finalize\_projection\_parts\_synchronously
Если настройка включена, части проекций финализируются синхронно во время INSERT, что снижает пиковое потребление памяти ценой уменьшения параллелизма загрузки в S3. По умолчанию выходной поток каждой проекции остаётся активным до тех пор, пока не будет финализирована вся часть (включая все проекции), что позволяет выполнять параллельно перекрывающиеся загрузки в S3, но увеличивает пиковое потребление памяти пропорционально числу проекций. Эта настройка влияет только на INSERT; слияния и мутации уже финализируют проекции синхронно.
## flatten\_nested
Задаёт формат данных для столбцов типа [Nested](/docs/ru/reference/data-types/nested-data-structures/index).
Возможные значения:
* 1 — столбец Nested преобразуется в отдельные массивы.
* 0 — столбец Nested остаётся единым массивом кортежей.
**Использование**
Если для этой настройки установлено значение `0`, можно использовать произвольный уровень вложенности.
**Примеры**
Запрос:
```sql theme={null}
SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
```
Результат:
```text theme={null}
┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n.a` Array(UInt32),
`n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
Запрос:
```sql theme={null}
SET flatten_nested = 0;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
```
Результат:
```text theme={null}
┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
## fsync\_metadata
Включает или отключает [fsync](http://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html) при записи файлов `.sql`. По умолчанию включено.
Его имеет смысл отключить, если на сервере есть миллионы маленьких таблиц, которые постоянно создаются и удаляются.
## functions\_h3\_default\_if\_invalid
Если false, функции h3, например h3CellAreaM2, генерируют исключение при недопустимых входных данных. Если true, они возвращают 0 или значение по умолчанию.
## geo\_distance\_returns\_float64\_on\_float64\_arguments
Если все четыре аргумента функций `geoDistance`, `greatCircleDistance`, `greatCircleAngle` имеют тип Float64, то возвращается Float64, а для внутренних вычислений используется двойная точность. В предыдущих версиях ClickHouse эти функции всегда возвращали Float32.
## geotoh3\_argument\_order
Функция 'geoToH3' принимает (lon, lat), если установлено значение 'lon\_lat', и (lat, lon), если установлено значение 'lat\_lon'.
## glob\_expansion\_max\_elements
Максимальное количество разрешённых адресов (для внешних хранилищ, табличных функций и т. д.).
## h3togeo\_lon\_lat\_result\_order
Функция 'h3ToGeo' возвращает (lon, lat), если установлено значение true, иначе — (lat, lon).
## handshake\_timeout\_ms
Тайм-аут в миллисекундах на получение пакета Hello от реплик во время рукопожатия.
## hedged\_connection\_timeout\_ms
Тайм-аут на установление соединения с репликой для Hedged requests
## highlight\_max\_matches\_per\_row
Задаёт максимальное количество совпадений подсветки на строку в функции [highlight](/docs/ru/reference/functions/regular-functions/string-search-functions#highlight). Используйте её, чтобы предотвратить чрезмерное использование памяти при подсветке часто повторяющихся шаблонов в больших текстах.
Возможные значения:
* Положительное целое число.
## hnsw\_candidate\_list\_size\_for\_search
Размер динамического списка кандидатов при поиске по индексу векторного сходства, также называемый `ef_search`.
## hsts\_max\_age
Время действия HSTS. Значение 0 отключает HSTS.
## idle\_connection\_timeout
Тайм-аут закрытия бездействующих TCP-соединений по истечении указанного количества секунд.
Возможные значения:
* Положительное целое число (0 — закрыть немедленно, через 0 секунд).
## inject\_random\_order\_for\_select\_without\_order\_by
Если включено, добавляет 'ORDER BY rand()' в SELECT-запросы без предложения ORDER BY.
Применяется только при глубине подзапроса = 0. Подзапросы и INSERT INTO ... SELECT не затрагиваются.
Если конструкция верхнего уровня — UNION, 'ORDER BY rand()' добавляется во все дочерние части независимо.
Полезно только для тестирования и разработки (отсутствие ORDER BY — источник недетерминированных результатов запроса).
## interactive\_delay
Интервал в микросекундах для проверки отмены выполнения запроса и отправки Прогресса.
## intersect\_default\_mode
Задаёт режим по умолчанию для запроса INTERSECT. Возможные значения: пустая строка, 'ALL', 'DISTINCT'. Если указана пустая строка, запрос без режима сгенерирует исключение.
## least\_greatest\_legacy\_null\_behavior
Если включено, функции 'least' и 'greatest' возвращают NULL, если один из аргументов равен NULL.
## legacy\_column\_name\_of\_tuple\_literal
Использует в именах столбцов больших литералов `Tuple` имена всех элементов вместо хеша. Эта настройка существует только из соображений совместимости. Имеет смысл установить значение 'true' при выполнении rolling update кластера с версии ниже 21.7 на версию выше.
## limit
Задаёт максимальное количество строк в результате запроса. Корректирует значение, заданное оператором [LIMIT](/docs/ru/reference/statements/select/limit), так что ограничение, указанное в запросе, не может превышать значение, заданное этой настройкой.
Возможные значения:
* 0 — количество строк не ограничено.
* Положительное целое число.
## load\_marks\_asynchronously
Асинхронно загружать метки MergeTree
Значение по умолчанию в Cloud: `1`.
## lock\_acquire\_timeout
Определяет, сколько секунд запрос на блокировку ожидает, прежде чем завершиться ошибкой.
Тайм-аут блокировки используется для защиты от взаимных блокировок при выполнении операций чтения и записи в таблицах. Когда время ожидания истекает и запрос на блокировку завершается ошибкой, сервер ClickHouse генерирует исключение "Locking attempt timed out! Possible deadlock avoided. Client should retry." с кодом ошибки `DEADLOCK_AVOIDED`.
Возможные значения:
* Положительное целое число (в секундах).
* 0 — тайм-аут блокировки отсутствует.
## low\_priority\_query\_wait\_time\_ms
Когда используется механизм приоритизации запросов (см. настройку `priority`), запросы с низким приоритетом ждут завершения запросов с более высоким приоритетом. Эта настройка указывает время ожидания.
## make\_distributed\_plan
Формирует распределённый план запроса.
## merge\_table\_max\_tables\_to\_look\_for\_schema\_inference
При создании таблицы `Merge` без явного указания схемы или при использовании табличной функции `merge` схема определяется как объединение не более указанного количества подходящих таблиц.
Если таблиц больше, схема будет определена по первым таблицам в указанном количестве.
## mongodb\_throw\_on\_unsupported\_query
Если параметр включен, таблицы MongoDB возвращают ошибку, когда не удается сформировать запрос MongoDB. В противном случае ClickHouse читает всю таблицу и обрабатывает ее локально. Этот параметр не действует, если `allow_experimental_analyzer=0`.
## multiple\_joins\_try\_to\_keep\_original\_names
Не добавлять псевдонимы в список выражений верхнего уровня при переписывании запроса с несколькими JOIN
## normalize\_function\_names
Приводить имена функций к каноническому виду
## offset
Задаёт количество строк, которые нужно пропустить перед тем, как запрос начнёт возвращать строки. Корректирует смещение, заданное оператором [OFFSET](/docs/ru/reference/statements/select/offset), поэтому эти два значения суммируются.
Возможные значения:
* 0 — строки не пропускаются.
* Положительное целое число.
**Пример**
Входная таблица:
```sql theme={null}
CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);
```
Запрос:
```sql theme={null}
SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;
```
Результат:
```text theme={null}
┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘
```
## paimon\_target\_snapshot\_id
Чтение указанного снимка на уровне запроса для инкрементального режима Paimon. Если значение >0, модуль чтения будет получать только дельту
для указанного snapshot\_id, не продвигая зафиксированную водяную метку.
По умолчанию: -1 (отключено)
## parallelize\_output\_from\_storages
Распараллеливает вывод на этапе чтения из хранилища. Позволяет, где это возможно, распараллеливать обработку запроса сразу после чтения из хранилища
## partial\_result\_on\_first\_cancel
Позволяет запросу вернуть частичный результат после отмены.
## per\_part\_index\_stats
Записывает в журнал статистику индекса по каждой части
## poll\_interval
Блокирует сервер в цикле ожидания запроса на указанное количество секунд.
## polyglot\_dialect
Исходный диалект SQL для транспайлера polyglot (например, 'sqlite', 'mysql', 'postgresql', 'snowflake', 'duckdb').
## postgresql\_fault\_injection\_probability
Приблизительная вероятность сбоя при выполнении внутренних запросов PostgreSQL (для репликации). Допустимое значение — в интервале \[0.0f, 1.0f]
## predicate\_statistics\_sample\_rate
Собирает статистику селективности предикатов в `system.predicate_statistics_log`. Если установлено значение N > 0, выборка включает примерно 1/N запросов (по Query id). 0 означает, что сбор отключён.
## prefetch\_buffer\_size
Максимальный размер буфера предвыборки для чтения из файловой системы. Значения свыше 256 МиБ принудительно ограничиваются до 256 МиБ, так как буфер чтения не требует большего размера.
## print\_pretty\_type\_names
Позволяет выводить имена глубоко вложенных типов в удобочитаемом виде с отступами в запросе `DESCRIBE` и функции `toTypeName()`.
Пример:
```sql theme={null}
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)
)
```
## priority
Приоритет запроса. 1 — наивысший приоритет, большее значение — более низкий приоритет; 0 — приоритеты не используются.
## push\_external\_roles\_in\_interserver\_queries
Включает передачу ролей пользователя от узла-инициатора на другие узлы во время выполнения запроса.
## query\_metric\_log\_interval
Интервал в миллисекундах, с которым собираются данные [query\_metric\_log](/docs/ru/reference/system-tables/query_metric_log) для отдельных запросов.
Если задано любое отрицательное значение, используется значение `collect_interval_milliseconds` из [настройки query\_metric\_log](/docs/ru/reference/settings/server-settings/settings#query_metric_log), а если оно отсутствует — значение 1000 по умолчанию.
Чтобы отключить сбор данных для отдельного запроса, установите `query_metric_log_interval` в 0.
Значение по умолчанию: -1
## queue\_max\_wait\_ms
Время ожидания в очереди запросов, если число одновременных запросов превышает максимальное.
## rabbitmq\_max\_wait\_ms
Время ожидания при чтении из RabbitMQ перед повторной попыткой.
## readonly
0 — ограничений режима «только для чтения» нет. 1 — только запросы на чтение, а также изменение явно разрешённых настроек. 2 — только запросы на чтение, а также изменение настроек, кроме настройки 'readonly'.
## recursive\_cte\_max\_steps\_in\_type\_inference
Максимальное количество итераций для определения типов столбцов в рекурсивных CTE. Типы столбцов определяются итеративным применением `getLeastSupertype` к нерекурсивной и рекурсивной частям UNION ALL до достижения сходимости. Установите 0, чтобы отключить расширение типов и использовать только типы из нерекурсивной части.
## regexp\_max\_matches\_per\_row
Устанавливает максимальное число совпадений одного регулярного выражения для одной строки. Используйте эту настройку, чтобы предотвратить переполнение памяти при использовании жадного регулярного выражения в функции [extractAllGroupsHorizontal](/docs/ru/reference/functions/regular-functions/string-search-functions#extractAllGroupsHorizontal).
Возможные значения:
* Положительное целое число.
## reject\_expensive\_hyperscan\_regexps
Отклонять шаблоны, проверка которых с помощью hyperscan, вероятно, потребует больших затрат ресурсов (из-за взрывного роста числа состояний NFA)
## remerge\_sort\_lowered\_memory\_bytes\_ratio
Если после повторного слияния использование памяти не уменьшится в указанное число раз, повторное слияние будет отключено.
## remote\_read\_min\_bytes\_for\_seek
Минимальное количество байт для удалённого чтения (url, s3), при котором выполняется seek вместо чтения с пропуском данных.
## rename\_files\_after\_processing
* **Тип:** 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`
## replication\_wait\_for\_inactive\_replica\_timeout
Указывает, сколько времени (в секундах) ждать, пока неактивные реплики выполнят запросы [`ALTER`](/docs/ru/reference/statements/alter/index), [`OPTIMIZE`](/docs/ru/reference/statements/optimize) или [`TRUNCATE`](/docs/ru/reference/statements/truncate).
Возможные значения:
* `0` — Не ждать.
* Отрицательное целое число — Ждать неограниченно долго.
* Положительное целое число — Количество секунд ожидания.
## reserve\_memory
Используется в планировании рабочих нагрузок. Минимальный объём оперативной памяти, резервируемый для выполнения запроса на одном сервере. Резервирование выполняется через иерархию WORKLOAD с использованием значения настройки запроса `workload`.
Если для рабочей нагрузки недостаточно доступной памяти, запрос не запускается и остаётся в состоянии pending, пока резервирование не станет возможным.
Значение `0` означает, что резервирование не выполняется.
Эта настройка действует только в том случае, если создан ресурс MEMORY RESERVATION.
## restore\_replicated\_merge\_tree\_to\_shared\_merge\_tree
Заменяет движок таблицы Replicated*MergeTree на Shared*MergeTree при RESTORE.
Значение по умолчанию в Cloud: `1`.
## result\_overflow\_mode
Определяет, что делать, если объём результата превышает одно из ограничений.
Возможные значения:
* `throw`: сгенерировать исключение (по умолчанию).
* `break`: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные были исчерпаны.
Использование 'break' похоже на использование LIMIT. `Break` прерывает выполнение только на уровне
блока. Это означает, что количество возвращённых строк будет больше, чем
[`max_result_rows`](/docs/ru/reference/settings/session-settings/max-result#max_result_rows), кратно [`max_block_size`](/docs/ru/reference/settings/session-settings/max#max_block_size)
и зависит от [`max_threads`](/docs/ru/reference/settings/session-settings/max-threads#max_threads).
**Пример**
```sql title="Query" theme={null}
SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';
SELECT *
FROM numbers_mt(100000)
FORMAT Null;
```
```text title="Result" theme={null}
6666 rows in set. ...
```
## rows\_before\_aggregation
Если включено, ClickHouse будет возвращать точное значение статистики rows\_before\_aggregation, которая показывает количество строк, прочитанных до агрегации
## secondary\_indices\_enable\_bulk\_filtering
Включает алгоритм пакетной фильтрации для индексов. Предполагается, что он всегда эффективнее, но эта настройка оставлена для совместимости и дополнительного контроля.
## select\_sequential\_consistency
Эта настройка работает по-разному в SharedMergeTree и ReplicatedMergeTree; подробнее о поведении `select_sequential_consistency` в SharedMergeTree см. в разделе [SharedMergeTree consistency](/docs/ru/products/cloud/features/infrastructure/shared-merge-tree#consistency).
Включает или отключает последовательную согласованность для запросов `SELECT`. Требует, чтобы `insert_quorum_parallel` был отключен (по умолчанию он включен).
Возможные значения:
* 0 — отключено.
* 1 — включено.
Использование
Когда последовательная согласованность включена, ClickHouse позволяет клиенту выполнять запрос `SELECT` только на тех репликах, которые содержат данные из всех предыдущих запросов `INSERT`, выполненных с `insert_quorum`. Если клиент обращается к неполной реплике, ClickHouse выдаст исключение. Запрос `SELECT` не будет включать данные, которые еще не были записаны в кворум реплик.
Когда `insert_quorum_parallel` включен (по умолчанию), `select_sequential_consistency` не работает. Это связано с тем, что параллельные запросы `INSERT` могут записываться в разные наборы кворумных реплик, поэтому нет гарантии, что одна реплика получит все записи.
См. также:
* [insert\_quorum](/docs/ru/reference/settings/session-settings/insert-quorum#insert_quorum)
* [insert\_quorum\_timeout](/docs/ru/reference/settings/session-settings/insert-quorum#insert_quorum_timeout)
* [insert\_quorum\_parallel](/docs/ru/reference/settings/session-settings/insert-quorum#insert_quorum_parallel)
## session\_timezone
Задаёт неявный часовой пояс для текущего сеанса или запроса.
Неявный часовой пояс применяется к значениям типа DateTime/DateTime64, для которых часовой пояс явно не указан.
Этот параметр имеет приоритет над неявным часовым поясом, глобально настроенным на уровне сервера.
Значение '' (пустая строка) означает, что неявный часовой пояс текущего сеанса или запроса совпадает с [часовым поясом сервера](/docs/ru/reference/settings/server-settings/settings#timezone).
Чтобы получить часовой пояс сеанса и часовой пояс сервера, можно использовать функции `timeZone()` и `serverTimeZone()`.
Возможные значения:
* Любое имя часового пояса из `system.time_zones`, например `Europe/Berlin`, `UTC` или `Zulu`
Примеры:
```sql theme={null}
SELECT timeZone(), serverTimeZone() FORMAT CSV
"Europe/Berlin","Europe/Berlin"
```
```sql theme={null}
SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV
"Asia/Novosibirsk","Europe/Berlin"
```
Назначьте внутреннему DateTime без явно заданного часового пояса часовой пояс сеанса 'America/Denver':
```sql theme={null}
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
```
Не все функции, разбирающие DateTime/DateTime64, учитывают `session_timezone`. Это может приводить к трудноуловимым ошибкам.
См. пример и пояснение ниже.
```sql theme={null}
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'
┌───────────────────d─┬─timeZone()───────┐
│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
└─────────────────────┴──────────────────┘
```
Это происходит из-за различий в конвейерах разбора:
* `toDateTime()` без явно указанного часового пояса, используемая в первом запросе `SELECT`, учитывает настройку `session_timezone` и глобальный часовой пояс.
* Во втором запросе значение DateTime разбирается из строки и наследует тип и часовой пояс существующего столбца `d`. Поэтому ни настройка `session_timezone`, ни глобальный часовой пояс не учитываются.
**См. также**
* [timezone](/docs/ru/reference/settings/server-settings/settings#timezone)
## set\_overflow\_mode
Определяет, что произойдёт, если объём данных превысит одно из ограничений.
Возможные значения:
* `throw`: сгенерировать исключение (по умолчанию).
* `break`: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные закончились.
## single\_join\_prefer\_left\_table
Для одиночного JOIN при неоднозначности идентификатора использовать левую таблицу
## skip\_redundant\_aliases\_in\_udf
Избыточные псевдонимы не используются (не подставляются) в пользовательских функциях, что упрощает их использование.
Возможные значения:
* 1 — Псевдонимы пропускаются (заменяются своими выражениями) в UDF.
* 0 — Псевдонимы не пропускаются (не заменяются своими выражениями) в UDF.
**Пример**
Разница между включенным и отключенным состоянием:
Запрос:
```sql theme={null}
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);
```
Результат:
```text theme={null}
SELECT ((4 + 2) + 1 AS y, y + 2)
```
Запрос:
```sql theme={null}
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);
```
Результат:
```text theme={null}
SELECT ((4 + 2) + 1, ((4 + 2) + 1) + 2)
```
## sleep\_after\_receiving\_query\_ms
Время паузы после получения запроса в TCPHandler
## snappy\_mode
Управляет форматом передачи данных, используемым для сжатия snappy при универсальных путях файлового ввода-вывода, таких как `file` и `url`. HTTP `Content-Encoding: snappy` всегда использует формат framing и не учитывает эту настройку.
Обратите внимание: необработанный блоковый формат snappy, создаваемый одним вызовом `snappy::Compress` (например, полезная нагрузка протокола Prometheus remote, обрабатываемая `SnappyBasicReadBuffer`), представляет собой отдельный формат передачи данных, специфичный для протокола, и не управляется этой настройкой.
Возможные значения:
* `basic` — блоковый формат Hadoop snappy. Совместим с файлами, которые Hadoop читает и записывает. Поддерживает и чтение, и запись.
* `framed` — формат framing для Snappy, стандартный стриминг-формат, определённый Google. Поддерживает и чтение, и запись.
## sort\_overflow\_mode
Определяет, что произойдёт, если количество строк, полученных перед сортировкой, превысит одно из ограничений.
Возможные значения:
* `throw`: сгенерировать исключение.
* `break`: остановить выполнение запроса и вернуть частичный результат.
## splitby\_max\_substrings\_includes\_remaining\_string
Управляет тем, будет ли функция [splitBy\*()](/docs/ru/reference/functions/regular-functions/splitting-merging-functions) с аргументом `max_substrings` > 0 включать оставшуюся часть строки в последний элемент результирующего массива.
Возможные значения:
* `0` - Оставшаяся часть строки не будет включена в последний элемент результирующего массива.
* `1` - Оставшаяся часть строки будет включена в последний элемент результирующего массива. Такое поведение соответствует функции [`split()`](https://spark.apache.org/docs/latest/api/python/reference/pyspark.sql/api/pyspark.sql.functions.split.html) в Spark и методу ['string.split()'](https://docs.python.org/3/library/stdtypes.html#str.split) в Python.
## stop\_refreshable\_materialized\_views\_on\_startup
При запуске сервера отключает планирование refreshable materialized views, как если бы была выполнена команда SYSTEM STOP VIEWS. Позже их можно вручную запустить с помощью `SYSTEM START VIEWS` или `SYSTEM START VIEW `. Это также относится к вновь созданным представлениям. Не влияет на materialized views, не являющиеся refreshable.
## tcp\_keep\_alive\_timeout
Время в секундах, в течение которого соединение должно оставаться неактивным, прежде чем TCP начнет отправлять keepalive-пакеты
## temporary\_data\_in\_cache\_reserve\_space\_wait\_lock\_timeout\_milliseconds
Время ожидания получения блокировки файлового кэша для резервирования места под временные данные
## throw\_if\_no\_data\_to\_insert
Разрешает или запрещает пустые INSERT-запросы; по умолчанию включена (при пустой вставке генерируется ошибка). Применяется только к INSERT-запросам, выполняемым через [`clickhouse-client`](/docs/ru/concepts/features/interfaces/cli) или [gRPC-интерфейс](/docs/ru/concepts/features/interfaces/grpc).
## timeout\_before\_checking\_execution\_speed
Проверяет, не слишком ли низка скорость выполнения (не ниже `min_execution_speed`),
по истечении указанного времени в секундах.
## transfer\_overflow\_mode
Определяет, что происходит, когда объём данных превышает одно из ограничений.
Возможные значения:
* `throw`: сгенерировать исключение (по умолчанию).
* `break`: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные закончились.
## transform\_null\_in
Включает сравнение значений [NULL](/docs/ru/reference/syntax#null) как равных для оператора [IN](/docs/ru/reference/statements/in).
По умолчанию значения `NULL` сравнивать нельзя, поскольку `NULL` означает неопределённое значение. Поэтому сравнение `expr = NULL` всегда должно возвращать `false`. При включении этой настройки выражение `NULL = NULL` для оператора `IN` возвращает `true`.
Возможные значения:
* 0 — Сравнение значений `NULL` в операторе `IN` возвращает `false`.
* 1 — Сравнение значений `NULL` в операторе `IN` возвращает `true`.
**Пример**
Рассмотрим таблицу `null_in`:
```text theme={null}
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
│ 3 │ 3 │
└──────┴───────┘
```
Запрос:
```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;
```
Результат:
```text theme={null}
┌──idx─┬────i─┐
│ 1 │ 1 │
└──────┴──────┘
```
Запрос:
```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
```
Результат:
```text theme={null}
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
└──────┴───────┘
```
**См. также**
* [Обработка NULL в операторах IN](/docs/ru/reference/statements/in#null-processing)
## traverse\_shadow\_remote\_data\_paths
Обходить замороженные данные (теневой каталог) наряду с данными самой таблицы при запросе system.remote\_data\_paths
## union\_default\_mode
Задает режим объединения результатов `SELECT`-запросов. Эта настройка используется только при работе с [UNION](/docs/ru/reference/statements/select/union), если явно не указаны `UNION ALL` или `UNION DISTINCT`.
Возможные значения:
* `'DISTINCT'` — ClickHouse выводит строки, полученные в результате объединения запросов, удаляя дублирующиеся строки.
* `'ALL'` — ClickHouse выводит все строки, полученные в результате объединения запросов, включая дублирующиеся строки.
* `''` — ClickHouse генерирует исключение при использовании `UNION`.
См. примеры в разделе [UNION](/docs/ru/reference/statements/select/union).
## unique\_key\_max\_encoded\_size
Максимальный размер (в байтах) двоичного кодирования, сохраняющего порядок, для одной строки `UNIQUE KEY`.
## unknown\_packet\_in\_send\_data
Отправлять неизвестный пакет вместо N-го пакета данных
## variant\_throw\_on\_type\_mismatch
При применении функции к столбцу [Variant](/docs/ru/reference/data-types/variant) с использованием реализации по умолчанию
эта настройка определяет, что происходит со строками, фактический тип которых несовместим с функцией:
* `true` (по умолчанию) — сгенерировать исключение.
* `false` — вместо этого возвращать `NULL` для таких строк.
## wait\_changes\_become\_visible\_after\_commit\_mode
Ожидать, пока закоммиченные изменения действительно станут видимыми в последнем снимке
## рабочая нагрузка
Имя рабочей нагрузки, используемой для доступа к ресурсам
## write\_full\_path\_in\_iceberg\_metadata
Записывать полные пути (включая s3://) в файлы метаданных Iceberg.
## zstd\_window\_log\_max
Позволяет задать максимальный логарифм окна для ZSTD (не используется для семейства MergeTree)