Настройки сессии

Все настройки ниже также доступны в таблице system.settings. Эти настройки автогенерируются из source.

add_http_cors_header

Тип: Bool

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

Добавить HTTP CORS заголовок.

additional_result_filter

Тип: String

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

Дополнительное выражение фильтра, которое применяется к результату запроса SELECT. Эта настройка не применяется к подзапросам.

Пример

additional_table_filters

Тип: Map

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

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

Пример

aggregate_functions_null_for_empty

Тип: Bool

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

Включает или отключает переписывание всех агрегатных функций в запросе, добавляя суффикс -OrNull к ним. Включите для совместимости со стандартом SQL. Это реализовано через переписывание запроса (аналогично настройке count_distinct_implementation) для получения согласованных результатов для распределенных запросов.

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

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

Пример

Рассмотрим следующий запрос с агрегатными функциями:

При aggregate_functions_null_for_empty = 0 результат будет:

При aggregate_functions_null_for_empty = 1 результат будет:

aggregation_in_order_max_block_bytes

Тип: UInt64

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

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

aggregation_memory_efficient_merge_threads

Тип: UInt64

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

Количество потоков для слияния промежуточных результатов агрегации в режиме экономии памяти. Чем больше, тем больше потребляется памяти. 0 означает - то же самое, что и 'max_threads'.

allow_aggregate_partitions_independently

Тип: Bool

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

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

allow_archive_path_syntax

Experimental feature. Learn more.

Тип: Bool

Тип: Bool

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

Если установлено в true и выполняются условия join_to_sort_minimum_perkey_rows и join_to_sort_maximum_table_rows, пересортируйте правую таблицу по ключу для повышения производительности в левом или внутреннем хеш-соединении.

Experimental feature. Learn more.

Тип: Bool

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

Разрешить создание устаревшего LIVE VIEW.

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

0 — Работа с live-представлениями отключена.
1 — Работа с live-представлениями включена.

allow_experimental_shared_set_join

Experimental feature. Learn more.

ClickHouse Cloud only

Тип: Bool

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

Имеет эффект только в ClickHouse Cloud. Разрешить создание ShareSet и SharedJoin.

allow_experimental_statistics

Experimental feature. Learn more.

Тип: Bool

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

Разрешает определение столбцов с statistics и manipulate statistics.

allow_experimental_time_series_table

Experimental feature. Learn more.

Тип: Bool

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

Разрешает создание таблиц с движком TimeSeries.

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

0 — движок таблицы TimeSeries отключён.
1 — движок таблицы TimeSeries включён.

allow_experimental_ts_to_grid_aggregate_function

Experimental feature. Learn more.

Тип: Bool

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

Экспериментальная агрегационная функция tsToGrid для повторного дискретизации временных рядов, похожих на Prometheus. Только для облака.

Тип: Bool

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

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

allow_get_client_http_header

Тип: Bool

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

Разрешить использование функции getClientHTTPHeader, которая позволяет получить значение заголовка текущего HTTP-запроса. Она не включена по умолчанию по соображениям безопасности, потому что некоторые заголовки, такие как Cookie, могут содержать конфиденциальную информацию. Обратите внимание, что заголовки X-ClickHouse-* и Authentication всегда ограничены и не могут быть получены с помощью этой функции.

allow_hyperscan

Тип: Bool

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

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

allow_introspection_functions

Тип: Bool

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

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

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

1 — Функции интроспекции включены.
0 — Функции интроспекции отключены.

См. также

Sampling Query Profiler
Системная таблица trace_log

allow_materialized_view_with_bad_select

Тип: Bool

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

Разрешить CREATE MATERIALIZED VIEW с запросом SELECT, который ссылается на несуществующие таблицы или столбцы. Он все еще должен быть синтаксически правильным. Не применяется к обновляемым материализованным представлениям. Не применяется, если схема материализованного представления должна быть выведена из запроса SELECT (т.е. если в CREATE нет списка столбцов и нет таблицы TO). Может использоваться для создания материализованного представления до его исходной таблицы.

allow_named_collection_override_by_default

Тип: Bool

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

Разрешить переопределение полей именованных коллекций по умолчанию.

allow_non_metadata_alters

Тип: Bool

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

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

allow_nonconst_timezone_arguments

Тип: Bool

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

Разрешить неконстантные аргументы часового пояса в некоторых временных функциях, таких как toTimeZone(), fromUnixTimestamp*(), snowflakeToDateTime*().

allow_nondeterministic_mutations

Тип: Bool

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

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

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

Пример

allow_nondeterministic_optimize_skip_unused_shards

Тип: Bool

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

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

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

0 — Запрещено.
1 — Разрешено.

Пример:

Но следующий запрос будет работать только с allow_settings_after_format_in_insert:

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

0 — Запретить.
1 — Разрешить.

примечание

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

allow_simdjson

Тип: Bool

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

Разрешить использование библиотеки simdjson в функциях 'JSON*' при наличии инструкций AVX2. Если отключено, будет использоваться rapidjson.

allow_statistics_optimize

Experimental feature. Learn more.

Тип: Bool

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

Разрешает использование статистики для оптимизации запросов.

allow_suspicious_codecs

Тип: Bool

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

Если установлено в true, разрешить указание бессмысленных кодеков сжатия.

allow_suspicious_fixed_string_types

Тип: Bool

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

В операторе CREATE TABLE разрешает создание столбцов типа FixedString(n) с n > 256. FixedString с длиной >= 256 является подозрительным и, скорее всего, указывает на неправильное использование.

allow_suspicious_indices

Тип: Bool

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

Запретить первичные/вторичные индексы и ключи сортировки с идентичными выражениями.

allow_suspicious_low_cardinality_types

Тип: Bool

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

Разрешает или ограничивает использование LowCardinality с типами данных с фиксированным размером 8 байт или меньше: числовыми типами данных и FixedString(8_bytes_or_less).

Для небольших фиксированных значений использование LowCardinality обычно неэффективно, поскольку ClickHouse хранит числовой индекс для каждой строки. В результате:

Использование дискового пространства может увеличиваться.
Потребление ОЗУ может возрасти в зависимости от размера словаря.
Некоторые функции могут работать медленнее из-за дополнительных операций кодирования/декодирования.

Время слияния в таблицах с движком MergeTree может увеличиться по всем описанным выше причинам.

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

1 — Использование LowCardinality не ограничено.
0 — Использование LowCardinality ограничено.

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

0 — отключить подробности.
1 — включить подробности.

Пример

alter_sync

Тип: UInt64

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

Позволяет настроить ожидание выполнения действий на репликах при ALTER, OPTIMIZE или TRUNCATE запросах.

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

0 — Не ждать.
1 — Ждать собственного выполнения.
2 — Ждать выполнения всеми.

Значение по умолчанию для облака: 0.

примечание

alter_sync применимо только к Replicated таблицам, не действует на изменения не Replicated таблиц.

analyze_index_with_space_filling_curves

Тип: Bool

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

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

analyzer_compatibility_join_using_top_level_identifier

Тип: Bool

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

Заставить разрешать идентификаторы в JOIN USING из проекции (например, в SELECT a + 1 AS b FROM t1 JOIN t2 USING (b) соединение будет выполнено с использованием t1.a + 1 = t2.b, а не t1.b = t2.b).

any_join_distinct_right_table_keys

Тип: Bool

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

Включает поведение старого сервера 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

apply_deleted_mask

Тип: Bool

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

Включает фильтрацию удалённых строк с помощью легковесного DELETE. Если отключено, запрос сможет прочитать эти строки. Это полезно для отладки и "восстановления" сценариев.

apply_mutations_on_fly

Тип: Bool

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

Если true, мутации (UPDATE и DELETE), которые не материализованы в части данных, будут применяться при SELECT.

apply_settings_from_server

Тип: Bool

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

Должен ли клиент принимать настройки от сервера.

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

Обычно эта настройка должна быть установлена в профиле пользователя (users.xml или запросы, такие как ALTER USER), а не через клиента (аргументы командной строки клиента, запрос SET или секция SETTINGS запроса SELECT). Через клиента её можно изменить на false, но нельзя изменить на true (поскольку сервер не будет отправлять настройки, если у пользователя в профиле установлено apply_settings_from_server = false).

Обратите внимание, что изначально (24.12) была серверная настройка (send_settings_to_client), но позже она была заменена на эту клиентскую настройку для улучшения удобства использования.

asterisk_include_alias_columns

Тип: Bool

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

Включать ALIAS столбцы для запросов с подстановочными знаками (SELECT *).

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

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

asterisk_include_materialized_columns

Тип: Bool

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

Включать MATERIALIZED столбцы для запросов с подстановочными знаками (SELECT *).

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

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

Тип: Bool

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

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

azure_check_objects_after_upload

Тип: Bool

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

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

azure_create_new_file_on_insert

Тип: Bool

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

Включает или отключает создание нового файла при каждой вставке в таблицы с движком Azure.

azure_ignore_file_doesnt_exist

Тип: Bool

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

Игнорировать отсутствие файла, если он не существует при чтении определённых ключей.

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

1 — SELECT возвращает пустой результат.
0 — SELECT выбрасывает исключение.

azure_skip_empty_files

Тип: Bool

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

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

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

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

azure_strict_upload_part_size

Тип: UInt64

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

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

azure_throw_on_zero_files_match

Тип: Bool

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

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

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

1 — SELECT выбрасывает исключение.
0 — SELECT возвращает пустой результат.

cache_warmer_threads

ClickHouse Cloud only

Тип: UInt64

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

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

calculate_text_stack_trace

Тип: Bool

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

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

cancel_http_readonly_queries_on_client_close

Тип: Bool

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

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

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

cast_ipv4_ipv6_default_on_conversion_error

Тип: Bool

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

Оператор CAST для типов IPv4, IPv6, функции toIPv4, toIPv6 будут возвращать значение по умолчанию вместо выбрасывания исключения при ошибке преобразования.

cast_keep_nullable

Тип: Bool

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

Включает или выключает сохранение типа данных Nullable в операциях CAST.

Когда настройка включена и аргумент функции CAST является Nullable, результат также приводится к типу Nullable. Когда настройка выключена, результат всегда имеет заданный целевой тип.

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

0 — Результат CAST имеет точно указанный целевой тип.
1 — Если тип аргумента Nullable, результат CAST преобразуется в Nullable(DestinationDataType).

Примеры

Следующий запрос приводит к точно целевому типу данных:

Результат:

Следующий запрос приводит к модификации Nullable для целевого типа данных:

Результат:

Смотрите также

Функция CAST

cast_string_to_dynamic_use_inference

Тип: Bool

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

Использование вывода типов во время преобразования String в Dynamic

check_query_single_value_result

Тип: Bool

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

Определяет уровень детализации результата запроса CHECK TABLE для движков семейства MergeTree.

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

0 — запрос показывает статус проверки для каждой отдельной части данных таблицы.
1 — запрос показывает общий статус проверки таблицы.

0 - разрешить всё
1 - переписывает DDL, чтобы использовать *ReplicatedMergeTree
2 - переписывает DDL, чтобы использовать SharedMergeTree
3 - переписывает DDL, чтобы использовать SharedMergeTree, за исключением случаев, когда явно указан удалённый диск

UInt64 для минимизации публичной части

cluster_for_parallel_replicas

Beta feature. Learn more.

Тип: String

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

Кластер для шарда, в котором находится текущий сервер

collect_hash_table_stats_during_aggregation

Тип: Bool

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

Включить сбор статистики хеш-таблицы для оптимизации выделения памяти

collect_hash_table_stats_during_joins

Тип: Bool

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

Включить сбор статистики хеш-таблицы для оптимизации выделения памяти

compatibility

Тип: String

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

Настройка compatibility приводит к тому, что ClickHouse использует стандартные настройки предыдущей версии ClickHouse, где предыдущая версия указывается в настройке.

Если настройки установлены на нестандартные значения, то эти настройки учитываются (только настройки, которые не были изменены, затрагиваются настройкой compatibility).

Эта настройка принимает номер версии ClickHouse в формате строки, как 22.3, 22.8. Пустое значение означает, что эта настройка отключена.

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

примечание

В ClickHouse Cloud настройка совместимости должна быть установлена поддержкой ClickHouse Cloud. Пожалуйста, откройте обращение, чтобы её установить.

compatibility_ignore_auto_increment_in_create_table

Тип: Bool

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

Игнорировать ключевое слово AUTO_INCREMENT в определении столбца, если true, иначе возвращать ошибку. Это упрощает миграцию с MySQL.

compatibility_ignore_collation_in_create_table

Тип: Bool

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

Совместимость игнорирует сопоставление в create table.

compile_aggregate_expressions

Тип: Bool

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

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

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

0 — Аггрегация выполняется без JIT-компиляции.
1 — Аггрегация выполняется с использованием JIT-компиляции.

Смотрите также

min_count_to_compile_aggregate_expression

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

Положительное целое число.
0 — Неограниченный тайм-аут.

connections_with_failover_max_tries

Тип: UInt64

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

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

convert_query_to_cnf

Тип: Bool

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

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

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

Результат:

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

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

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

count_distinct_implementation

Тип: String

Тип: Bool

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

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

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

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

database_atomic_wait_for_drop_and_detach_synchronously

Тип: Bool

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

Добавляет модификатор SYNC ко всем запросам DROP и DETACH.

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

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

database_replicated_initial_query_timeout_sec

Тип: UInt64

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

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

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

Положительное целое число.
0 — Без ограничений.

decimal_check_overflow

Тип: Bool

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

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

deduplicate_blocks_in_dependent_materialized_views

Тип: Bool

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

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

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

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

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

По умолчанию дедупликация не выполняется для материализованных представлений, но производится выше, в исходной таблице. Если вставленный блок пропущен из-за дедупликации в исходной таблице, в прикрепленные материализованные представления вставка не произойдёт. Это поведение необходимо для вставки сильно агрегированных данных в материализованные представления, для случаев, когда вставленные блоки одинаковы после агрегации в материализованном представлении, но получены из разных INSERT в исходную таблицу. Однако это поведение "ломает" идемпотентность INSERT. Если INSERT в основную таблицу был успешным, а INSERT в материализованное представление не удалось (например, из-за сбоя связи с ClickHouse Keeper), клиент получит ошибку и может повторить операцию. Однако материализованное представление не получит вторую вставку, поскольку она будет отброшена дедупликацией в основной (исходной) таблице. Настройка deduplicate_blocks_in_dependent_materialized_views позволяет изменить это поведение. При повторной попытке материализованное представление получит повторную вставку и выполнит проверку на дублирование самостоятельно, проигнорировав результат проверки для исходной таблицы, и вставит строки, потерянные из-за первой ошибки.

default_materialized_view_sql_security

Тип: SQLSecurityType

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

Позволяет установить значение по умолчанию для опции SQL SECURITY при создании materialized view. Подробнее о безопасности SQL.

Значение по умолчанию — DEFINER.

default_max_bytes_in_join

Тип: UInt64

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

Максимальный размер таблицы на правой стороне, если лимит требуется, но max_bytes_in_join не установлен.

default_normal_view_sql_security

Тип: SQLSecurityType

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

Позволяет установить значение по умолчанию для опции SQL SECURITY при создании обычного представления. Подробнее о безопасности SQL.

Значение по умолчанию — INVOKER.

default_table_engine

Тип: DefaultTableEngine

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

Движок таблиц по умолчанию, используемый, когда ENGINE не указан в операторе CREATE.

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

строка, представляющая любое допустимое имя движка таблиц

Значение по умолчанию в облаке: SharedMergeTree.

Пример

Запрос:

Результат:

В этом примере любая новая таблица, которая не указывает Engine, будет использовать движок таблиц Log:

Запрос:

Результат:

default_temporary_table_engine

Тип: DefaultTableEngine

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

То же, что и default_table_engine, но для временных таблиц.

В этом примере любая новая временная таблица, которая не указывает Engine, будет использовать движок таблиц Log:

Запрос:

Результат:

default_view_definer

Тип: String

Тип: Bool

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

Включает/отключает отправку вставленных данных пакетами.

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

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

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

distributed_background_insert_max_sleep_time_ms

Тип: Milliseconds

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

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

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

Положительное целое число в миллисекундах.

distributed_background_insert_sleep_time_ms

Тип: Milliseconds

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

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

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

Положительное целое число в миллисекундах.

distributed_background_insert_split_batch_on_failure

Тип: Bool

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

Включает/отключает разделение пакетов при ошибках.

Иногда отправка определенного пакета на удалённый шард может завершиться неудачей из-за определённого сложного конвейера после (например, MATERIALIZED VIEW с GROUP BY) из-за ошибок, таких как Memory limit exceeded. В этом случае повторение не поможет (и это застрянет распределённые отправки для таблицы), но отправка файлов из этого пакета по одному может успешно выполнить INSERT.

Таким образом, установка этой настройки на 1 отключит пакетирование для таких пакетов (т.е. временно отключит distributed_background_insert_batch для неудачных пакетов).

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

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

примечание

Эта настройка также влияет на повреждённые пакеты (которые могут возникнуть из-за ненормального завершения работы сервера (машины) и отсутствия fsync_after_insert/fsync_directories для движка таблиц Distributed).

примечание

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

ClickHouse Cloud only

Тип: UInt64

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

Действует только в ClickHouse Cloud. Время ожидания в миллисекундах для получения соединения из пула соединений, если distributed_cache_pool_behaviour_on_limit равно wait

distributed_connections_pool_size

Тип: UInt64

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

Максимальное количество одновременных соединений с удалёнными серверами для распределённой обработки всех запросов к одной распределённой таблице. Рекомендуется установить значение не меньше количества серверов в кластере.

distributed_ddl_entry_format_version

Тип: UInt64

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

Версия совместимости распределённых DDL (ON CLUSTER) запросов

distributed_ddl_output_mode

Тип: DistributedDDLOutputMode

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

Устанавливает формат результата распределённого DDL запроса.

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

throw — Возвращает набор результатов с состоянием выполнения запроса для всех хостов, где запрос завершён. Если запрос завершился с ошибкой на некоторых хостах, то он выбросит первое исключение. Если запрос не выполнен ещё на некоторых хостах и distributed_ddl_task_timeout превышен, то он выбрасывает TIMEOUT_EXCEEDED.
none — Похоже на throw, но распределённый DDL запрос не возвращает никакого набора результатов.
null_status_on_timeout — Возвращает NULL в качестве статуса выполнения в некоторых строках набора результатов вместо выбрасывания TIMEOUT_EXCEEDED, если запрос не выполнен на соответствующих хостах.
never_throw — Не выбрасывает TIMEOUT_EXCEEDED и не выбрасывает повторно исключения, если запрос завершился с ошибкой на некоторых хостах.
none_only_active — похоже на none, но не ждёт неактивные реплики базы данных Replicated. Примечание: с этим режимом невозможно выяснить, что запрос не был выполнен на какой-то реплике и будет выполнен в фоновом режиме.
null_status_on_timeout_only_active — похоже на null_status_on_timeout, но не ждёт неактивные реплики базы данных Replicated.
throw_only_active — похоже на throw, но не ждёт неактивные реплики базы данных Replicated.

Значение по умолчанию в облаке: none.

distributed_ddl_task_timeout

Тип: Int64

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

Устанавливает тайм-аут для ответов на DDL запросы от всех хостов в кластере. Если DDL запрос не был выполнен на всех хостах, ответ будет содержать ошибку тайм-аута, и запрос будет выполнен в асинхронном режиме. Отрицательное значение означает бесконечность.

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

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

distributed_foreground_insert

Тип: Bool

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

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

По умолчанию, при вставке данных в «распределенную» таблицу сервер ClickHouse отправляет данные на узлы кластера в фоновом режиме. Когда distributed_foreground_insert=1, данные обрабатываются синхронно, и операция INSERT завершается успешно только после сохранения всех данных на всех шардов (по крайней мере одна реплика для каждого шарда, если internal_replication истинно).

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

0 — Данные вставляются в фоновом режиме.
1 — Данные вставляются в синхронном режиме.

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

См. также

distributed_group_by_no_merge

Тип: UInt64

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

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

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

0 — Отключено (окончательная обработка запроса выполняется на инициаторе).
1 - Не сливать состояния агрегации с разных серверов для распределённой обработки запроса (запрос полностью обрабатывается на шарде, инициатор только проксирует данные), может быть использовано в случае, когда точно известно, что на разных шардах разные ключи.
2 - То же, что и 1, но применяет ORDER BY и LIMIT (это невозможно, когда запрос полностью обрабатывается на удалённом узле, как для distributed_group_by_no_merge=1) на инициаторе (может быть использовано для запросов с ORDER BY и/или LIMIT).

Пример

distributed_insert_skip_read_only_replicas

Тип: Bool

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

Включает пропуск только для чтения реплик для INSERT запросов в Distributed.

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

0 — INSERT ведет себя как обычно, если он пойдет на реплику только для чтения, он завершится неудачей.
1 — Инициатор будет пропускать реплики только для чтения перед отправкой данных на шарды.

distributed_product_mode

Тип: DistributedProductMode

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

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

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

Ограничения:

Применяется только для IN и JOIN подзапросов.
Только если секция FROM использует распределенную таблицу, содержащую более одного шарда.
Если подзапрос касается распределенной таблицы, содержащей более одного шарда.
Не используется для табличной функции remote.

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

deny — Значение по умолчанию. Запрещает использовать эти типы подзапросов (возвращает исключение "Double-distributed in/JOIN subqueries is denied").
local — Заменяет базу данных и таблицу в подзапросе на локальные для сервера назначения (шарда), оставляя нормальные IN/JOIN.
global — Заменяет запрос IN/JOIN на GLOBAL IN/GLOBAL JOIN.
allow — Разрешает использование этих типов подзапросов.

distributed_push_down_limit

Тип: UInt64

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

Включает или отключает применение LIMIT на каждом шарде отдельно.

Это позволит избежать:

Отправки лишних строк по сети;
Обработки строк за пределами лимита на инициаторе.

Начиная с версии 21.9 вы больше не можете получать неточные результаты, так как distributed_push_down_limit изменяет выполнение запроса, только если выполнено одно из условий:

distributed_group_by_no_merge > 0.
Запрос не имеет GROUP BY/DISTINCT/LIMIT BY, но имеет ORDER BY/LIMIT.
Запрос имеет GROUP BY/DISTINCT/LIMIT BY с ORDER BY/LIMIT и:
- optimize_skip_unused_shards включен.
- optimize_distributed_group_by_sharding_key включен.

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

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

См. также:

distributed_group_by_no_merge
optimize_skip_unused_shards
optimize_distributed_group_by_sharding_key

distributed_replica_error_cap

Тип: UInt64

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

Тип: unsigned int
Значение по умолчанию: 1000

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

См. также:

load_balancing
Движок таблиц Distributed
distributed_replica_error_half_life
distributed_replica_max_ignored_errors

distributed_replica_error_half_life

Тип: Seconds

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

Тип: seconds
Значение по умолчанию: 60 seconds

Контролирует, как быстро обнуляются ошибки в распределённых таблицах. Если реплика недоступна некоторое время, накапливает 5 ошибок, и distributed_replica_error_half_life установлен на 1 секунду, то реплика считается нормальной через 3 секунды после последней ошибки.

См. также:

load_balancing
Движок таблиц Distributed
distributed_replica_error_cap
distributed_replica_max_ignored_errors

distributed_replica_max_ignored_errors

Тип: UInt64

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

Тип: unsigned int
Значение по умолчанию: 0

Количество ошибок, которые будут проигнорированы при выборе реплик (согласно алгоритму load_balancing).

См. также:

load_balancing
Движок таблиц Distributed
distributed_replica_error_cap
distributed_replica_error_half_life

do_not_merge_across_partitions_select_final

Тип: Bool

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

Слияние частей только в одном разделе в select final

empty_result_for_aggregation_by_constant_keys_on_empty_set

Тип: Bool

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

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

empty_result_for_aggregation_by_empty_set

Тип: Bool

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

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

enable_adaptive_memory_spill_scheduler

Experimental feature. Learn more.

Тип: Bool

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

Включает процессор для адаптивного сброса данных на внешнее хранилище. В настоящее время поддерживается grace join.

enable_blob_storage_log

Тип: Bool

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

Записывать информацию о операциях blob storage в таблицу system.blob_storage_log

enable_deflate_qpl_codec

Тип: Bool

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

Если включено, кодек DEFLATE_QPL можно использовать для сжатия столбцов.

enable_early_constant_folding

Тип: Bool

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

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

enable_extended_results_for_datetime_functions

Тип: Bool

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

Включает или отключает возвращение результатов типа:

Date32 с расширенным диапазоном (по сравнению с типом Date) для функций toStartOfYear, toStartOfISOYear, toStartOfQuarter, toStartOfMonth, toLastDayOfMonth, toStartOfWeek, toLastDayOfWeek и toMonday.
DateTime64 с расширенным диапазоном (по сравнению с типом DateTime) для функций toStartOfDay, toStartOfHour, toStartOfMinute, toStartOfFiveMinutes, toStartOfTenMinutes, toStartOfFifteenMinutes и timeSlot.

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

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

enable_http_compression

Тип: Bool

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

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

Для получения дополнительной информации прочитайте описание HTTP интерфейса.

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

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

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

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

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

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

Рассмотрим следующие запросы:

SELECT count() FROM test_table WHERE date = '2018-10-10'
SELECT count() FROM (SELECT * FROM test_table) WHERE date = '2018-10-10'

Если enable_optimize_predicate_expression = 1, тогда время выполнения этих запросов равно, так как ClickHouse применяет WHERE к подзапросу при его обработке.

Если enable_optimize_predicate_expression = 0, тогда время выполнения второго запроса значительно дольше, так как WHERE применяется ко всем данным после завершения подзапроса.

enable_optimize_predicate_expression_to_final_subquery

Тип: Bool

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

Разрешить проталкивание предиката в финальный подзапрос.

enable_order_by_all

Тип: Bool

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

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

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

0 — Отключить ORDER BY ALL.
1 — Включить ORDER BY ALL.

Пример

Запрос:

Результат:

enable_parsing_to_custom_serialization

Тип: Bool

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

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

enable_positional_arguments

Тип: Bool

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

Включает или отключает поддержку позиционных аргументов для операторов GROUP BY, LIMIT BY, ORDER BY.

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

0 — Позиционные аргументы не поддерживаются.
1 — Позиционные аргументы поддерживаются: можно использовать номера столбцов вместо имён столбцов.

Пример

Запрос:

Результат:

enable_reads_from_query_cache

Тип: Bool

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

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

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

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

Включено по умолчанию.

enable_vertical_final

Тип: Bool

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

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

enable_writes_to_query_cache

Тип: Bool

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

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

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

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

enable_zstd_qat_codec

Тип: Bool

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

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

enforce_strict_identifier_format

Тип: Bool

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

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

engine_file_allow_create_multiple_files

Тип: Bool

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

Позволяет или запрещает создание нового файла при каждой вставке в таблицы движка file, если формат имеет суффикс (JSON, ORC, Parquet и т.д.). Если включено, при каждой вставке будет создаваться новый файл с именем по следующему шаблону:

data.Parquet -> data.1.Parquet -> data.2.Parquet, и т.д.

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

0 — запрос INSERT добавляет новые данные в конец файла.
1 — запрос INSERT создает новый файл.

engine_file_empty_if_not_exists

Тип: Bool

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

Позволяет выбрать данные из таблицы движка file без файла.

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

0 — SELECT выбрасывает исключение.
1 — SELECT возвращает пустой результат.

engine_file_skip_empty_files

Тип: Bool

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

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

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

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

engine_file_truncate_on_insert

Тип: Bool

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

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

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

0 — запрос INSERT добавляет новые данные в конец файла.
1 — запрос INSERT заменяет существующее содержимое файла новыми данными.

engine_url_skip_empty_files

Тип: Bool

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

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

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

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

except_default_mode

Тип: Bool

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

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

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

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

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

filesystem_cache_boundary_alignment

Тип: UInt64

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

Выравнивание границ кэша файловой системы. Эта настройка применяется только для не-дисковых чтений (например, для кэша удаленных движков таблиц / табличных функций, но не для конфигурации хранения таблиц MergeTree). Значение 0 означает отсутствие выравнивания.

filesystem_cache_enable_background_download_during_fetch

ClickHouse Cloud only

Тип: Bool

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

Воздействует только в ClickHouse Cloud. Время ожидания блокировки кэша для резервирования места в файловой системе

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

ClickHouse Cloud only

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

Пример:

flatten_nested

Тип: Bool

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

Устанавливает формат данных вложенных столбцов.

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

1 — Вложенный столбец расплющивается в отдельные массивы.
0 — Вложенный столбец остаётся единым массивом кортежей.

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

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

Примеры

Запрос:

Результат:

Запрос:

Результат:

force_aggregate_partitions_independently

Тип: Bool

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

Принудительное использование оптимизации, когда она применима, но эвристика решила не использовать её.

force_aggregation_in_order

Тип: Bool

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

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

force_data_skipping_indices

Тип: String

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

Отключает выполнение запроса, если переданные индексы пропуска данных не были использованы.

Рассмотрим следующий пример:

force_grouping_standard_compatibility

Тип: Bool

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

Заставляет функцию GROUPING возвращать 1, когда аргумент не используется в качестве ключа агрегации.

force_index_by_date

Тип: Bool

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

Отключает выполнение запроса, если индекс не может быть использован по дате.

Работает с таблицами семейства MergeTree.

Если force_index_by_date=1, ClickHouse проверяет, есть ли в запросе условие ключа по дате, которое может быть использовано для ограничения диапазонов данных. Если подходящего условия нет, выбрасывается исключение. Однако, оно не проверяет, уменьшает ли условие объем читаемых данных. Например, условие Date != '2000-01-01' является допустимым, даже если оно соответствует всем данным в таблице (т.е., выполнение запроса требует полного сканирования). Для получения более подробной информации о диапазонах данных в таблицах MergeTree, см. MergeTree.

force_optimize_projection

Тип: Bool

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

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

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

0 — Оптимизация проекций не обязательна.
1 — Оптимизация проекций обязательна.

force_optimize_projection_name

Тип: String

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

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

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

строка: имя проекции, использованной в запросе

force_optimize_skip_unused_shards

Тип: UInt64

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

Включает или отключает выполнение запроса, если optimize_skip_unused_shards включено и пропуск неиспользуемых шардов невозможен. Если пропуск невозможен и настройка включена, будет выброшено исключение.

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

0 — Отключено. ClickHouse не выбрасывает исключение.
1 — Включено. Выполнение запроса отключено только если таблица имеет ключ шардирования.
2 — Включено. Выполнение запроса отключено независимо от того, определен ли ключ шардирования у таблицы.

force_optimize_skip_unused_shards_nesting

Тип: UInt64

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

Контролирует force_optimize_skip_unused_shards (следовательно, все еще требует force_optimize_skip_unused_shards), в зависимости от уровня вложенности распределенного запроса (случай, когда у вас есть таблица Distributed, которая смотрит в другую таблицу Distributed).

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

0 - Отключено, force_optimize_skip_unused_shards работает всегда.
1 — Включает force_optimize_skip_unused_shards только для первой уровня.
2 — Включает force_optimize_skip_unused_shards до второго уровня.

force_primary_key

Тип: Bool

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

Тип: Bool

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

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

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

function_implementation

Тип: String

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

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

function_json_value_return_type_allow_complex

Тип: Bool

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

Контролирует, разрешать ли возвращать сложные типы (такие как: структура, массив, карта) для функции json_value.

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

true — Разрешить.
false — Запретить.

function_json_value_return_type_allow_nullable

Тип: Bool

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

Контролирует, разрешать ли возвращать NULL, когда значение не существует для функции JSON_VALUE.

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

true — Разрешить.
false — Запретить.

function_locate_has_mysql_compatible_argument_order

Тип: Bool

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

Контролирует порядок аргументов в функции locate.

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

0 — Функция locate принимает аргументы (haystack, needle[, start_pos]).
1 — Функция locate принимает аргументы (needle, haystack, [, start_pos]) (совместимое с MySQL поведение).

function_range_max_elements_in_block

Тип: UInt64

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

Устанавливает порог безопасности для объема данных, генерируемых функцией range. Определяет максимальное количество значений, генерируемых функцией на блок данных (сумма размеров массивов для каждой строки в блоке).

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

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

См. также

max_block_size
min_insert_block_size_rows

function_sleep_max_microseconds_per_block

Тип: UInt64

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

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

function_visible_width_behavior

Тип: UInt64

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

Версия поведения visibleWidth. 0 - только считает количество кодовых точек; 1 - правильно учитывает нулевой ширины и комбинируемые символы, считает полноширинные символы как два, оценивает ширину табуляции, считает символы удаления.

geo_distance_returns_float64_on_float64_arguments

Тип: Bool

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

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

glob_expansion_max_elements

Тип: UInt64

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

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

grace_hash_join_initial_buckets

Experimental feature. Learn more.

Тип: NonZeroUInt64

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

Начальное количество корзин grace hash join.

grace_hash_join_max_buckets

Experimental feature. Learn more.

Тип: NonZeroUInt64

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

Ограничение на количество корзин grace hash join.

group_by_overflow_mode

Тип: OverflowModeGroupBy

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

Что делать, когда лимит превышен.

group_by_two_level_threshold

Тип: UInt64

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

С какого количества ключей начинается двухуровневая агрегация. 0 - порог не установлен.

group_by_two_level_threshold_bytes

Тип: UInt64

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

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

group_by_use_nulls

Тип: Bool

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

Изменяет то, как оператор GROUP BY обрабатывает типы ключей агрегации. Когда используются спецификаторы ROLLUP, CUBE или GROUPING SETS, некоторые ключи агрегации могут не использоваться для генерации некоторых строк результатов. Столбцы для этих ключей заполняются либо значением по умолчанию, либо NULL в соответствующих строках, в зависимости от этой настройки.

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

0 — Значение по умолчанию для типа ключа агрегации используется для генерации отсутствующих значений.
1 — ClickHouse выполняет GROUP BY так, как требует стандарт SQL. Типы ключей агрегации преобразуются в Nullable. Столбцы для соответствующих ключей агрегации заполняются NULL для строк, которые его не использовали.

Смотрите также:

Оператор GROUP BY

h3togeo_lon_lat_result_order

Тип: Bool

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

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

handshake_timeout_ms

Тип: Milliseconds

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

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

hdfs_create_new_file_on_insert

Тип: Bool

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

Включает или отключает создание нового файла при каждой вставке в таблицы движка HDFS. Если включено, при каждой вставке будет создан новый HDFS файл с именем, аналогичным этому шаблону:

изначально: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz, и т.д.

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

0 — запрос INSERT добавляет новые данные в конец файла.
1 — запрос INSERT создает новый файл.

hdfs_ignore_file_doesnt_exist

Тип: Bool

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

Игнорировать отсутствие файла, если его нет при чтении определённых ключей.

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

1 — SELECT возвращает пустой результат.
0 — SELECT выбрасывает исключение.

hdfs_replication

Тип: UInt64

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

Фактическое количество репликаций может быть указано при создании файла hdfs.

hdfs_skip_empty_files

Тип: Bool

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

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

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

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

hdfs_throw_on_zero_files_match

Тип: Bool

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

Выбрасывать ошибку, если не найдено ни одного файла согласно правилам расширения glob.

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

1 — SELECT выбрасывает исключение.
0 — SELECT возвращает пустой результат.

hdfs_truncate_on_insert

Тип: Bool

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

Включает или отключает усечение перед вставкой в таблицы движка hdfs. Если отключено, при попытке вставки выбрасывается исключение, если файл в HDFS уже существует.

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

0 — запрос INSERT добавляет новые данные в конец файла.
1 — запрос INSERT заменяет существующее содержимое файла новыми данными.

hedged_connection_timeout_ms

Тип: Milliseconds

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

Таймаут подключения для установления соединения с репликой для Hedged запросов.

hnsw_candidate_list_size_for_search

Experimental feature. Learn more.

Тип: UInt64

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

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

hsts_max_age

Тип: UInt64

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

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

http_connection_timeout

Тип: Seconds

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

Таймаут соединения HTTP (в секундах).

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

Любое положительное целое число.
0 - Отключено (бесконечный таймаут).

http_max_uri_size

Тип: UInt64

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

Устанавливает максимальную длину URI HTTP запроса.

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

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

http_native_compression_disable_checksumming_on_decompress

Тип: Bool

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

Включает или отключает проверку контрольной суммы при разжатии данных HTTP POST от клиента. Используется только для нативного формата сжатия ClickHouse (не используется с gzip или deflate).

Для получения дополнительной информации прочтите описание HTTP интерфейса.

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

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

http_receive_timeout

Тип: Seconds

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

Таймаут приема HTTP (в секундах).

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

Любое положительное целое число.
0 - Отключено (бесконечный таймаут).

http_response_buffer_size

Тип: UInt64

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

Количество байтов, которые буферизуются в памяти сервера перед отправкой HTTP-ответа клиенту или сбросом на диск (когда включен http_wait_end_of_query).

http_response_headers

Тип: Map

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

Позволяет добавить или переопределить HTTP-заголовки, которые сервер вернёт в ответе при успешном выполнении запроса. Эта настройка влияет только на HTTP интерфейс.

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

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

Ни имена, ни значения не могут содержать управляющие ASCII-символы.

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

Пример: SET http_response_headers = '{"Content-Type": "image/png"}'

http_retry_initial_backoff_ms

Тип: UInt64

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

Минимальное количество миллисекунд для обратного отсчёта при повторных чтениях через HTTP.

http_retry_max_backoff_ms

Тип: UInt64

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

Максимальное количество миллисекунд для обратного отсчёта при повторных чтениях через HTTP.

http_send_timeout

Тип: Seconds

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

Тайм-аут отправки HTTP (в секундах).

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

Любое положительное целое число.
0 - Отключено (бесконечный тайм-аут).

примечание

Применимо только к профилю по умолчанию. Необходима перезагрузка сервера для вступления изменений в силу.

http_skip_not_found_url_for_globs

Тип: Bool

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

Пропускать URL-адреса для шаблонов с ошибкой HTTP_NOT_FOUND.

http_wait_end_of_query

Тип: Bool

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

Включить буферизацию HTTP-ответов на стороне сервера.

http_write_exception_in_output_format

Тип: Bool

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

Записывает исключение в формате вывода для получения корректного вывода. Работает с JSON и XML форматами.

http_zlib_compression_level

Тип: Int64

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

Устанавливает уровень сжатия данных в ответ на HTTP-запрос, если enable_http_compression = 1.

Возможные значения: числа от 1 до 9.

iceberg_snapshot_id

Тип: Int64

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

Запрос к таблице Iceberg, используя конкретный идентификатор снепшота.

iceberg_timestamp_ms

Тип: Int64

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

Запрос к таблице Iceberg, используя снепшот, который был актуален на определённый момент времени.

idle_connection_timeout

Тип: UInt64

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

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

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

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

ignore_cold_parts_seconds

ClickHouse Cloud only

Тип: Int64

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

Оказывает эффект только в ClickHouse Cloud. Исключает новые части данных из SELECT запросов до тех пор, пока они не будут предварительно прогреты (см. cache_populated_by_fetch) или пока им не исполнится указанное количество секунд. Используется только для Replicated-/SharedMergeTree.

ignore_data_skipping_indices

Тип: String

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

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

Рассмотрим следующий пример:

Тип: Bool

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

Включает или отключает сохраняющее порядок параллельное парсирование форматов данных. Поддерживается только для форматов TSV, TSKV, CSV и JSONEachRow.

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

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

insert_allow_materialized_columns

Тип: Bool

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

Если настройка включена, разрешает материализованные столбцы в INSERT.

insert_deduplicate

Тип: Bool

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

Включает или отключает дедупликацию блоков данных при INSERT (для Replicated* таблиц).

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

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

По умолчанию, блоки, вставленные в реплицируемые таблицы с помощью команды INSERT, дублируются (см. Репликация данных). Для реплицируемых таблиц по умолчанию только 100 наиболее недавно добавленных блоков для каждого раздела дедуплицируются (см. replicated_deduplication_window, replicated_deduplication_window_seconds). Для не реплицируемых таблиц см. non_replicated_deduplication_window.

insert_deduplication_token

Тип: String

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

Настройка позволяет пользователю предоставить собственную дедупликационную семантику в MergeTree/ReplicatedMergeTree. Например, предоставив уникальное значение для этой настройки в каждом операторе INSERT, пользователь может избежать дедупликации одинаково вставленных данных.

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

Любая строка

insert_deduplication_token используется для дедупликации только когда он не пуст.

Для реплицируемых таблиц по умолчанию только 100 наиболее недавно вставленных значений для каждого раздела дедуплицируется (см. replicated_deduplication_window, replicated_deduplication_window_seconds). Для не реплицируемых таблиц см. non_replicated_deduplication_window.

примечание

insert_deduplication_token работает на уровне разделов (так же как и хеш-сумма insert_deduplication). Несколько разделов могут иметь один и тот же insert_deduplication_token.

Пример:

insert_keeper_fault_injection_probability

Тип: Float

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

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

insert_keeper_fault_injection_seed

Тип: UInt64

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

0 - случайное значение, иначе указано значение настройки.

insert_keeper_max_retries

Тип: UInt64

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

Эта настройка устанавливает максимальное количество повторов для запросов ClickHouse Keeper (или ZooKeeper) во время вставки в реплицируемый MergeTree. Повторяются только те запросы к Keeper, которые завершились ошибкой из-за сетевой ошибки, истечения времени сессии Keeper или тайм-аута запроса.

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

Положительное целое число.
0 — Повторы отключены.

Значение по умолчанию в облаке: 20.

Повторы запросов к Keeper выполняются после тайм-аута. Тайм-аут контролируется следующими настройками: insert_keeper_retry_initial_backoff_ms, insert_keeper_retry_max_backoff_ms. Первый повтор выполняется после тайм-аута insert_keeper_retry_initial_backoff_ms. Последующие таймауты будут рассчитаны следующим образом:

Например, если insert_keeper_retry_initial_backoff_ms=100, insert_keeper_retry_max_backoff_ms=10000 и insert_keeper_max_retries=8, тогда таймауты будут 100, 200, 400, 800, 1600, 3200, 6400, 10000.

Помимо отказоустойчивости, повторные попытки нацелены на улучшение пользовательского опыта - они позволяют избежать возврата ошибки во время выполнения INSERT, если Keeper перезапущен, например, из-за обновления.

insert_keeper_retry_initial_backoff_ms

Тип: UInt64

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

Начальный тайм-аут (в миллисекундах) для повторения неудачного запроса к Keeper во время выполнения INSERT запроса.

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

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

insert_keeper_retry_max_backoff_ms

Тип: UInt64

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

Максимальный тайм-аут (в миллисекундах) для повторения неудачного запроса к Keeper во время выполнения INSERT запроса.

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

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

insert_null_as_default

Тип: Bool

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

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

Эта настройка применима к INSERT ... SELECT запросам. Обратите внимание, что подзапросы SELECT могут быть соединены оператором UNION ALL.

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

0 — Вставка NULL в не nullable столбец вызывает исключение.
1 — Значение по умолчанию вставляется вместо NULL.

insert_quorum

Тип: UInt64Auto

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

примечание

Эта настройка не применима к SharedMergeTree, для получения дополнительной информации см. SharedMergeTree consistency.

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

Если insert_quorum < 2, кворумные записи отключены.
Если insert_quorum >= 2, кворумные записи включены.
Если insert_quorum = 'auto', используется большинство (number_of_replicas / 2 + 1) в качестве числа кворума.

Кворумные записи

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

Когда insert_quorum_parallel отключен, все реплики в кворуме согласованы, т.е. они содержат данные от всех предыдущих INSERT запросов (последовательность INSERT линейнозирована). При чтении данных, записанных с использованием insert_quorum и insert_quorum_parallel отключен, вы можете включить последовательную согласованность для SELECT запросов с использованием select_sequential_consistency.

ClickHouse генерирует исключение:

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

См. также:

insert_quorum_timeout
insert_quorum_parallel
select_sequential_consistency

insert_quorum_parallel

Тип: Bool

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

примечание

Эта настройка не применима к SharedMergeTree, для получения дополнительной информации см. SharedMergeTree consistency.

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

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

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

См. также:

insert_quorum
insert_quorum_timeout
select_sequential_consistency

insert_quorum_timeout

Тип: Milliseconds

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

Тайм-аут на запись в кворум в миллисекундах. Если тайм-аут истек, и запись ещё не состоялась, ClickHouse сгенерирует исключение, и клиент должен повторить запрос для записи того же блока на ту же или любую другую реплику.

См. также:

insert_quorum
insert_quorum_parallel
select_sequential_consistency

insert_shard_id

Тип: UInt64

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

Если не 0, указывает шарду Distributed таблицы, в которую данные будут вставлены синхронно.

Если значение insert_shard_id неправильное, сервер выдаст исключение.

Чтобы получить количество шард на requested_cluster, вы можете проверить конфигурацию сервера или использовать этот запрос:

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

0 — Отключено.
Любое число от 1 до shards_num соответствующей Distributed таблицы.

Пример

Запрос:

Результат:

interactive_delay

Тип: UInt64

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

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

intersect_default_mode

Тип: SetOperationMode

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

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

join_algorithm

Тип: JoinAlgorithm

Значение по умолчанию: direct,parallel_hash,hash

Определяет, какой алгоритм JOIN используется.

Может быть указано несколько алгоритмов, и подходящий будет выбран для определённого запроса на основе типа/строгости и движка таблицы.

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

grace_hash

Grace hash join используется. Grace hash предоставляет вариант алгоритма, который обеспечивает производительные сложные соединения при ограничении использования памяти.

Первая фаза grace join читает правую таблицу и делит её на N сегментов в зависимости от хеш-значения ключевых столбцов (изначально, N это grace_hash_join_initial_buckets). Это делается таким образом, чтобы каждый сегмент можно было обработать независимо. Строки из первого сегмента добавляются в хеш-таблицу в оперативной памяти, а остальные сохраняются на диск. Если хеш-таблица превысит лимит памяти (например, установленный через max_bytes_in_join, число сегментов увеличивается и переопределяется сегмент для каждой строки. Любые строки, которые не относятся к текущему сегменту, сбрасываются и переназначаются.

Поддерживает INNER/LEFT/RIGHT/FULL ALL/ANY JOIN.

hash

Hash join algorithm используется. Наиболее универсальная реализация, поддерживающая все комбинации типа и строгости и множественные ключи соединения, которые объединяются с помощью OR в секции JOIN ON.

При использовании алгоритма hash, правая часть JOIN загружается в оперативную память.

parallel_hash

Вариант hash join, который разбивает данные на сегменты и строит несколько хеш-таблиц вместо одной одновременно, чтобы ускорить этот процесс.

При использовании алгоритма parallel_hash, правая часть JOIN загружается в оперативную память.

partial_merge

Вариант алгоритма сортировки-соединения, где только правая таблица полностью отсортирована.

RIGHT JOIN и FULL JOIN поддерживаются только со строгостью ALL (SEMI, ANTI, ANY и ASOF не поддерживаются).

При использовании алгоритма partial_merge, ClickHouse сортирует данные и сбрасывает их на диск. Алгоритм partial_merge в ClickHouse немного отличается от классической реализации. Сначала ClickHouse сортирует правую таблицу по ключам соединения в блоках и создаёт разреженный индекс для отсортированных блоков. Затем он сортирует части левой таблицы по ключу соединения и соединяет их с правой таблицей. Разреженный индекс также используется для пропуска ненужных блоков правой таблицы.

direct

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

Алгоритм direct выполняет поиск в правой таблице, используя строки из левой таблицы в качестве ключей. Он поддерживается только для специального хранилища, такого как Dictionary или EmbeddedRocksDB, и только для LEFT и INNER JOIN.

auto

Когда установлено auto, сначала пробуется hash join, и алгоритм переключается на другой на лету, если лимит памяти нарушен.

full_sorting_merge

Алгоритм сортировки-соединения с полной сортировкой соединяемых таблиц перед объединением.

prefer_partial_merge

ClickHouse всегда пытается использовать partial_merge join, если возможно, иначе использует hash. Устаревший, то же, что и partial_merge,hash.

default (устаревший)

Устаревшее значение, пожалуйста, больше не используйте. То же самое, что direct,hash, т.е. пытается использовать прямое соединение и хеш join (в этом порядке).

join_any_take_last_row

Тип: Bool

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

Изменяет поведение операций соединения с ANY строгостью.

примечание

Эта настройка применяется только к операциям JOIN с таблицами на движке Join.

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

0 — Если в правой таблице больше одной подходящей строки, соединяется только первая найденная.
1 — Если в правой таблице больше одной подходящей строки, соединяется только последняя найденная.

См. также:

join_default_strictness

Тип: JoinStrictness

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

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

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

ALL — Если в правой таблице несколько подходящих строк, ClickHouse создаёт кардинальное произведение из подходящих строк. Это нормальное поведение JOIN из стандартного SQL.
ANY — Если в правой таблице несколько подходящих строк, соединяется только первая найденная. Если в правой таблице только одна подходящая строка, результаты ANY и ALL одинаковы.
ASOF — Для соединения последовательностей с неопределённым соответствием.
Empty string — Если в запросе не указаны ALL или ANY, ClickHouse генерирует исключение.

join_on_disk_max_files_to_merge

Тип: UInt64

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

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

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

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

Любое положительное целое число, начиная с 2.

join_output_by_rowlist_perkey_rows_threshold

Тип: UInt64

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

Нижний предел среднего количества строк на ключ в правой таблице, чтобы определить, следует ли выводить по списку строк в hash join.

join_overflow_mode

Тип: OverflowMode

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

Что делать при превышении лимита.

join_to_sort_maximum_table_rows

Experimental feature. Learn more.

Тип: UInt64

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

Максимальное количество строк в правой таблице для определения, следует ли перенастроить правую таблицу по ключу в левом или внутреннем join.

join_to_sort_minimum_perkey_rows

Experimental feature. Learn more.

Тип: UInt64

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

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

join_use_nulls

Тип: Bool

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

Устанавливает тип поведения JOIN. При объединении таблиц могут появляться пустые ячейки. ClickHouse заполняет их по-разному в зависимости от этой настройки.

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

0 — Пустые ячейки заполняются значением по умолчанию для соответствующего типа поля.
1 — JOIN ведёт себя так же, как в стандартном SQL. Тип соответствующего поля преобразуется в Nullable, а пустые ячейки заполняются NULL.

joined_subquery_requires_alias

Тип: Bool

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

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

kafka_disable_num_consumers_limit

Тип: Bool

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

Отключить лимит на kafka_num_consumers, который зависит от количества доступных ядер CPU.

kafka_max_wait_ms

Тип: Milliseconds

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

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

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

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

См. также:

Apache Kafka

lightweight_deletes_sync

Тип: UInt64

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

То же, что и mutations_sync, но управляет только выполнением легковесных удалений.

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

0 - Мутации выполняются асинхронно.
1 - Запрос ожидает завершения легковесных удалений на текущем сервере.
2 - Запрос ожидает завершения легковесных удалений на всех репликах (если они существуют).

См. также

limit

Тип: UInt64

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

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

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

0 — Количество строк не ограничено.
Положительное целое число.

live_view_heartbeat_interval

Experimental feature. Learn more.

Тип: Seconds

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

Интервал сердцебиения в секундах, чтобы указать, что live-запрос активен.

load_balancing

Тип: LoadBalancing

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

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

ClickHouse поддерживает следующие алгоритмы выбора реплик:

Случайно (по умолчанию)
Ближайшее имя хоста
Расстояние Левенштейна к имени хоста
В порядке
Первый или случайный
Круговой

См. также:

distributed_replica_max_ignored_errors

Случайно (по умолчанию)

Количество ошибок учитывается для каждой реплики. Запрос отправляется на реплику с наименьшим количеством ошибок, а если таких несколько, то на любую из них. Недостатки: близость сервера не учитывается; если у реплик разные данные, вы также получите разные данные.

Ближайшее имя хоста

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

Например, example01-01-1 и example01-01-2 отличаются в одной позиции, в то время как example01-01-1 и example01-02-2 отличаются в двух местах. Этот метод может показаться примитивным, но он не требует внешних данных о топологии сети и не сравнивает IP-адреса, что было бы сложным для наших IPv6-адресов.

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

Расстояние Левенштейна для имени хоста

Подобно nearest_hostname, но сравнивает имя хоста по расстоянию Левенштейна. Например:

В порядке

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

Первая или случайная

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

Алгоритм first_or_random решает проблему алгоритма in_order. С in_order, если одна реплика выходит из строя, следующая получает двойную нагрузку, в то время как оставшиеся реплики обрабатывают обычное количество трафика. При использовании алгоритма first_or_random нагрузка равномерно распределяется между доступными репликами.

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

Круговая очередь

Этот алгоритм использует политику круговой очереди между репликами с одинаковым количеством ошибок (учитываются только запросы с политикой round_robin).

load_balancing_first_offset

Тип: UInt64

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

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

load_marks_asynchronously

Тип: Bool

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

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

local_filesystem_read_method

Тип: String

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

Метод чтения данных с локальной файловой системы, один из: read, pread, mmap, io_uring, pread_threadpool. Метод 'io_uring' является экспериментальным и не работает для Log, TinyLog, StripeLog, File, Set и Join, и других таблиц с добавляемыми файлами при наличии одновременного чтения и записи.

local_filesystem_read_prefetch

Тип: Bool

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

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

lock_acquire_timeout

Тип: Секунды

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

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

Тайм-аут блокировки используется для защиты от взаимных блокировок при выполнении операций чтения/записи с таблицами. Когда время ожидания истекает и запрос на блокировку не удаётся, сервер ClickHouse выбрасывает исключение "Время попытки блокировки истекло! Возможная взаимная блокировка предотвращена. Клиент должен повторить попытку." с кодом ошибки DEADLOCK_AVOIDED.

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

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

log_comment

Тип: String

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

Устанавливает значение для поля log_comment в таблице system.query_log и текст комментария для серверного лога.

Может использоваться для улучшения читаемости серверных логов. Кроме того, это помогает выбрать запросы, связанные с тестом, из system.query_log после выполнения clickhouse-test.

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

Любая строка длиной не более max_query_size. Если превышено значение max_query_size, сервер выбрасывает исключение.

Пример

Запрос:

Результат:

log_formatted_queries

Тип: Bool

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

Позволяет логировать отформатированные запросы в системную таблицу system.query_log (заполняет столбец formatted_query в system.query_log).

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

0 — Отформатированные запросы не логируются в системной таблице.
1 — Отформатированные запросы логируются в системной таблице.

log_processors_profiles

Тип: Bool

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

Записывает время, которое процессор потратил во время выполнения/ожидания данных в таблицу system.processors_profile_log.

См. также:

log_profile_events

Тип: Bool

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

Логировать статистику производительности запроса в query_log, query_thread_log и query_views_log.

log_queries

Тип: Bool

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

Настройка логирования запросов.

Запросы, отправленные в ClickHouse с этой настройкой, логируются в соответствии с правилами в параметре конфигурации сервера query_log.

Пример:

log_queries_cut_to_length

Тип: UInt64

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

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

log_queries_min_query_duration_ms

Тип: Миллисекунды

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

Если включено (ненулевое значение), запросы быстрее заданного значения этой настройки не будут логироваться (это можно рассматривать как long_query_time для MySQL Slow Query Log), и это, по сути, означает, что вы не найдёте их в следующих таблицах:

system.query_log
system.query_thread_log

Только запросы с следующим типом попадут в лог:

QUERY_FINISH
EXCEPTION_WHILE_PROCESSING
Тип: миллисекунды
Значение по умолчанию: 0 (любой запрос)

log_queries_min_type

Тип: LogQueriesType

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

Минимальный тип query_log для логирования.

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

QUERY_START (=1)
QUERY_FINISH (=2)
EXCEPTION_BEFORE_START (=3)
EXCEPTION_WHILE_PROCESSING (=4)

Можно использовать для ограничения, какие сущности попадут в query_log, например если вас интересуют только ошибки, тогда вы можете использовать EXCEPTION_WHILE_PROCESSING:

log_queries_probability

Тип: Float

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

Позволяет пользователю записывать в системные таблицы query_log, query_thread_log и query_views_log только выборку запросов, выбранных случайным образом с указанной вероятностью. Это помогает снизить нагрузку при большом объёме запросов в секунду.

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

0 — Запросы не логируются в системных таблицах.
Положительное вещественное число в диапазоне [0..1]. Например, если значение настройки равно 0.5, около половины запросов логируются в системных таблицах.
1 — Все запросы логируются в системных таблицах.

log_query_settings

Тип: Bool

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

Логировать настройки запроса в query_log и лог span OpenTelemetry.

log_query_threads

Тип: Bool

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

Настройка логирования потоков запросов.

Потоки запросов логируются в таблицу system.query_thread_log. Эта настройка действует только когда log_queries установлено в true. Потоки запросов, выполняемые ClickHouse с этой настройкой, логируются в соответствии с правилами в параметре конфигурации сервера query_thread_log.

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

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

Пример

log_query_views

Тип: Bool

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

Настройка логирования представлений запросов.

Когда запрос, выполняемый ClickHouse с этой настройкой, имеет связанные представления (материализованные или live), они логируются в параметре конфигурации сервера query_views_log.

Пример:

low_cardinality_allow_in_native_format

Тип: Bool

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

Разрешает или запрещает использование типа данных LowCardinality с форматом Native.

Если использование LowCardinality запрещено, сервер ClickHouse преобразует LowCardinality-столбцы в обычные для SELECT запросов и преобразует обычные столбцы в LowCardinality-столбцы для INSERT запросов.

Эта настройка необходима в основном для сторонних клиентов, которые не поддерживают тип данных LowCardinality.

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

1 — Использование LowCardinality не ограничено.
0 — Использование LowCardinality ограничено.

low_cardinality_max_dictionary_size

Тип: UInt64

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

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

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

Любое положительное целое число.

low_cardinality_use_single_dictionary_for_part

Тип: Bool

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

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

По умолчанию сервер ClickHouse следит за размером словарей, и если словарь переполняется, сервер начинает записывать следующий. Чтобы запретить создание нескольких словарей, установите low_cardinality_use_single_dictionary_for_part = 1.

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

1 — Создание нескольких словарей для части данных запрещено.
0 — Создание нескольких словарей для части данных не запрещено.

low_priority_query_wait_time_ms

Beta feature. Learn more.

Тип: UInt64

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

Ограничение на количество серий, создаваемых функцией generateSeriesID.

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

max_backup_bandwidth

Тип: UInt64

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

Максимальная скорость чтения в байтах в секунду для определённой резервной копии на сервере. Ноль означает неограниченное значение.

max_block_size

Максимальный размер блоков несжатых данных перед сжатием для записи в таблицу. По умолчанию, 1 048 576 (1 МиБ). Указание меньшего размера блока обычно приводит к немного более низкому коэффициенту сжатия, скорость сжатия и распаковки немного увеличивается из-за локальности кеша, а потребление памяти сокращается.

примечание

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

Не путайте блоки для сжатия (кусок памяти, состоящий из байт) с блоками для обработки запросов (набор строк из таблицы).

max_concurrent_queries_for_all_users

Тип: UInt64

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

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

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

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

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

Положительное целое число.
0 — Нет ограничения.

Пример

См. также

max_concurrent_queries

max_concurrent_queries_for_user

Тип: UInt64

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

Максимальное количество одновременно обрабатываемых запросов на пользователя.

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

Положительное целое число.
0 — Нет ограничения.

Пример

max_distributed_connections

Тип: UInt64

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

Максимальное количество одновременных подключений к удалённым серверам для распределённой обработки одного запроса к одной распределённой таблице. Рекомендуется установить значение не меньше количества серверов в кластере.

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

max_distributed_depth

Тип: UInt64

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

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

Если значение превышено, сервер выбрасывает исключение.

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

Положительное целое число.
0 — Неограниченная глубина.

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

Положительное целое число.
0 или 1 — Отключено. SELECT запросы выполняются в одном потоке.

max_http_get_redirects

Тип: UInt64

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

Максимальное количество переходов HTTP GET-редиректов, которые разрешены. Обеспечивает дополнительные меры безопасности, чтобы предотвратить перенаправление вредоносным сервером ваших запросов на неожиданные службы.\n\nЭто происходит, когда внешний сервер перенаправляет на другой адрес, но тот адрес оказывается внутренним в инфраструктуре компании, и, отправив HTTP-запрос на внутренний сервер, вы могли бы запросить внутренний API из внутренней сети, обходя аутентификацию, или даже запросить другие службы, такие как Redis или Memcached. Если у вас нет внутренней инфраструктуры (включая что-то, что работает на вашем localhost), или вы доверяете серверу, безопасно разрешить редиректы. Хотя не стоит забывать, что если URL использует HTTP вместо HTTPS, то доверять придётся не только удалённому серверу, но также вашему ISP и каждой сети посередине.

max_hyperscan_regexp_length

Тип: UInt64

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

Определяет максимальную длину для каждого регулярного выражения в функциях многократного совпадения на гиперскане.

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

Положительное целое число.
0 — Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. также

max_hyperscan_regexp_total_length

max_hyperscan_regexp_total_length

Тип: UInt64

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

Устанавливает максимальную общую длину всех регулярных выражений в каждой функции многократного совпадения на гиперскане.

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

Положительное целое число.
0 — Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. также

max_hyperscan_regexp_length

max_insert_block_size

Тип: UInt64

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

Размер блоков (в количестве строк) для формирования при вставке в таблицу. Эта настройка применяется только в случаях, когда сервер формирует блоки. Например, при вставке через HTTP интерфейс, сервер разбирает формат данных и формирует блоки заданного размера. Но при использовании clickhouse-client, клиент сам разбирает данные, и настройка 'max_insert_block_size' на сервере не влияет на размер вставленных блоков. Настройка также не имеет цели при использовании INSERT SELECT, так как данные вставляются с использованием тех же блоков, которые формируются после SELECT.

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

max_insert_delayed_streams_for_parallel_write

Тип: UInt64

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

Максимальное количество потоков (столбцов) для задержки окончательной записи части. По умолчанию - авто (100 в случае, если поддерживается параллельная запись в основное хранилище, например S3, и отключено в противном случае).

max_insert_threads

Тип: UInt64

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

Максимальное количество потоков для выполнения запроса INSERT SELECT.

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

0 (или 1) — INSERT SELECT без параллельного выполнения.
Положительное целое число. Больше чем 1.

Значение по умолчанию в облаке: от 2 до 4, в зависимости от размера обслуживания.

Параллельный INSERT SELECT влияет только в случае, если часть SELECT выполняется параллельно, см. настройку max_threads. Более высокие значения приведут к большему использованию памяти.

Тип: UInt64

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

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

max_local_write_bandwidth

Тип: UInt64

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

Максимальная скорость локальных записей в байтах в секунду.

max_memory_usage

Тип: UInt64

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

Максимальное использование памяти для обработки одного запроса. Ноль означает неограниченно.

max_memory_usage_for_user

Тип: UInt64

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

Максимальное использование памяти для обработки всех одновременно выполняющихся запросов для пользователя. Ноль означает неограниченно.

max_network_bandwidth

Тип: UInt64

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

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

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

Положительное целое число.
0 — Контроль пропускной способности отключён.

max_network_bandwidth_for_all_users

Тип: UInt64

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

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

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

Положительное целое число.
0 — Контроль скорости данных отключён.

max_network_bandwidth_for_user

Тип: UInt64

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

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

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

Положительное целое число.
0 — Контроль скорости данных отключен.

max_network_bytes

Тип: UInt64

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

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

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

Положительное целое число.
0 — Контроль объема данных отключен.

max_number_of_partitions_for_independent_aggregation

Тип: UInt64

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

Максимальное количество разделов в таблице для применения оптимизации

max_parallel_replicas

Тип: NonZeroUInt64

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

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

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

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

Дополнительная информация

Этот параметр будет давать разные результаты в зависимости от используемых настроек.

примечание

Этот параметр будет давать некорректные результаты, когда задействованы соединения или подзапросы, и не все таблицы соответствуют определённым требованиям. Подробнее см. Распределённые подзапросы и max_parallel_replicas.

Параллельная обработка с использованием ключа `SAMPLE`

Запрос может обрабатываться быстрее, если выполняется параллельно на нескольких серверах. Однако производительность запроса может снизиться в следующих случаях:

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

Параллельная обработка с использованием parallel_replicas_custom_key

Этот параметр полезен для любой реплицированной таблицы.

max_parser_backtracks

Тип: UInt64

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

Максимальное количество бэктрэков парсера (сколько раз он пытается разные альтернативы в процессе рекурсивного нисходящего парсинга).

max_parser_depth

Тип: UInt64

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

Ограничивает максимальную глубину рекурсии в рекурсивном нисходящем парсере. Позволяет контролировать размер стека.

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

Положительное целое число.
0 — Глубина рекурсии не ограничена.

max_parsing_threads

Тип: MaxThreads

Значение по умолчанию: 'auto(14)'

Максимальное количество потоков для парсинга данных в форматах ввода, которые поддерживают параллельный парсинг. По умолчанию определяется автоматически

max_partition_size_to_drop

Тип: UInt64

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

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

Значение по умолчанию для облака: 1 ТБ.

примечание

Эта настройка запроса переписывает эквивалентную серверную настройку, см. max_partition_size_to_drop

max_partitions_per_insert_block

Тип: UInt64

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

Ограничение на максимальное количество разделов в одном вставляемом блоке. Ноль означает неограниченное количество. Генерируется исключение, если блок содержит слишком много разделов. Эта настройка является порогом безопасности, так как использование большого количества разделов является распространённым заблуждением.

max_partitions_to_read

Тип: Int64

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

Ограничение на максимальное количество разделов, к которым можно получить доступ в одном запросе. <= 0 означает неограниченное количество.

max_parts_to_move

Тип: UInt64

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

Ограничение на количество частей, которые можно переместить в одном запросе. Ноль означает неограниченное количество.

max_query_size

Тип: UInt64

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

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

Положительное целое число.
0 — Задержки реплик не проверяются.

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

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

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

0 — Отключить.
Любое положительное целое число.

max_table_size_to_drop

Тип: UInt64

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

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

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

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

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

Положительное целое число в байтах.
0 для отключения профайлера памяти.

memory_tracker_fault_probability

Тип: Float

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

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

memory_usage_overcommit_max_wait_microseconds

Тип: UInt64

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

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

merge_table_max_tables_to_look_for_schema_inference

Тип: UInt64

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

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

merge_tree_coarse_index_granularity

Тип: UInt64

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

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

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

Любое положительное чётное целое число.

merge_tree_compact_parts_min_granules_to_multibuffer_read

ClickHouse Cloud only

Тип: UInt64

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

Действует только в ClickHouse Cloud. Количество гранул в полосе компактной части таблиц MergeTree для использования многобуферного ридера, который поддерживает параллельное чтение и предзагрузку. В случае чтения из удалённой файловой системы использование многобуферного ридера увеличивает количество запросов на чтение.

merge_tree_determine_task_size_by_prewhere_columns

Тип: Bool

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

Следует ли использовать размер только столбцов предвыборки для определения размера задачи чтения.

merge_tree_max_bytes_to_use_cache

Тип: UInt64

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

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

Кэш несжатых блоков хранит данные, извлечённые для запросов. ClickHouse использует этот кэш для ускорения ответов на повторные небольшие запросы. Эта настройка защищает кэш от порчи запросами, которые читают большое количество данных. Серверная настройка uncompressed_cache_size определяет размер кэша несжатых блоков.

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

Любое положительное целое число.

merge_tree_max_rows_to_use_cache

Тип: UInt64

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

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

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

Любое положительное целое число.

merge_tree_min_bytes_for_concurrent_read

Тип: UInt64

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

Если количество байтов для чтения из одного файла таблицы с движком MergeTree превышает merge_tree_min_bytes_for_concurrent_read, ClickHouse пытается читать из этого файла параллельно в несколько потоков.

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

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

merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem

Тип: UInt64

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

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

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

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

merge_tree_min_bytes_for_seek

Тип: UInt64

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

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

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

Любое положительное целое число.

merge_tree_min_bytes_per_task_for_remote_reading

Тип: UInt64

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

Минимальное количество байтов для чтения на задачу.

merge_tree_min_read_task_size

Тип: UInt64

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

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

merge_tree_min_rows_for_concurrent_read

Тип: UInt64

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

Если количество строк для чтения из файла таблицы MergeTree превышает merge_tree_min_rows_for_concurrent_read, ClickHouse пытается выполнять параллельное чтение из этого файла в нескольких потоках.

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

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

merge_tree_min_rows_for_concurrent_read_for_remote_filesystem

Тип: UInt64

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

Минимальное количество строк для чтения из одного файла перед тем, как движок MergeTree может параллелизировать чтение, при чтении из удалённой файловой системы. Мы не рекомендуем использовать эту настройку.

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

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

merge_tree_min_rows_for_seek

Тип: UInt64

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

Если расстояние между двумя блоками данных для чтения в одном файле меньше, чем merge_tree_min_rows_for_seek строк, ClickHouse не выполняет поиск по файлу, а читает данные последовательно.

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

Любое положительное целое число.

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

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

0 — Прямое I/O отключено.
Положительное целое число.

min_bytes_to_use_mmap_io

Тип: UInt64

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

Это экспериментальная настройка. Устанавливает минимальное количество памяти для чтения больших файлов без копирования данных из ядра в пространство пользователя. Рекомендуемый порог составляет около 64 МБ, потому что mmap/munmap медленные. Это имеет смысл только для больших файлов и помогает, только если данные находятся в кэше страниц.

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

Положительное целое число.
0 — Большие файлы читаются только с копированием данных из ядра в пространство пользователя.

min_chunk_bytes_for_parallel_parsing

Тип: NonZeroUInt64

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

Тип: unsigned int
Значение по умолчанию: 1 МБ

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

min_compress_block_size

Тип: UInt64

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

Для таблиц MergeTree. Для уменьшения задержки при обработке запросов блок сжимается при записи следующей метки, если его размер составляет по меньшей мере min_compress_block_size. По умолчанию 65 536.

Фактический размер блока, если несжатые данные меньше, чем max_compress_block_size, составляет не менее этого значения и не менее объёма данных для одной метки.

Рассмотрим пример. Предположим, что index_granularity был установлен на 8192 при создании таблицы.

Мы записываем столбец типа UInt32 (4 байта на значение). При записи 8192 строк общий объём данных составит 32 КБ. Поскольку min_compress_block_size = 65 536, сжатый блок будет сформирован для каждой второй метки.

Мы записываем столбец URL с типом String (средний размер 60 байтов на значение). При записи 8192 строк средний объём будет немного меньше 500 КБ данных. Поскольку это больше, чем 65 536, сжатый блок будет сформирован для каждой метки. В этом случае при чтении данных с диска в диапазоне одной метки дополнительные данные не будут декомпрессироваться.

примечание

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

min_count_to_compile_aggregate_expression

Тип: UInt64

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

Минимальное количество одинаковых агрегатных выражений, чтобы начать JIT-компиляцию. Работает только если настройка compile_aggregate_expressions включена.

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

Положительное целое число.
0 — Одинаковые агрегатные выражения всегда JIT-компилируются.

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

Положительное целое число.
0 — Объединение отключено.

min_insert_block_size_bytes_for_materialized_views

Тип: UInt64

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

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

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

Любое положительное целое число.
0 — Объединение отключено.

См. также

min_insert_block_size_bytes

min_insert_block_size_rows

Тип: UInt64

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

Устанавливает минимальное количество строк в блоке, который может быть вставлен в таблицу с помощью запроса INSERT. Блоки меньшего размера объединяются в более крупные.

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

Положительное целое число.
0 — Объединение отключено.

min_insert_block_size_rows_for_materialized_views

Тип: UInt64

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

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

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

Любое положительное целое число.
0 — Объединение отключено.

См. также

min_insert_block_size_rows

mutations_sync

Тип: UInt64

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

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

0 - Мутации выполняются асинхронно.
1 - Запрос ждёт, пока все мутации завершатся на текущем сервере.
2 - Запрос ждёт, пока все мутации завершатся на всех репликах (если они существуют).

mysql_datatypes_support_level

Тип: MySQLDataTypesSupport

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

Определяет, как типы MySQL преобразуются в соответствующие типы ClickHouse. Список, разделённый запятыми, в любой комбинации decimal, datetime64, date2Date32 или date2String.

decimal: преобразует типы NUMERIC и DECIMAL в Decimal, если позволяет точность.
datetime64: преобразует типы DATETIME и TIMESTAMP в DateTime64, а не в DateTime, если точность не 0.
date2Date32: преобразует DATE в Date32 вместо Date. Имеет приоритет над date2String.
date2String: преобразует DATE в String вместо Date. Переопределяется datetime64.

mysql_map_fixed_string_to_text_in_show_columns

Тип: Bool

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

Когда включено, тип данных ClickHouse FixedString будет отображаться как TEXT в SHOW COLUMNS.

Имеет эффект только при подключении через протокол MySQL.

0 - Используется BLOB.
1 - Используется TEXT.

mysql_map_string_to_text_in_show_columns

Тип: Bool

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

Когда включено, тип данных ClickHouse String будет отображаться как TEXT в SHOW COLUMNS.

Имеет эффект только при подключении через протокол MySQL.

0 - Используется BLOB.
1 - Используется TEXT.

mysql_max_rows_to_insert

Тип: UInt64

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

Максимальное количество строк при пакетной вставке MySQL для движка хранения MySQL.

network_compression_method

Тип: String

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

Устанавливает метод сжатия данных, используемых при общении между серверами и между сервером и clickhouse-client.

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

LZ4 — устанавливает метод сжатия LZ4.
ZSTD — устанавливает метод сжатия ZSTD.

См. также

network_zstd_compression_level

network_zstd_compression_level

Тип: Int64

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

Регулирует уровень сжатия ZSTD. Используется только когда network_compression_method установлен на ZSTD.

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

Положительное целое число от 1 до 15.

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

0 — Строки не пропускаются.
Положительное целое число.

Пример

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

Запрос:

Результат:

opentelemetry_start_trace_probability

Тип: Float

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

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

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

0 — Трассировка для всех выполняемых запросов отключена (если не предоставлен родительский контекст трассировки).
Положительное число с плавающей точкой в диапазоне [0..1]. Например, если значение настройки равно 0,5, ClickHouse может начать трассировку в среднем для половины запросов.
1 — Трассировка для всех выполняемых запросов включена.

opentelemetry_trace_processors

Тип: Bool

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

Собирать OpenTelemetry диапазоны для процессоров.

optimize_aggregation_in_order

Тип: Bool

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

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

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

0 — Оптимизация GROUP BY отключена.
1 — Оптимизация GROUP BY включена.

См. также

GROUP BY optimization

optimize_aggregators_of_group_by_keys

Оптимизировать запросы GROUP BY sharding_key, избегая затратной агрегации на сервере инициаторе (что снизит использование памяти для запроса на сервере инициаторе).

Поддерживаются следующие типы запросов (и все их комбинации):

SELECT DISTINCT [..., ]sharding_key[, ...] FROM dist
SELECT ... FROM dist GROUP BY sharding_key[, ...]
SELECT ... FROM dist GROUP BY sharding_key[, ...] ORDER BY x
SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1
SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1 BY x

Не поддерживаются следующие типы запросов (поддержка некоторых из них может быть добавлена позже):

SELECT ... GROUP BY sharding_key[, ...] WITH TOTALS
SELECT ... GROUP BY sharding_key[, ...] WITH ROLLUP
SELECT ... GROUP BY sharding_key[, ...] WITH CUBE
SELECT ... GROUP BY sharding_key[, ...] SETTINGS extremes=1

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

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

См. также:

distributed_group_by_no_merge
distributed_push_down_limit
optimize_skip_unused_shards

примечание

На данный момент это требует optimize_skip_unused_shards (причина в том, что однажды это может быть включено по умолчанию, и это будет работать корректно только если данные были вставлены через Distributed таблицу, то есть данные распределены в соответствии с sharding_key).

optimize_extract_common_expressions

Тип: Bool

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

Позволяет извлекать общие выражения из дизъюнкций в выражениях WHERE, PREWHERE, ON, HAVING и QUALIFY. Логическое выражение типа (A AND B) OR (A AND C) может быть переписано в A AND (B OR C), что может помочь использовать:

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

optimize_functions_to_subcolumns

Тип: Bool

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

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

Эти функции могут быть преобразованы:

length для чтения подстолбца size0.
empty для чтения подстолбца size0.
notEmpty для чтения подстолбца size0.
isNull для чтения подстолбца null.
isNotNull для чтения подстолбца null.
count для чтения подстолбца null.
mapKeys для чтения подстолбца keys.
mapValues для чтения подстолбца values.

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

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

optimize_move_to_prewhere

Тип: Bool

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

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

Работает только для таблиц *MergeTree.

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

0 — Автоматическая оптимизация PREWHERE отключена.
1 — Автоматическая оптимизация PREWHERE включена.

optimize_move_to_prewhere_if_final

Тип: Bool

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

Включает или отключает автоматическую оптимизацию PREWHERE в запросах SELECT с модификатором FINAL.

Работает только для таблиц *MergeTree.

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

0 — Автоматическая оптимизация PREWHERE в запросах SELECT с модификатором FINAL отключена.
1 — Автоматическая оптимизация PREWHERE в запросах SELECT с модификатором FINAL включена.

См. также

Настройка optimize_move_to_prewhere

optimize_multiif_to_if

Тип: Bool

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

Заменить 'multiIf' с единственным условием на 'if'.

optimize_normalize_count_variants

Тип: Bool

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

Переписывает агрегатные функции, которые семантически равны count(), как count().

optimize_on_insert

Тип: Bool

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

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

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

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

Пример

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

Запрос:

Результат:

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

optimize_or_like_chain

Тип: Bool

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

Оптимизировать несколько OR LIKE в multiMatchAny. Эта оптимизация не должна быть включена по умолчанию, так как это нарушает анализ индексов в некоторых случаях.

optimize_read_in_order

Тип: Bool

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

Включает оптимизацию ORDER BY в запросах SELECT для чтения данных из таблиц MergeTree.

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

0 — Оптимизация ORDER BY отключена.
1 — Оптимизация ORDER BY включена.

См. также

ORDER BY Clause

optimize_read_in_window_order

Тип: Bool

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

Включить оптимизацию ORDER BY в оконной клаузуле для чтения данных в соответствующем порядке в таблицах MergeTree.

optimize_redundant_functions_in_order_by

Тип: Bool

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

Удалять функции из ORDER BY, если их аргумент также в ORDER BY.

optimize_respect_aliases

Тип: Bool

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

Если установлено в true, будет учитываться использование псевдонимов в WHERE/GROUP BY/ORDER BY, что поможет с отбором разделов/вторичных индексов/optimize_aggregation_in_order/optimize_read_in_order/optimize_trivial_count.

optimize_rewrite_aggregate_function_with_if

Тип: Bool

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

Переписывает агрегатные функции с выражением if в качестве аргумента, когда они логически эквивалентны. Например, avg(if(cond, col, null)) может быть переписан на avgOrNullIf(cond, col). Это может улучшить производительность.

примечание

Поддерживается только с аналитиком (enable_analyzer = 1).

optimize_rewrite_array_exists_to_has

Тип: Bool

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

Переписывает функции arrayExists() на has(), когда они логически эквивалентны. Например, arrayExists(x -> x = 1, arr) может быть переписан на has(arr, 1).

optimize_rewrite_sum_if_to_count_if

Тип: Bool

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

Переписывает функцию sumIf() и функцию sum(if()) на countIf() функцию, когда они логически эквивалентны.

optimize_skip_merged_partitions

Тип: Bool

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

Включает или отключает оптимизацию для запроса OPTIMIZE TABLE ... FINAL, если есть только одна часть с уровнем > 0 и у неё нет истёкшего времени жизни (TTL).

OPTIMIZE TABLE ... FINAL SETTINGS optimize_skip_merged_partitions=1

По умолчанию, запрос OPTIMIZE TABLE ... FINAL переписывает одну часть, даже если эта часть единственная.

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

1 - Включить оптимизацию.
0 - Отключить оптимизацию.

optimize_skip_unused_shards

Тип: Bool

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

Включает или отключает пропуск неиспользуемых шардов для запросов SELECT, которые имеют условие шардирования в WHERE/PREWHERE (предполагая, что данные распределяются по ключу шардирования, иначе запрос приведёт к неверному результату).

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

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

optimize_skip_unused_shards_limit

Тип: UInt64

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

Лимит на количество значений ключа шардирования, отключает optimize_skip_unused_shards, если достигнут лимит.

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

optimize_skip_unused_shards_nesting

Тип: UInt64

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

Контролирует optimize_skip_unused_shards (поэтому по-прежнему требует optimize_skip_unused_shards), в зависимости от уровня вложенности распределённого запроса (в случае, когда у вас есть таблица Distributed, которая смотрит в другую таблицу Distributed).

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

0 — Отключено, optimize_skip_unused_shards всегда работает.
1 — Включает optimize_skip_unused_shards только для первого уровня.
2 — Включает optimize_skip_unused_shards до второго уровня.

optimize_skip_unused_shards_rewrite_in

Тип: Bool

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

Перезаписывает IN в запросе для удалённых шардов, чтобы исключить значения, которые не принадлежат к шарду (требуется optimize_skip_unused_shards).

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

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

optimize_sorting_by_input_stream_properties

Тип: Bool

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

Оптимизирует сортировку на основе свойств входного потока.

optimize_substitute_columns

Тип: Bool

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

Использовать ограничения для замены столбцов. По умолчанию false.

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

true, false.

optimize_syntax_fuse_functions

Тип: Bool

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

Позволяет объединять агрегатные функции с идентичным аргументом. Переписывает запрос, содержащий хотя бы две агрегатные функции из sum, count или avg с идентичным аргументом, на sumCount.

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

0 — Функции с идентичным аргументом не объединяются.
1 — Функции с идентичным аргументом объединяются.

Пример

Запрос:

Результат:

optimize_throw_if_noop

Тип: Bool

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

Включает или отключает выброс исключения, если запрос OPTIMIZE не выполнил слияние.

По умолчанию OPTIMIZE успешно возвращается, даже если он ничего не сделал. Эта настройка позволяет различать эти ситуации и получить причину в сообщении об исключении.

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

1 — Выброс исключения включен.
0 — Выброс исключения отключён.

optimize_time_filter_with_preimage

Тип: Bool

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

Оптимизировать предикаты Date и DateTime, преобразуя функции в эквивалентные сравнения без преобразований (например, toYear(col) = 2023 -> col >= '2023-01-01' AND col <= '2023-12-31').

optimize_trivial_approximate_count_query

Тип: Bool

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

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

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

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

optimize_trivial_count_query

Тип: Bool

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

Включает или отключает оптимизацию тривиального запроса SELECT count() FROM table, используя метаданные из MergeTree. Если вам необходимо использовать безопасность на уровне строк, отключите эту настройку.

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

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

См. также:

optimize_functions_to_subcolumns

optimize_trivial_insert_select

Тип: Bool

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

Оптимизировать тривиальный запрос 'INSERT INTO table SELECT ... FROM TABLES'

optimize_uniq_to_count

Тип: Bool

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

Переписывает uniq и его варианты (кроме uniqUpTo) как count, если подзапрос имеет distinct или group by клаузу.

optimize_use_implicit_projections

Тип: Bool

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

Автоматически выбирать неявные проекции для выполнения запроса SELECT.

optimize_use_projections

Тип: Bool

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

Включает или отключает оптимизацию проекций при обработке запросов SELECT.

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

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

optimize_using_constraints

Тип: Bool

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

Использовать ограничения для оптимизации запросов. По умолчанию false.

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

true, false.

os_thread_priority

Тип: Int64

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

Устанавливает приоритет (nice) для потоков, которые выполняют запросы. Планировщик ОС учитывает этот приоритет при выборе следующего потока для выполнения на каждом доступном ядре CPU.

примечание

Чтобы использовать эту настройку, вам нужно установить возможность CAP_SYS_NICE. Пакет clickhouse-server настраивает это во время установки. Некоторые виртуальные среды не позволяют установить возможность CAP_SYS_NICE. В этом случае clickhouse-server показывает сообщение об этом при запуске.

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

Вы можете установить значения в диапазоне [-20, 19].

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

output_format_compression_level

Тип: UInt64

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

Уровень сжатия по умолчанию, если вывод запроса сжат. Настройка применяется, когда запрос SELECT имеет INTO OUTFILE или при записи в табличные функции file, url, hdfs, s3, или azureBlobStorage.

Возможные значения: от 1 до 22.

output_format_compression_zstd_window_log

Тип: UInt64

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

Может быть использовано, когда метод сжатия на выходе - zstd. Если больше 0, этот параметр явно устанавливает размер окна сжатия (степень 2) и включает режим длинного диапазона для сжатия zstd. Это может помочь достичь лучшего коэффициента сжатия.

Возможные значения: неотрицательные числа. Обратите внимание, что если значение слишком маленькое или слишком большое, zstdlib вызовет исключение. Типичные значения находятся в диапазоне от 20 (размер окна = 1MB) до 30 (размер окна = 1GB).

output_format_parallel_formatting

Тип: Bool

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

Включает или отключает параллельное форматирование форматов данных. Поддерживается только для форматов TSV, TSKV, CSV и JSONEachRow.

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

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

page_cache_inject_eviction

Тип: Bool

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

Кэш страниц в пространстве пользователя иногда будет случайным образом аннулировать некоторые страницы. Предназначен для тестирования.

parallel_distributed_insert_select

Тип: UInt64

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

Включает параллельный распределённый запрос INSERT ... SELECT.

Если мы выполняем INSERT INTO distributed_table_a SELECT ... FROM distributed_table_b запросы, и обе таблицы используют один и тот же кластер, и обе таблицы являются либо реплицированными, либо нереплицированными, то этот запрос обрабатывается локально на каждом шарде.

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

0 — Отключено.
1 — SELECT будет выполнен на каждом шарде из базовой таблицы движка распределения.
2 — SELECT и INSERT будут выполнены на каждом шарде из/в базовую таблицу движка распределения.

parallel_replica_offset

Beta feature. Learn more.

Тип: UInt64

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

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

parallel_replicas_allow_in_with_subquery

Beta feature. Learn more.

Тип: Bool

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

Beta feature. Learn more.

Тип: UInt64

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

Позволяет фильтру типа range равномерно распределять работу между репликами на основе пользовательского диапазона [0, parallel_replicas_custom_key_range_upper]. Значение 0 отключает верхнюю границу, устанавливая его как максимум для выражения пользовательского ключа.

При использовании совместно с parallel_replicas_custom_key_range_lower позволяет фильтру равномерно распределять работу между репликами для диапазона [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Beta feature. Learn more.

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

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

Любое положительное целое число. Рекомендуемый диапазон значений: [1000, 100000].

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

0 — Имя столбца заменяется псевдонимом.
1 — Имя столбца не заменяется псевдонимом.

Пример

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

Запрос:

Результат:

Запрос:

Результат:

prefer_external_sort_block_bytes

Тип: UInt64

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

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

prefer_global_in_and_join

Тип: Bool

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

Включает замену операторов IN/JOIN на GLOBAL IN/GLOBAL JOIN.

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

0 — Отключено. Операторы IN/JOIN не заменяются на GLOBAL IN/GLOBAL JOIN.
1 — Включено. Операторы IN/JOIN заменяются на GLOBAL IN/GLOBAL JOIN.

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

Хотя SET distributed_product_mode=global может изменить поведение запросов для распределённых таблиц, это не подходит для локальных таблиц или таблиц из внешних ресурсов. Здесь и вступает в действие параметр prefer_global_in_and_join.

Например, у нас есть узлы обслуживания запросов, которые содержат локальные таблицы, не подходящие для распределения. Нам нужно разбрасывать их данные "на лету" во время распределённой обработки с помощью ключевого слова GLOBAL — GLOBAL IN/GLOBAL JOIN.

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

См. также:

Распределённые подзапросы для получения дополнительной информации о том, как использовать GLOBAL IN/GLOBAL JOIN

prefer_localhost_replica

Тип: Bool

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

Включает/отключает предпочтительное использование реплики localhost при обработке распределённых запросов.

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

1 — ClickHouse всегда отправляет запрос на реплику localhost, если она существует.
0 — ClickHouse использует стратегию балансировки, указанную в параметре load_balancing.

примечание

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

prefer_warmed_unmerged_parts_seconds

ClickHouse Cloud only

Тип: Int64

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

Имеет эффект только в ClickHouse Cloud. Если объединённая часть стала младше, чем указано в этом параметре, и не была предварительно прогрета (см. cache_populated_by_fetch), но все её исходные части доступны и предварительно прогреты, SELECT запросы будут читать из этих частей. Только для Replicated-/SharedMergeTree. Обратите внимание, что это проверяет только, было ли обработано CacheWarmer часть; если часть была загружена в кэш чем-то другим, она будет считаться холодной, пока CacheWarmer до неё не доберётся; если она была прогрета, а затем выброшена из кэша, она всё равно будет считаться тёплой.

preferred_block_size_bytes

Тип: UInt64

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

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

preferred_max_column_in_block_size_bytes

Тип: UInt64

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

Ограничение на максимальный размер столбца в блоке при чтении. Помогает уменьшить количество промахов кэша. Должно быть близко к размерам кэша L2.

preferred_optimize_projection_name

Тип: String

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

Если установлено ненулевое значение, ClickHouse попробует применить указанную проекцию в запросе.

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

string: имя предпочтительной проекции

prefetch_buffer_size

Тип: UInt64

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

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

print_pretty_type_names

Тип: Bool

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

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

Пример:

priority

Тип: UInt64

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

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

push_external_roles_in_interserver_queries

Тип: Bool

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

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

query_cache_compress_entries

Тип: Bool

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

Сжимать записи в кэше запросов. Снижает потребление памяти кэша запросов за счёт более медленных вставок в него / чтений из него.

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

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

query_cache_max_entries

Тип: UInt64

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

Максимальное количество результатов запросов, которое текущий пользователь может хранить в кэше запросов. 0 означает неограниченное.

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

Положительное целое число >= 0.

query_cache_max_size_in_bytes

Тип: UInt64

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

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

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

Положительное целое число >= 0.

query_cache_min_query_duration

Тип: Milliseconds

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

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

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

Положительное целое число >= 0.

query_cache_min_query_runs

Тип: UInt64

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

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

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

Положительное целое число >= 0.

query_cache_nondeterministic_function_handling

Тип: QueryResultCacheNondeterministicFunctionHandling

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

Контролирует, как кэш запросов обрабатывает SELECT запросы с недетерминированными функциями, такими как rand() или now().

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

'throw' - Выбросить исключение и не кешировать результат запроса.
'save' - Кешировать результат запроса.
'ignore' - Не кешировать результат запроса и не выбрасывать исключение.

query_cache_share_between_users

Тип: Bool

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

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

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

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

query_cache_squash_partial_results

Тип: Bool

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

Сжатие блоков частичных результатов до блоков размера max_block_size. Уменьшает производительность вставок в кэш запросов, но улучшает сжимаемость записей кэша (см. query_cache_compress-entries).

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

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

query_cache_system_table_handling

Тип: QueryResultCacheSystemTableHandling

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

Контролирует, как кэш запросов обрабатывает SELECT запросы к системным таблицам, т.е. таблицам в базах данных system.* и information_schema.*.

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

'throw' - Возбросить исключение и не кешировать результат запроса.
'save' - Кешировать результат запроса.
'ignore' - Не кешировать результат запроса и не возбуждать исключение.

query_cache_tag

Тип: String

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

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

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

Любая строка

query_cache_ttl

Тип: Seconds

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

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

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

Положительное целое число >= 0.

query_metric_log_interval

Тип: Int64

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

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

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

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

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

query_plan_aggregation_in_order

Тип: Bool

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

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

примечание

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

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

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

query_plan_convert_join_to_in

Тип: Bool

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

Разрешает преобразование JOIN в подзапрос с IN, если выводимые столбцы привязаны только к левой таблице

query_plan_convert_outer_join_to_inner_join

Тип: Bool

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

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

query_plan_enable_multithreading_after_window_functions

Тип: Bool

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

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

query_plan_enable_optimizations

Тип: Bool

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

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

примечание

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

0 - Отключить все оптимизации на уровне плана запроса
1 - Включить оптимизации на уровне плана запроса (но отдельные оптимизации всё ещё могут быть отключены через их индивидуальные настройки)

query_plan_execute_functions_after_sorting

Тип: Bool

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

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

примечание

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

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

query_plan_filter_push_down

Тип: Bool

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

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

примечание

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

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

query_plan_join_shard_by_pk_ranges

Тип: Bool

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

Применять шардирование для JOIN, если ключи соединения содержат префикс первичного ключа для обеих таблиц. Поддерживается для алгоритмов hash, parallel_hash и full_sorting_merge

query_plan_join_swap_table

Тип: BoolAuto

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

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

'auto': Позволяет планировщику решать, какую таблицу использовать в качестве таблицы построения.
'false': Никогда не менять таблицы (правая таблица является таблицей построения).
'true': Всегда менять таблицы (левая таблица является таблицей построения).

query_plan_lift_up_array_join

Тип: Bool

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

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

примечание

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

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

query_plan_lift_up_union

Тип: Bool

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

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

примечание

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

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

query_plan_max_limit_for_lazy_materialization

Тип: UInt64

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

Контролировать максимальное значение лимита, которое позволяет использовать план запроса для оптимизации ленивой материализации. Если ноль, то нет лимита

query_plan_max_optimizations_to_apply

Тип: UInt64

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

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

примечание

query_plan_merge_expressions

Тип: Bool

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

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

примечание

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

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

query_plan_merge_filters

Тип: Bool

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

Разрешает объединение фильтров в плане запроса

query_plan_optimize_lazy_materialization

Тип: Bool

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

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

query_plan_optimize_prewhere

Тип: Bool

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

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

query_plan_push_down_limit

Тип: Bool

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

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

примечание

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

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

query_plan_read_in_order

Тип: Bool

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

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

примечание

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

0 - Отключить
1 - Включить

query_plan_remove_redundant_distinct

Тип: Bool

Значение по умолчанию: 1

Включает оптимизацию на уровне плана запроса, которая удаляет избыточные шаги DISTINCT. Вступает в силу только если настройка query_plan_enable_optimizations равна 1.

примечание

Это настройка экспертного уровня, которая должна использоваться только для отладки разработчиками. Настройка может измениться в будущем несовместимым образом или быть удалена.

Возможные значения:

0 - Отключить
1 - Включить

query_plan_remove_redundant_sorting

Тип: Bool

Значение по умолчанию: 1

Включает оптимизацию на уровне плана запроса, которая удаляет избыточные шаги сортировки, например, в подзапросах. Вступает в силу только если настройка query_plan_enable_optimizations равна 1.

примечание

Возможные значения:

0 - Отключить
1 - Включить

query_plan_reuse_storage_ordering_for_window_functions

Тип: Bool

Значение по умолчанию: 1

Включает оптимизацию на уровне плана запроса, которая использует сортировку хранилища при сортировке для оконных функций. Вступает в силу только если настройка query_plan_enable_optimizations равна 1.

примечание

Возможные значения:

0 - Отключить
1 - Включить

query_plan_split_filter

Тип: Bool

Значение по умолчанию: 1

примечание

Включает оптимизацию на уровне плана запроса, которая разделяет фильтры на выражения. Вступает в силу только если настройка query_plan_enable_optimizations равна 1.

Возможные значения:

0 - Отключить
1 - Включить

query_plan_try_use_vector_search

Тип: Bool

Значение по умолчанию: 1

Включает оптимизацию на уровне плана запроса, которая пытается использовать векторный индекс подобия. Вступает в силу только если настройка query_plan_enable_optimizations равна 1.

примечание

Возможные значения:

0 - Отключить
1 - Включить

query_plan_use_new_logical_join_step

Тип: Bool

Значение по умолчанию: 1

Использовать новый шаг логического соединения в плане запроса

query_profiler_cpu_time_period_ns

Тип: UInt64

Значение по умолчанию: 1000000000

Устанавливает период для таймера процессорного времени в профилировщике запросов. Этот таймер учитывает только время процессора.

Возможные значения:

Положительное целое число в наносекундах.

Рекомендуемые значения:
- 10000000 (100 раз в секунду) наносекунд и более для одиночных запросов.
- 1000000000 (один раз в секунду) для кластерного профилирования.
0 для отключения таймера.

Временно отключено в ClickHouse Cloud.

См. также:

Системная таблица trace_log

query_profiler_real_time_period_ns

Тип: UInt64

Значение по умолчанию: 1000000000

Устанавливает период для реального таймера времени в профилировщике запросов. Реальный таймер времени учитывает время "стены".

Возможные значения:

Положительное целое число, в наносекундах.

Рекомендуемые значения:
- 10000000 (100 раз в секунду) наносекунд и меньше для одиночных запросов.
- 1000000000 (один раз в секунду) для кластерного профилирования.
0 для отключения таймера.

Временно отключено в ClickHouse Cloud.

См. также:

Системная таблица trace_log

read_through_distributed_cache

ClickHouse Cloud only

Тип: Bool

Значение по умолчанию: 0

Имеет эффект только в ClickHouse Cloud. Позволяет чтение из распределённого кэша.

readonly

Тип: UInt64

Значение по умолчанию: 0

0 - отсутствуют ограничения только для чтения. 1 - только запросы чтения, а также изменение явно разрешённых настроек. 2 - только запросы чтения, а также изменение настроек, за исключением настройки 'readonly'.

receive_data_timeout_ms

Тип: Milliseconds

Значение по умолчанию: 2000

Время ожидания подключения для получения первого пакета данных или пакета с положительным прогрессом от реплики.

receive_timeout

Тип: Seconds

Значение по умолчанию: 300

Время ожидания получения данных из сети, в секундах. Если в этом интервале не было получено никаких байт, возникает исключение. Если вы устанавливаете эту настройку на клиенте, 'send_timeout' для сокета также будет установлен на соответствующем соединении на сервере.

regexp_max_matches_per_row

Тип: UInt64

Значение по умолчанию: 1000

Устанавливает максимальное количество совпадений для одного регулярного выражения на строку. Используется для защиты от перегрузки памяти при использовании жадного регулярного выражения в функции extractAllGroupsHorizontal.

Возможные значения:

Положительное целое число.

reject_expensive_hyperscan_regexps

Тип: Bool

Значение по умолчанию: 1

Отклонять шаблоны, которые, вероятно, будут дорогостоящими для выполнения с помощью hyperscan (из-за взрыва состояния NFA).

remerge_sort_lowered_memory_bytes_ratio

Тип: Float

Значение по умолчанию: 2

Если использование памяти после повторного слияния не уменьшилось в этом соотношении, повторное слияние будет отключено.

remote_filesystem_read_method

Тип: String

Значение по умолчанию: threadpool

Метод чтения данных из удаленной файловой системы, один из: read, threadpool.

remote_filesystem_read_prefetch

Тип: Bool

Значение по умолчанию: 1

Следует ли использовать предвыборку при чтении данных из удаленной файловой системы.

remote_fs_read_backoff_max_tries

Тип: UInt64

Значение по умолчанию: 5

Максимальное количество попыток чтения с отступом.

remote_fs_read_max_backoff_ms

Тип: UInt64

Значение по умолчанию: 10000

Максимальное время ожидания при попытке чтения данных для удалённого диска.

remote_read_min_bytes_for_seek

Тип: UInt64

Значение по умолчанию: 4194304

Минимальное количество байт для удалённого чтения (url, s3) для выполнения поиска, вместо чтения с игнорированием.

rename_files_after_processing

Тип: String

Значение по умолчанию:

Тип: 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.

replace_running_query

Тип: Bool

Значение по умолчанию: 0

При использовании HTTP интерфейса может быть передан параметр 'query_id'. Это любая строка, служащая идентификатором запроса. Если в данный момент уже существует запрос от того же пользователя с тем же 'query_id', поведение зависит от параметра 'replace_running_query'.

0 (по умолчанию) – Возбуждайте исключение (не позволяйте запускать запрос, если запрос с тем же 'query_id' уже выполняется).

1 – Отменить старый запрос и начать выполнение нового.

Установите этот параметр в 1 для реализации предложений для условий сегментации. После ввода следующего символа, если старый запрос еще не завершён, он должен быть отменен.

replace_running_query_max_wait_ms

Тип: Milliseconds

Значение по умолчанию: 5000

Время ожидания завершения выполнения запроса с тем же query_id, когда активна настройка replace_running_query.

Возможные значения:

Положительное целое число.
0 — Вызывает исключение, которое не позволяет выполнить новый запрос, если сервер уже выполняет запрос с тем же query_id.

replication_wait_for_inactive_replica_timeout

Тип: Int64

Значение по умолчанию: 120

Определяет, как долго (в секундах) ждать выполнения неактивными репликами запросов ALTER, OPTIMIZE или TRUNCATE.

Возможные значения:

0 — Не ждать.
Отрицательное число — Ждать неограниченное время.
Положительное число — Количество секунд ожидания.

Возможные значения:

true — Разрешить.
false — Запретить.

s3_allow_multipart_copy

Тип: Bool

Значение по умолчанию: 1

Разрешить многочастичное копирование в S3.

s3_allow_parallel_part_upload

Тип: Bool

Значение по умолчанию: 0

Игнорировать отсутствие файла, если он не существует при чтении определённых ключей.

Возможные значения:

1 — SELECT возвращает пустой результат.
0 — SELECT вызывает исключение.

Возможные значения:

0 — SELECT вызывает исключение, если пустой файл не совместим с запрашиваемым форматом.
1 — SELECT возвращает пустой результат для пустого файла.

s3_strict_upload_part_size

Тип: UInt64

Значение по умолчанию: 0

Точный размер части для загрузки при многочастичной загрузке в S3 (некоторые реализации не поддерживают изменение размеров частей).

s3_throw_on_zero_files_match

Тип: Bool

Значение по умолчанию: 0

Вызвать ошибку, когда запрос ListObjects не может сопоставить ни одного файла.

s3_truncate_on_insert

Тип: Bool

Значение по умолчанию: 0

Включает или отключает усечение перед вставками в таблицы движка s3. Если отключено, то при вставке будет выброшено исключение, если объект S3 уже существует.

Возможные значения:

0 — INSERT создает новый файл или завершить неудачей, если файл существует и s3_create_new_file_on_insert не установлен.
1 — INSERT заменяет существующее содержимое файла новыми данными.

Подробнее см. здесь.

s3_upload_part_size_multiply_factor

Тип: UInt64

Значение по умолчанию: 2

Умножает s3_min_upload_part_size на этот коэффициент каждый раз, когда s3_multiply_parts_count_threshold части были загружены из одной записи в S3.

s3_upload_part_size_multiply_parts_count_threshold

Тип: UInt64

Значение по умолчанию: 500

Каждый раз, когда это количество частей было загружено в S3, s3_min_upload_part_size умножается на s3_upload_part_size_multiply_factor.

s3_use_adaptive_timeouts

Тип: Bool

Значение по умолчанию: 1

Когда установлено значение true, для всех запросов s3 первые две попытки выполняются с низкими тайм-аутами отправки и получения. Когда установлено значение false, все попытки выполняются с одинаковыми тайм-аутами.

s3_validate_request_settings

Тип: Bool

Значение по умолчанию: 1

Включает проверку настроек запроса s3.

Возможные значения:

1 — проверка настроек.
0 — не проверять настройки.

Эта настройка отличается поведением между SharedMergeTree и ReplicatedMergeTree, подробнее смотрите Консистенция SharedMergeTree для информации о поведении select_sequential_consistency в SharedMergeTree.

Включает или выключает последовательную консистенцию для запросов 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

send_logs_level

Тип: LogsLevel

Значение по умолчанию: fatal

Отправлять текстовые логи сервера с указанным минимальным уровнем клиенту. Допустимые значения: 'trace', 'debug', 'information', 'warning', 'error', 'fatal', 'none'.

send_logs_source_regexp

Тип: String

Значение по умолчанию:

Отправлять текстовые логи сервера с указанной регуляркой для соответствия имени источника лога. Пустое означает все источники.

send_progress_in_http_headers

Тип: Bool

Значение по умолчанию: 0

Включает или отключает заголовки HTTP ответа X-ClickHouse-Progress в ответах clickhouse-server.

Для получения дополнительной информации прочтите описание HTTP интерфейса.

Возможные значения:

0 — Отключено.
1 — Включено.

send_timeout

Тип: Seconds

Значение по умолчанию: 300

Тайм-аут для отправки данных в сеть, в секундах. Если клиент должен отправить какие-либо данные, но не может отправить ни одного байта в этом интервале, возникает исключение. Если вы устанавливаете эту настройку на клиенте, 'receive_timeout' для сокета также будет установлен на соответствующем соединении на сервере.

session_timezone

Beta feature. Learn more.

Тип: Timezone

Значение по умолчанию:

Устанавливает неявный часовой пояс текущей сессии или запроса. Неявный часовой пояс — это часовой пояс, применяемый к значениям типа DateTime/DateTime64, которые не имеют явно указанного часового пояса. Настройка имеет приоритет над глобально настроенным (на уровне сервера) неявным часовым поясом. Значение '' (пустая строка) означает, что неявный часовой пояс текущей сессии или запроса равен часовому поясу сервера.

Вы можете использовать функции timeZone() и serverTimeZone(), чтобы получить часовой пояс сессии и часовой пояс сервера.

Возможные значения:

Любое имя часового пояса из system.time_zones, например, Europe/Berlin, UTC или Zulu.

Примеры:

Назначьте часовой пояс сессии 'America/Denver' внутреннему DateTime без явно указанного часового пояса:

осторожно

Не все функции, которые разбирают DateTime/DateTime64, уважают session_timezone. Это может привести к тонким ошибкам.

Смотрите следующий пример и объяснение.

Это происходит из-за различных способов разбора:

toDateTime() без явно указанного часового пояса, используемого в первом запросе SELECT, уважает настройку session_timezone и глобальный часовой пояс.
Во втором запросе DateTime анализируется из строки и наследует тип и часовой пояс от существующего столбца d. Таким образом, настройка session_timezone и глобальный часовой пояс не уважаются.

См. также

timezone

set_overflow_mode

Тип: OverflowMode

Значение по умолчанию: throw

Что делать, когда лимит превышен.

shared_merge_tree_sync_parts_on_partition_operations

Тип: Bool

Значение по умолчанию: 1

Автоматически синхронизировать набор частей данных после MOVE|REPLACE|ATTACH операций с разделами в таблицах SMT. Только для облака.

short_circuit_function_evaluation

Тип: ShortCircuitFunctionEvaluation

Значение по умолчанию: enable

Позволяет вычислять функции if, multiIf, and и or с использованием короткой схемы. Это помогает оптимизировать выполнение сложных выражений в этих функциях и предотвращать возможные исключения (например, деление на ноль, когда это не ожидается).

Возможные значения:

enable — Включает кратковременные вычисления для функций, подходящих для этого (могут вызвать исключение или быть вычислительно затратными).
force_enable — Включает кратковременные вычисления для всех функций.
disable — Отключает кратковременные вычисления функций.

short_circuit_function_evaluation_for_nulls

Тип: Bool

Значение по умолчанию: 1

Оптимизирует оценку функций, которые возвращают NULL, когда любой аргумент равен NULL. Когда процент значений NULL в аргументах функции превышает short_circuit_function_evaluation_for_nulls_threshold, система пропускает оценку функции построчно. Вместо этого она мгновенно возвращает NULL для всех строк, избегая ненужных вычислений.

short_circuit_function_evaluation_for_nulls_threshold

Тип: Double

Значение по умолчанию: 1

Пороговое значение соотношения NULL значений для выполнения функций с Nullable аргументами только на строках с не-NULL значениями во всех аргументах. Применяется, когда параметр short_circuit_function_evaluation_for_nulls включен. Когда соотношение строк, содержащих NULL значения, к общему количеству строк превышает этот порог, эти строки с NULL значениями не будут оцениваться.

show_table_uuid_in_table_create_query_if_not_nil

Тип: Bool

Значение по умолчанию: 0

Устанавливает отображение запроса SHOW TABLE.

Возможные значения:

0 — Запрос будет отображаться без UUID таблицы.
1 — Запрос будет отображаться с UUID таблицы.

single_join_prefer_left_table

Тип: Bool

Значение по умолчанию: 1

Для одиночного JOIN в случае неоднозначности идентификатора предпочитать левую таблицу.

skip_redundant_aliases_in_udf

Тип: Bool

Значение по умолчанию: 0

Избыточные алиасы не используются (не подставляются) в пользовательских функциях для упрощения их использования.

Возможные значения:

1 — Алиасы не учитываются (подставляются) в UDF.
0 — Алиасы учитываются (не подставляются) в UDF.

Пример

Разница между включенным и выключенным:

Запрос:

Результат:

Запрос:

Результат:

skip_unavailable_shards

Тип: Bool

Значение по умолчанию: 0

Включает или отключает тихое пропускание недоступных шардов.

Шард считается недоступным, если все его реплики недоступны. Реплика недоступна в следующих случаях:

ClickHouse не может подключиться к реплике по любой причине.

При подключении к реплике ClickHouse выполняет несколько попыток. Если все эти попытки неудачны, реплика считается недоступной.
Реплика не может быть разрешена через DNS.

Если имя хоста реплики не может быть разрешено через DNS, это может указывать на следующие ситуации:
- У хоста реплики нет DNS-записи. Это может происходить в системах с динамическим DNS, например, в Kubernetes, где узлы могут быть неразрешимыми во время простоя, и это не является ошибкой.
- Ошибка конфигурации. Файл конфигурации ClickHouse содержит неправильное имя хоста.

Возможные значения:

1 — пропуск включен.

Если шард недоступен, ClickHouse возвращает результат на основе частичных данных и не сообщает о проблемах доступности узлов.
0 — пропуск отключен.

Если шард недоступен, ClickHouse выбрасывает исключение.

splitby_max_substrings_includes_remaining_string

Тип: Bool

Значение по умолчанию: 0

Контролирует, будет ли функция splitBy*() с аргументом max_substrings > 0 включать оставшуюся строку в последний элемент массива результата.

Возможные значения:

0 - Оставшаяся строка не будет включена в последний элемент массива результата.
1 - Оставшаяся строка будет включена в последний элемент массива результата. Это поведение функции split() в Spark и метода 'string.split()' в Python.

stop_refreshable_materialized_views_on_startup

Experimental feature. Learn more.

Тип: Bool

Значение по умолчанию: 0

При запуске сервера предотвращает планирование обновляемых материализованных представлений, как если бы с использованием SYSTEM STOP VIEWS. Вы можете вручную запустить их с помощью SYSTEM START VIEWS или SYSTEM START VIEW <name>. Также применяется к вновь созданным представлениям. Не влияет на необновляемые материализованные представления.

storage_file_read_method

Тип: LocalFSReadMethod

Значение по умолчанию: pread

Метод чтения данных из файла хранилища, один из следующих: read, pread, mmap. Метод mmap не применяется к clickhouse-server (он предназначен для clickhouse-local).

storage_system_stack_trace_pipe_read_timeout_ms

Тип: Миллисекунды

Значение по умолчанию: 100

Максимальное время для чтения из канала для получения информации из потоков при запросе таблицы system.stack_trace. Этот параметр используется для тестирования и не предназначен для изменения пользователями.

stream_flush_interval_ms

Тип: Миллисекунды

Значение по умолчанию: 7500

Работает для таблиц с потоковой передачей в случае тайм-аута или когда поток генерирует max_insert_block_size строк.

Значение по умолчанию 7500.

Чем меньше значение, тем чаще данные выгружаются в таблицу. Установка значения слишком низкого ведет к низкой производительности.

stream_like_engine_allow_direct_select

Тип: Bool

Значение по умолчанию: 0

Разрешить прямой запрос SELECT для движков Kafka, RabbitMQ, FileLog, Redis Streams и NATS. В случае, если есть прикрепленные материализованные представления, запрос SELECT не разрешен, даже если этот параметр включен.

stream_like_engine_insert_queue

Тип: String

Значение по умолчанию:

Когда движок, похожий на стриминговый, читает из нескольких очередей, пользователю нужно выбрать одну очередь для вставки при записи. Используется для Redis Streams и NATS.

stream_poll_timeout_ms

Тип: Миллисекунды

Значение по умолчанию: 500

Тайм-аут для опроса данных из/в стриминговых хранилищах.

system_events_show_zero_values

Тип: Bool

Значение по умолчанию: 0

Позволяет выбирать события со значением ноль из таблицы system.events.

Некоторые системы мониторинга требуют передачи всех значений метрик для них при каждой контрольной точке, даже если значение метрики равно нулю.

Возможные значения:

0 — Отключено.
1 — Включено.

Примеры

Запрос

Результат

Запрос

Результат

table_function_remote_max_addresses

Тип: UInt64

Значение по умолчанию: 1000

Устанавливает максимальное количество адресов, сгенерированных из шаблонов для функции remote.

Возможные значения:

Положительное целое число.

tcp_keep_alive_timeout

Тип: Секунды

Значение по умолчанию: 290

Время в секундах, которое соединение должно оставаться в простое, прежде чем TCP начнет отправлять keepalive-пробы.

temporary_data_in_cache_reserve_space_wait_lock_timeout_milliseconds

Тип: UInt64

Значение по умолчанию: 600000

Время ожидания блокировки кэша для резервирования места для временных данных в файловом кэше.

temporary_files_codec

Тип: String

Значение по умолчанию: LZ4

Устанавливает кодек сжатия для временных файлов, используемых при сортировке и операциях соединения на диске.

Возможные значения:

LZ4 — Применяется сжатие LZ4.
NONE — Сжатие не применяется.

throw_if_deduplication_in_dependent_materialized_views_enabled_with_async_insert

Тип: Bool

Значение по умолчанию: 1

Выбрасывать исключение при запросе INSERT, если параметр deduplicate_blocks_in_dependent_materialized_views включен вместе с async_insert. Это гарантирует корректность, поскольку эти функции не могут работать вместе.

throw_if_no_data_to_insert

Тип: Bool

Значение по умолчанию: 1

Разрешает или запрещает пустые INSERT, включено по умолчанию (вызывает ошибку при пустой вставке). Применяется только к INSERT с использованием clickhouse-client или с использованием gRPC интерфейса.

throw_on_error_from_cache_on_write_operations

Тип: Bool

Значение по умолчанию: 0

Игнорировать ошибку из кэша при кэшировании операций записи (INSERT, слияния).

throw_on_max_partitions_per_insert_block

Тип: Bool

Значение по умолчанию: 1

Используется с max_partitions_per_insert_block. Если true (по умолчанию), будет выброшено исключение, когда max_partitions_per_insert_block достигнуто. Если false, детали запроса вставки, достигнувшего этого лимита с количеством разделов, будут зарегистрированы. Это может быть полезно, если вы пытаетесь понять воздействие на пользователей при изменении max_partitions_per_insert_block.

throw_on_unsupported_query_inside_transaction

Experimental feature. Learn more.

Тип: Bool

Значение по умолчанию: 1

Выбрасывать исключение, если используется неподдерживаемый запрос внутри транзакции.

timeout_before_checking_execution_speed

Тип: Секунды

Значение по умолчанию: 10

Проверка, что скорость выполнения не слишком низкая после указанного времени.

timeout_overflow_mode

Тип: OverflowMode

Значение по умолчанию: throw

Что делать, когда превышен лимит времени.

timeout_overflow_mode_leaf

Тип: OverflowMode

Значение по умолчанию: throw

Что делать, когда превышен листовой лимит.

totals_auto_threshold

Тип: Float

Значение по умолчанию: 0.5

Порог для totals_mode = 'auto'. См. раздел "WITH TOTALS модификатор".

totals_mode

Тип: TotalsMode

Значение по умолчанию: after_having_exclusive

Как вычислять TOTALS, когда присутствует HAVING, а также когда заданы max_rows_to_group_by и group_by_overflow_mode = 'any'. См. раздел "WITH TOTALS модификатор".

trace_profile_events

Тип: Bool

Значение по умолчанию: 0

Включает или отключает сбор stacktraces при каждом обновлении событий профиля вместе с именем события профиля и значением инкремента и отправку их в trace_log.

Возможные значения:

1 — Трассировка событий профиля включена.
0 — Трассировка событий профиля отключена.

transfer_overflow_mode

Тип: OverflowMode

Значение по умолчанию: throw

Что делать, когда превышен лимит передачи.

transform_null_in

Тип: Bool

Значение по умолчанию: 0

Включает равенство NULL значений для оператора IN.

По умолчанию, NULL значения не могут сравниваться, так как NULL означает неопределенное значение. Таким образом, сравнение expr = NULL всегда должно возвращать false. С этой настройкой NULL = NULL возвращает true для оператора IN.

Возможные значения:

0 — Сравнение NULL значений в операторе IN возвращает false.
1 — Сравнение NULL значений в операторе IN возвращает true.

Пример

Рассмотрим таблицу null_in:

Запрос:

Результат:

Запрос:

Результат:

См. также

Обработка NULL в операторах IN

traverse_shadow_remote_data_paths

Тип: Bool

Значение по умолчанию: 0

Пересекать замороженные данные (каталог shadow) в дополнение к фактическим данным таблицы при запросе system.remote_data_paths

union_default_mode

Тип: SetOperationMode

Значение по умолчанию:

Устанавливает режим объединения результатов SELECT запроса. Настройка используется только при объединении с UNION без явного указания UNION ALL или UNION DISTINCT.

Возможные значения:

'DISTINCT' — ClickHouse выводит строки в результате объединения запросов, удаляя дубликаты строк.
'ALL' — ClickHouse выводит все строки в результате объединения запросов, включая дубликаты строк.
'' — ClickHouse вызывает исключение при использовании с UNION.

См. примеры в UNION.

unknown_packet_in_send_data

Тип: UInt64

Значение по умолчанию: 0

Отправляет неизвестный пакет вместо N-го пакета данных

use_async_executor_for_materialized_views

Тип: Bool

Значение по умолчанию: 0

Использовать асинхронное и потенциально многопоточное выполнение запроса для материализованного представления, может ускорить обработку представлений во время INSERT, но также потребляет больше памяти.

use_cache_for_count_from_files

Тип: Bool

Значение по умолчанию: 1

Включает кэширование количества строк при подсчете из файлов в табличных функциях file/s3/url/hdfs/azureBlobStorage.

Включено по умолчанию.

use_client_time_zone

Тип: Bool

Значение по умолчанию: 0

Использовать временную зону клиента для интерпретации значений строк DateTime вместо принятия временной зоны сервера.

use_compact_format_in_distributed_parts_names

Тип: Bool

Значение по умолчанию: 1

Использует компактный формат для хранения блоков для фоновой (distributed_foreground_insert) INSERT в таблицах с движком Distributed.

Возможные значения:

0 — Используется формат user[:password]@host:port#default_database для каталогов.
1 — Используется формат [shard{shard_index}[_replica{replica_index}]] для каталогов.

примечание

при use_compact_format_in_distributed_parts_names=0 изменения из определения кластера не будут применяться для фонового INSERT.
при use_compact_format_in_distributed_parts_names=1 изменение порядка узлов в определении кластера изменит shard_index/replica_index, так что будьте внимательны.

use_concurrency_control

Тип: Bool

Значение по умолчанию: 1

Соблюдать ограничение параллелизма сервера (смотрите глобальные настройки сервера concurrent_threads_soft_limit_num и concurrent_threads_soft_limit_ratio_to_cores). Если отключено, позволяет использовать большее количество потоков, даже если сервер перегружен (не рекомендуется для обычного использования и в основном необходимо для тестов).

use_hedged_requests

Тип: Bool

Значение по умолчанию: 1

Тип: Bool

Значение по умолчанию: 0

Если включено, SELECT запросы могут использовать кэш запросов. Параметры enable_reads_from_query_cache и enable_writes_to_query_cache более подробно контролируют, как используется кэш.

Возможные значения:

0 - Отключено
1 - Включено

use_query_condition_cache

Тип: Bool

Значение по умолчанию: 0

Включить кэш запросов условий. Кэш хранит диапазоны гранул в частях данных, которые не удовлетворяют условию в предложении WHERE, и повторно использовать эту информацию как эфемерный индекс для последующих запросов.

Возможные значения:

0 - Отключено
1 - Включено

use_skip_indexes

Тип: Bool

Значение по умолчанию: 1

Использовать индексы пропуска данных во время выполнения запроса.

Возможные значения:

0 — Отключено.
1 — Включено.

use_skip_indexes_if_final

Тип: Bool

Значение по умолчанию: 0

Контролирует, используются ли индексы пропуска при выполнении запроса с FINAL модификатором.

По умолчанию эта настройка отключена, поскольку индексы пропуска могут исключать строки (гранулы), содержащие последние данные, что может привести к некорректным результатам. Когда включено, индексы пропуска применяются даже с FINAL модификатором, потенциально повышая производительность, но с риском пропуска последних обновлений.

Возможные значения:

0 — Отключено.
1 — Включено.

use_structure_from_insertion_table_in_table_functions

Тип: UInt64

Значение по умолчанию: 2

Использовать структуру из таблицы вставки вместо вывода схемы из данных. Возможные значения: 0 - отключено, 1 - включено, 2 - авто

use_uncompressed_cache

Тип: Bool

Значение по умолчанию: 0

Использовать ли кэш не сжатых блоков. Принимает 0 или 1. По умолчанию, 0 (отключено). Использование кэша не сжатых данных (только для таблиц семейства MergeTree) может значительно снизить задержку и увеличить пропускную способность при работе с большим количеством коротких запросов. Включите этот параметр для пользователей, которые отправляют частые короткие запросы. Также обратите внимание на параметр конфигурации uncompressed_cache_size (устанавливается только в конфигурационном файле) – размер кэша не сжатых блоков. По умолчанию 8 ГиБ. Кэш не сжатых данных заполняется по мере необходимости, и наименее используемые данные автоматически удаляются.

Для запросов, которые читают хотя бы несколько больших объемов данных (миллион строк или более), кэш не сжатых данных автоматически отключается, чтобы сэкономить место для действительно маленьких запросов. Это означает, что вы можете всегда оставлять настройку 'use_uncompressed_cache' в значении 1.

use_variant_as_common_type

Тип: Bool

Значение по умолчанию: 0

Позволяет использовать тип Variant как результирующий тип для функций if/multiIf/array/map, когда нет общего типа для типов аргументов.

Пример:

use_with_fill_by_sorting_prefix

Тип: Bool

Значение по умолчанию: 1

Столбцы, предшествующие столбцам WITH FILL в предложении ORDER BY, формируют префикс сортировки. Строки с разными значениями в префиксе сортировки заполняются независимо.

validate_enum_literals_in_operators

Тип: Bool

Значение по умолчанию: 0

Если включено, проверяет литералы перечисления в операторах, таких как IN, NOT IN, ==, !=, на соответствие типу перечисления и выбрасывает исключение, если литерал не является допустимым значением перечисления.

validate_mutation_query

Тип: Bool

Значение по умолчанию: 1

Проверять запросы мутаций перед их принятием. Мутации выполняются в фоне, и выполнение неверного запроса приведет к застреванию мутаций, требующих ручного вмешательства.

Изменяйте эту настройку только, если вы встречаете ошибку, несовместимую с предыдущими версиями.

validate_polygons

Тип: Bool

Значение по умолчанию: 1

Включает или отключает выброс исключения в функции pointInPolygon, если полигон самопересекающийся или самокасательный.

Возможные значения:

0 — Выброс исключения отключен. pointInPolygon принимает недопустимые полигоны и возвращает возможно некорректные результаты для них.
1 — Выброс исключения включен.

wait_changes_become_visible_after_commit_mode

Experimental feature. Learn more.

Тип: TransactionsWaitCSNMode

Значение по умолчанию: wait_unknown

Ожидать, когда зафиксированные изменения станут фактически видимыми в последней моментальной копии.

wait_for_async_insert

Тип: Bool

Значение по умолчанию: 1

Если включено, ожидайте обработки асинхронной вставки.

Тип: String

Значение по умолчанию: default

Имя рабочей нагрузки, которая будет использоваться для доступа к ресурсам.

write_through_distributed_cache

ClickHouse Cloud only

Тип: Bool

Значение по умолчанию: 0

Влияет только на ClickHouse Cloud. Разрешить запись в распределенный кэш (запись в s3 также будет выполняться через распределенный кэш).

zstd_window_log_max

Тип: Int64

Значение по умолчанию: 0

Позволяет выбрать максимальный журнал окна ZSTD (он не будет использоваться для MergeTree семейства).

add_http_cors_header
additional_result_filter
additional_table_filters
aggregate_functions_null_for_empty
aggregation_in_order_max_block_bytes
aggregation_memory_efficient_merge_threads
allow_aggregate_partitions_independently
allow_archive_path_syntax
allow_asynchronous_read_from_io_pool_for_merge_tree
allow_changing_replica_until_first_data_packet
allow_create_index_without_type
allow_custom_error_code_in_throwif
allow_ddl
allow_deprecated_database_ordinary
allow_deprecated_error_prone_window_functions
allow_deprecated_snowflake_conversion_functions
allow_deprecated_syntax_for_merge_tree
allow_distributed_ddl
allow_drop_detached
allow_execute_multiif_columnar
allow_experimental_analyzer
allow_experimental_codecs
allow_experimental_database_glue_catalog
allow_experimental_database_iceberg
allow_experimental_database_materialized_postgresql
allow_experimental_database_unity_catalog
allow_experimental_dynamic_type
allow_experimental_full_text_index
allow_experimental_funnel_functions
allow_experimental_hash_functions
allow_experimental_inverted_index
allow_experimental_join_condition
allow_experimental_join_right_table_sorting
allow_experimental_json_type
allow_experimental_kafka_offsets_storage_in_keeper
allow_experimental_kusto_dialect
allow_experimental_live_view
allow_experimental_materialized_postgresql_table
allow_experimental_nlp_functions
allow_experimental_object_type
allow_experimental_parallel_reading_from_replicas
allow_experimental_prql_dialect
allow_experimental_query_deduplication
allow_experimental_shared_set_join
allow_experimental_statistics
allow_experimental_time_series_table
allow_experimental_ts_to_grid_aggregate_function
allow_experimental_variant_type
allow_experimental_vector_similarity_index
allow_experimental_window_view
allow_general_join_planning
allow_get_client_http_header
allow_hyperscan
allow_introspection_functions
allow_materialized_view_with_bad_select
allow_named_collection_override_by_default
allow_non_metadata_alters
allow_nonconst_timezone_arguments
allow_nondeterministic_mutations
allow_nondeterministic_optimize_skip_unused_shards
allow_not_comparable_types_in_comparison_functions
allow_not_comparable_types_in_order_by
allow_prefetched_read_pool_for_local_filesystem
allow_prefetched_read_pool_for_remote_filesystem
allow_push_predicate_ast_for_distributed_subqueries
allow_push_predicate_when_subquery_contains_with
allow_reorder_prewhere_conditions
allow_settings_after_format_in_insert
allow_simdjson
allow_statistics_optimize
allow_suspicious_codecs
allow_suspicious_fixed_string_types
allow_suspicious_indices
allow_suspicious_low_cardinality_types
allow_suspicious_primary_key
allow_suspicious_ttl_expressions
allow_suspicious_types_in_group_by
allow_suspicious_types_in_order_by
allow_suspicious_variant_types
allow_unrestricted_reads_from_keeper
alter_move_to_space_execute_async
alter_partition_verbose_result
alter_sync
analyze_index_with_space_filling_curves
analyzer_compatibility_join_using_top_level_identifier
any_join_distinct_right_table_keys
apply_deleted_mask
apply_mutations_on_fly
apply_settings_from_server
asterisk_include_alias_columns
asterisk_include_materialized_columns
async_insert
async_insert_busy_timeout_decrease_rate
async_insert_busy_timeout_increase_rate
async_insert_busy_timeout_max_ms
async_insert_busy_timeout_min_ms
async_insert_deduplicate
async_insert_max_data_size
async_insert_max_query_number
async_insert_poll_timeout_ms
async_insert_use_adaptive_busy_timeout
async_query_sending_for_remote
async_socket_for_remote
azure_allow_parallel_part_upload
azure_check_objects_after_upload
azure_create_new_file_on_insert
azure_ignore_file_doesnt_exist
azure_list_object_keys_size
azure_max_blocks_in_multipart_upload
azure_max_inflight_parts_for_one_file
azure_max_single_part_copy_size
azure_max_single_part_upload_size
azure_max_single_read_retries
azure_max_unexpected_write_error_retries
azure_max_upload_part_size
azure_min_upload_part_size
azure_sdk_max_retries
azure_sdk_retry_initial_backoff_ms
azure_sdk_retry_max_backoff_ms
azure_skip_empty_files
azure_strict_upload_part_size
azure_throw_on_zero_files_match
azure_truncate_on_insert
azure_upload_part_size_multiply_factor
azure_upload_part_size_multiply_parts_count_threshold
backup_restore_batch_size_for_keeper_multi
backup_restore_batch_size_for_keeper_multiread
backup_restore_failure_after_host_disconnected_for_seconds
backup_restore_finish_timeout_after_error_sec
backup_restore_keeper_fault_injection_probability
backup_restore_keeper_fault_injection_seed
backup_restore_keeper_max_retries
backup_restore_keeper_max_retries_while_handling_error
backup_restore_keeper_max_retries_while_initializing
backup_restore_keeper_retry_initial_backoff_ms
backup_restore_keeper_retry_max_backoff_ms
backup_restore_keeper_value_max_size
backup_restore_s3_retry_attempts
cache_warmer_threads
calculate_text_stack_trace
cancel_http_readonly_queries_on_client_close
cast_ipv4_ipv6_default_on_conversion_error
cast_keep_nullable
cast_string_to_dynamic_use_inference
check_query_single_value_result
check_referential_table_dependencies
check_table_dependencies
checksum_on_read
cloud_mode
cloud_mode_database_engine
cloud_mode_engine
cluster_for_parallel_replicas
collect_hash_table_stats_during_aggregation
collect_hash_table_stats_during_joins
compatibility
compatibility_ignore_auto_increment_in_create_table
compatibility_ignore_collation_in_create_table
compile_aggregate_expressions
compile_expressions
compile_sort_description
connect_timeout
connect_timeout_with_failover_ms
connect_timeout_with_failover_secure_ms
connection_pool_max_wait_ms
connections_with_failover_max_tries
convert_query_to_cnf
count_distinct_implementation
count_distinct_optimization
create_if_not_exists
create_index_ignore_unique
create_replicated_merge_tree_fault_injection_probability
create_table_empty_primary_key_by_default
cross_join_min_bytes_to_compress
cross_join_min_rows_to_compress
data_type_default_nullable
database_atomic_wait_for_drop_and_detach_synchronously
database_replicated_allow_explicit_uuid
database_replicated_allow_heavy_create
database_replicated_allow_only_replicated_engine
database_replicated_allow_replicated_engine_arguments
database_replicated_always_detach_permanently
database_replicated_enforce_synchronous_settings
database_replicated_initial_query_timeout_sec
decimal_check_overflow
deduplicate_blocks_in_dependent_materialized_views
default_materialized_view_sql_security
default_max_bytes_in_join
default_normal_view_sql_security
default_table_engine
default_temporary_table_engine
default_view_definer
describe_compact_output
describe_extend_object_types
describe_include_subcolumns
describe_include_virtual_columns
dialect
dictionary_validate_primary_key_type
distinct_overflow_mode
distributed_aggregation_memory_efficient
distributed_background_insert_batch
distributed_background_insert_max_sleep_time_ms
distributed_background_insert_sleep_time_ms
distributed_background_insert_split_batch_on_failure
distributed_background_insert_timeout
distributed_cache_bypass_connection_pool
distributed_cache_connect_max_tries
distributed_cache_data_packet_ack_window
distributed_cache_discard_connection_if_unread_data
distributed_cache_fetch_metrics_only_from_current_az
distributed_cache_log_mode
distributed_cache_max_unacked_inflight_packets
distributed_cache_min_bytes_for_seek
distributed_cache_pool_behaviour_on_limit
distributed_cache_read_alignment
distributed_cache_receive_response_wait_milliseconds
distributed_cache_receive_timeout_milliseconds
distributed_cache_throw_on_error
distributed_cache_wait_connection_from_pool_milliseconds
distributed_connections_pool_size
distributed_ddl_entry_format_version
distributed_ddl_output_mode
distributed_ddl_task_timeout
distributed_foreground_insert
distributed_group_by_no_merge
distributed_insert_skip_read_only_replicas
distributed_product_mode
distributed_push_down_limit
distributed_replica_error_cap
distributed_replica_error_half_life
distributed_replica_max_ignored_errors
do_not_merge_across_partitions_select_final
empty_result_for_aggregation_by_constant_keys_on_empty_set
empty_result_for_aggregation_by_empty_set
enable_adaptive_memory_spill_scheduler
enable_blob_storage_log
enable_deflate_qpl_codec
enable_early_constant_folding
enable_extended_results_for_datetime_functions
enable_filesystem_cache
enable_filesystem_cache_log
enable_filesystem_cache_on_write_operations
enable_filesystem_read_prefetches_log
enable_global_with_statement
enable_hdfs_pread
enable_http_compression
enable_job_stack_trace
enable_lightweight_delete
enable_memory_bound_merging_of_aggregation_results
enable_multiple_prewhere_read_steps
enable_named_columns_in_function_tuple
enable_optimize_predicate_expression
enable_optimize_predicate_expression_to_final_subquery
enable_order_by_all
enable_parsing_to_custom_serialization
enable_positional_arguments
enable_reads_from_query_cache
enable_s3_requests_logging
enable_scalar_subquery_optimization
enable_sharing_sets_for_mutations
enable_software_prefetch_in_aggregation
enable_unaligned_array_join
enable_url_encoding
enable_vertical_final
enable_writes_to_query_cache
enable_zstd_qat_codec
enforce_strict_identifier_format
engine_file_allow_create_multiple_files
engine_file_empty_if_not_exists
engine_file_skip_empty_files
engine_file_truncate_on_insert
engine_url_skip_empty_files
except_default_mode
external_storage_connect_timeout_sec
external_storage_max_read_bytes
external_storage_max_read_rows
external_storage_rw_timeout_sec
external_table_functions_use_nulls
external_table_strict_query
extract_key_value_pairs_max_pairs_per_row
extremes
fallback_to_stale_replicas_for_distributed_queries
filesystem_cache_boundary_alignment
filesystem_cache_enable_background_download_during_fetch
filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage
filesystem_cache_max_download_size
filesystem_cache_name
filesystem_cache_prefer_bigger_buffer_size
filesystem_cache_reserve_space_wait_lock_timeout_milliseconds
filesystem_cache_segments_batch_size
filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit
filesystem_prefetch_max_memory_usage
filesystem_prefetch_step_bytes
filesystem_prefetch_step_marks
filesystem_prefetches_limit
final
flatten_nested
force_aggregate_partitions_independently
force_aggregation_in_order
force_data_skipping_indices
force_grouping_standard_compatibility
force_index_by_date
force_optimize_projection
force_optimize_projection_name
force_optimize_skip_unused_shards
force_optimize_skip_unused_shards_nesting
force_primary_key
force_remove_data_recursively_on_drop
formatdatetime_f_prints_scale_number_of_digits
formatdatetime_f_prints_single_zero
formatdatetime_format_without_leading_zeros
formatdatetime_parsedatetime_m_is_month_name
fsync_metadata
function_implementation
function_json_value_return_type_allow_complex
function_json_value_return_type_allow_nullable
function_locate_has_mysql_compatible_argument_order
function_range_max_elements_in_block
function_sleep_max_microseconds_per_block
function_visible_width_behavior
geo_distance_returns_float64_on_float64_arguments
glob_expansion_max_elements
grace_hash_join_initial_buckets
grace_hash_join_max_buckets
group_by_overflow_mode
group_by_two_level_threshold
group_by_two_level_threshold_bytes
group_by_use_nulls
h3togeo_lon_lat_result_order
handshake_timeout_ms
hdfs_create_new_file_on_insert
hdfs_ignore_file_doesnt_exist
hdfs_replication
hdfs_skip_empty_files
hdfs_throw_on_zero_files_match
hdfs_truncate_on_insert
hedged_connection_timeout_ms
hnsw_candidate_list_size_for_search
hsts_max_age
http_connection_timeout
http_headers_progress_interval_ms
http_make_head_request
http_max_field_name_size
http_max_field_value_size
http_max_fields
http_max_multipart_form_data_size
http_max_request_param_data_size
http_max_tries
http_max_uri_size
http_native_compression_disable_checksumming_on_decompress
http_receive_timeout
http_response_buffer_size
http_response_headers
http_retry_initial_backoff_ms
http_retry_max_backoff_ms
http_send_timeout
http_skip_not_found_url_for_globs
http_wait_end_of_query
http_write_exception_in_output_format
http_zlib_compression_level
iceberg_snapshot_id
iceberg_timestamp_ms
idle_connection_timeout
ignore_cold_parts_seconds
ignore_data_skipping_indices
ignore_drop_queries_probability
ignore_materialized_views_with_dropped_target_table
ignore_on_cluster_for_replicated_access_entities_queries
ignore_on_cluster_for_replicated_named_collections_queries
ignore_on_cluster_for_replicated_udf_queries
implicit_select
implicit_transaction
input_format_parallel_parsing
insert_allow_materialized_columns
insert_deduplicate
insert_deduplication_token
insert_keeper_fault_injection_probability
insert_keeper_fault_injection_seed
insert_keeper_max_retries
insert_keeper_retry_initial_backoff_ms
insert_keeper_retry_max_backoff_ms
insert_null_as_default
insert_quorum
insert_quorum_parallel
insert_quorum_timeout
insert_shard_id
interactive_delay
intersect_default_mode
join_algorithm
join_any_take_last_row
join_default_strictness
join_on_disk_max_files_to_merge
join_output_by_rowlist_perkey_rows_threshold
join_overflow_mode
join_to_sort_maximum_table_rows
join_to_sort_minimum_perkey_rows
join_use_nulls
joined_subquery_requires_alias
kafka_disable_num_consumers_limit
kafka_max_wait_ms
keeper_map_strict_mode
keeper_max_retries
keeper_retry_initial_backoff_ms
keeper_retry_max_backoff_ms
least_greatest_legacy_null_behavior
legacy_column_name_of_tuple_literal
lightweight_deletes_sync
limit
live_view_heartbeat_interval
load_balancing
load_balancing_first_offset
load_marks_asynchronously
local_filesystem_read_method
local_filesystem_read_prefetch
lock_acquire_timeout
log_comment
log_formatted_queries
log_processors_profiles
log_profile_events
log_queries
log_queries_cut_to_length
log_queries_min_query_duration_ms
log_queries_min_type
log_queries_probability
log_query_settings
log_query_threads
log_query_views
low_cardinality_allow_in_native_format
low_cardinality_max_dictionary_size
low_cardinality_use_single_dictionary_for_part
low_priority_query_wait_time_ms
materialize_skip_indexes_on_insert
materialize_statistics_on_insert
materialize_ttl_after_modify
materialized_views_ignore_errors
max_analyze_depth
max_ast_depth
max_ast_elements
max_autoincrement_series
max_backup_bandwidth
max_block_size
max_bytes_before_external_group_by
max_bytes_before_external_sort
max_bytes_before_remerge_sort
max_bytes_in_distinct
max_bytes_in_join
max_bytes_in_set
max_bytes_ratio_before_external_group_by
max_bytes_ratio_before_external_sort
max_bytes_to_read
max_bytes_to_read_leaf
max_bytes_to_sort
max_bytes_to_transfer
max_columns_to_read
max_compress_block_size
max_concurrent_queries_for_all_users
max_concurrent_queries_for_user
max_distributed_connections
max_distributed_depth
max_download_buffer_size
max_download_threads
max_estimated_execution_time
max_execution_speed
max_execution_speed_bytes
max_execution_time
max_execution_time_leaf
max_expanded_ast_elements
max_fetch_partition_retries_count
max_final_threads
max_http_get_redirects
max_hyperscan_regexp_length
max_hyperscan_regexp_total_length
max_insert_block_size
max_insert_delayed_streams_for_parallel_write
max_insert_threads
max_joined_block_size_rows
max_limit_for_ann_queries
max_live_view_insert_blocks_before_refresh
max_local_read_bandwidth
max_local_write_bandwidth
max_memory_usage
max_memory_usage_for_user
max_network_bandwidth
max_network_bandwidth_for_all_users
max_network_bandwidth_for_user
max_network_bytes
max_number_of_partitions_for_independent_aggregation
max_parallel_replicas
max_parser_backtracks
max_parser_depth
max_parsing_threads
max_partition_size_to_drop
max_partitions_per_insert_block
max_partitions_to_read
max_parts_to_move
max_query_size
max_read_buffer_size
max_read_buffer_size_local_fs
max_read_buffer_size_remote_fs
max_recursive_cte_evaluation_depth
max_remote_read_network_bandwidth
max_remote_write_network_bandwidth
max_replica_delay_for_distributed_queries
max_result_bytes
max_result_rows
max_rows_in_distinct
max_rows_in_join
max_rows_in_set
max_rows_in_set_to_optimize_join
max_rows_to_group_by
max_rows_to_read
max_rows_to_read_leaf
max_rows_to_sort
max_rows_to_transfer
max_sessions_for_user
max_size_to_preallocate_for_aggregation
max_size_to_preallocate_for_joins
max_streams_for_merge_tree_reading
max_streams_multiplier_for_merge_tables
max_streams_to_max_threads_ratio
max_subquery_depth
max_table_size_to_drop
max_temporary_columns
max_temporary_data_on_disk_size_for_query
max_temporary_data_on_disk_size_for_user
max_temporary_non_const_columns
max_threads
max_threads_for_indexes
max_untracked_memory
memory_overcommit_ratio_denominator
memory_overcommit_ratio_denominator_for_user
memory_profiler_sample_max_allocation_size
memory_profiler_sample_min_allocation_size
memory_profiler_sample_probability
memory_profiler_step
memory_tracker_fault_probability
memory_usage_overcommit_max_wait_microseconds
merge_table_max_tables_to_look_for_schema_inference
merge_tree_coarse_index_granularity
merge_tree_compact_parts_min_granules_to_multibuffer_read
merge_tree_determine_task_size_by_prewhere_columns
merge_tree_max_bytes_to_use_cache
merge_tree_max_rows_to_use_cache
merge_tree_min_bytes_for_concurrent_read
merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem
merge_tree_min_bytes_for_seek
merge_tree_min_bytes_per_task_for_remote_reading
merge_tree_min_read_task_size
merge_tree_min_rows_for_concurrent_read
merge_tree_min_rows_for_concurrent_read_for_remote_filesystem
merge_tree_min_rows_for_seek
merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability
merge_tree_use_const_size_tasks_for_remote_reading
merge_tree_use_deserialization_prefixes_cache
merge_tree_use_prefixes_deserialization_thread_pool
merge_tree_use_v1_object_and_dynamic_serialization
metrics_perf_events_enabled
metrics_perf_events_list
min_bytes_to_use_direct_io
min_bytes_to_use_mmap_io
min_chunk_bytes_for_parallel_parsing
min_compress_block_size
min_count_to_compile_aggregate_expression
min_count_to_compile_expression
min_count_to_compile_sort_description
min_execution_speed
min_execution_speed_bytes
min_external_sort_block_bytes
min_external_table_block_size_bytes
min_external_table_block_size_rows
min_free_disk_bytes_to_perform_insert
min_free_disk_ratio_to_perform_insert
min_free_disk_space_for_temporary_data
min_hit_rate_to_use_consecutive_keys_optimization
min_insert_block_size_bytes
min_insert_block_size_bytes_for_materialized_views
min_insert_block_size_rows
min_insert_block_size_rows_for_materialized_views
min_joined_block_size_bytes
mongodb_throw_on_unsupported_query
move_all_conditions_to_prewhere
move_primary_key_columns_to_end_of_prewhere
multiple_joins_try_to_keep_original_names
mutations_execute_nondeterministic_on_initiator
mutations_execute_subqueries_on_initiator
mutations_max_literal_size_to_replace
mutations_sync
mysql_datatypes_support_level
mysql_map_fixed_string_to_text_in_show_columns
mysql_map_string_to_text_in_show_columns
mysql_max_rows_to_insert
network_compression_method
network_zstd_compression_level
normalize_function_names
number_of_mutations_to_delay
number_of_mutations_to_throw
odbc_bridge_connection_pool_size
odbc_bridge_use_connection_pooling
offset
opentelemetry_start_trace_probability
opentelemetry_trace_processors
optimize_aggregation_in_order
optimize_aggregators_of_group_by_keys
optimize_and_compare_chain
optimize_append_index
optimize_arithmetic_operations_in_aggregate_functions
optimize_count_from_files
optimize_distinct_in_order
optimize_distributed_group_by_sharding_key
optimize_extract_common_expressions
optimize_functions_to_subcolumns
optimize_group_by_constant_keys
optimize_group_by_function_keys
optimize_if_chain_to_multiif
optimize_if_transform_strings_to_enum
optimize_injective_functions_in_group_by
optimize_injective_functions_inside_uniq
optimize_min_equality_disjunction_chain_length
optimize_min_inequality_conjunction_chain_length
optimize_move_to_prewhere
optimize_move_to_prewhere_if_final
optimize_multiif_to_if
optimize_normalize_count_variants
optimize_on_insert
optimize_or_like_chain
optimize_read_in_order
optimize_read_in_window_order
optimize_redundant_functions_in_order_by
optimize_respect_aliases
optimize_rewrite_aggregate_function_with_if
optimize_rewrite_array_exists_to_has
optimize_rewrite_sum_if_to_count_if
optimize_skip_merged_partitions
optimize_skip_unused_shards
optimize_skip_unused_shards_limit
optimize_skip_unused_shards_nesting
optimize_skip_unused_shards_rewrite_in
optimize_sorting_by_input_stream_properties
optimize_substitute_columns
optimize_syntax_fuse_functions
optimize_throw_if_noop
optimize_time_filter_with_preimage
optimize_trivial_approximate_count_query
optimize_trivial_count_query
optimize_trivial_insert_select
optimize_uniq_to_count
optimize_use_implicit_projections
optimize_use_projections
optimize_using_constraints
os_thread_priority
output_format_compression_level
output_format_compression_zstd_window_log
output_format_parallel_formatting
page_cache_inject_eviction
parallel_distributed_insert_select
parallel_replica_offset
parallel_replicas_allow_in_with_subquery
parallel_replicas_count
parallel_replicas_custom_key
parallel_replicas_custom_key_range_lower
parallel_replicas_custom_key_range_upper
parallel_replicas_for_cluster_engines
parallel_replicas_for_non_replicated_merge_tree
parallel_replicas_index_analysis_only_on_coordinator
parallel_replicas_local_plan
parallel_replicas_mark_segment_size
parallel_replicas_min_number_of_rows_per_replica
parallel_replicas_mode
parallel_replicas_only_with_analyzer
parallel_replicas_prefer_local_join
parallel_view_processing
parallelize_output_from_storages
parsedatetime_parse_without_leading_zeros
partial_merge_join_left_table_buffer_bytes
partial_merge_join_rows_in_right_blocks
partial_result_on_first_cancel
parts_to_delay_insert
parts_to_throw_insert
periodic_live_view_refresh
poll_interval
postgresql_connection_attempt_timeout
postgresql_connection_pool_auto_close_connection
postgresql_connection_pool_retries
postgresql_connection_pool_size
postgresql_connection_pool_wait_timeout
postgresql_fault_injection_probability
prefer_column_name_to_alias
prefer_external_sort_block_bytes
prefer_global_in_and_join
prefer_localhost_replica
prefer_warmed_unmerged_parts_seconds
preferred_block_size_bytes
preferred_max_column_in_block_size_bytes
preferred_optimize_projection_name
prefetch_buffer_size
print_pretty_type_names
priority
push_external_roles_in_interserver_queries
query_cache_compress_entries
query_cache_max_entries
query_cache_max_size_in_bytes
query_cache_min_query_duration
query_cache_min_query_runs
query_cache_nondeterministic_function_handling
query_cache_share_between_users
query_cache_squash_partial_results
query_cache_system_table_handling
query_cache_tag
query_cache_ttl
query_metric_log_interval
query_plan_aggregation_in_order
query_plan_convert_join_to_in
query_plan_convert_outer_join_to_inner_join
query_plan_enable_multithreading_after_window_functions
query_plan_enable_optimizations
query_plan_execute_functions_after_sorting
query_plan_filter_push_down
query_plan_join_shard_by_pk_ranges
query_plan_join_swap_table
query_plan_lift_up_array_join
query_plan_lift_up_union
query_plan_max_limit_for_lazy_materialization
query_plan_max_optimizations_to_apply
query_plan_merge_expressions
query_plan_merge_filters
query_plan_optimize_lazy_materialization
query_plan_optimize_prewhere
query_plan_push_down_limit
query_plan_read_in_order
query_plan_remove_redundant_distinct
query_plan_remove_redundant_sorting
query_plan_reuse_storage_ordering_for_window_functions
query_plan_split_filter
query_plan_try_use_vector_search
query_plan_use_new_logical_join_step
query_profiler_cpu_time_period_ns
query_profiler_real_time_period_ns
queue_max_wait_ms
rabbitmq_max_wait_ms
read_backoff_max_throughput
read_backoff_min_concurrency
read_backoff_min_events
read_backoff_min_interval_between_events_ms
read_backoff_min_latency_ms
read_from_filesystem_cache_if_exists_otherwise_bypass_cache
read_from_page_cache_if_exists_otherwise_bypass_cache
read_in_order_two_level_merge_threshold
read_in_order_use_buffering
read_in_order_use_virtual_row
read_overflow_mode
read_overflow_mode_leaf
read_priority
read_through_distributed_cache
readonly
receive_data_timeout_ms
receive_timeout
regexp_max_matches_per_row
reject_expensive_hyperscan_regexps
remerge_sort_lowered_memory_bytes_ratio
remote_filesystem_read_method
remote_filesystem_read_prefetch
remote_fs_read_backoff_max_tries
remote_fs_read_max_backoff_ms
remote_read_min_bytes_for_seek
rename_files_after_processing
replace_running_query
replace_running_query_max_wait_ms
replication_wait_for_inactive_replica_timeout
restore_replace_external_dictionary_source_to_null
restore_replace_external_engines_to_null
restore_replace_external_table_functions_to_null
restore_replicated_merge_tree_to_shared_merge_tree
result_overflow_mode
rewrite_count_distinct_if_with_count_distinct_implementation
s3_allow_multipart_copy
s3_allow_parallel_part_upload
s3_check_objects_after_upload
s3_connect_timeout_ms
s3_create_new_file_on_insert
s3_disable_checksum
s3_ignore_file_doesnt_exist
s3_list_object_keys_size
s3_max_connections
s3_max_get_burst
s3_max_get_rps
s3_max_inflight_parts_for_one_file
s3_max_part_number
s3_max_put_burst
s3_max_put_rps
s3_max_redirects
s3_max_single_operation_copy_size
s3_max_single_part_upload_size
s3_max_single_read_retries
s3_max_unexpected_write_error_retries
s3_max_upload_part_size
s3_min_upload_part_size
s3_request_timeout_ms
s3_retry_attempts
s3_skip_empty_files
s3_strict_upload_part_size
s3_throw_on_zero_files_match
s3_truncate_on_insert
s3_upload_part_size_multiply_factor
s3_upload_part_size_multiply_parts_count_threshold
s3_use_adaptive_timeouts
s3_validate_request_settings
s3queue_default_zookeeper_path
s3queue_enable_logging_to_s3queue_log
s3queue_migrate_old_metadata_to_buckets
schema_inference_cache_require_modification_time_for_url
schema_inference_use_cache_for_azure
schema_inference_use_cache_for_file
schema_inference_use_cache_for_hdfs
schema_inference_use_cache_for_s3
schema_inference_use_cache_for_url
select_sequential_consistency
send_logs_level
send_logs_source_regexp
send_progress_in_http_headers
send_timeout
session_timezone
set_overflow_mode
shared_merge_tree_sync_parts_on_partition_operations
short_circuit_function_evaluation
short_circuit_function_evaluation_for_nulls
short_circuit_function_evaluation_for_nulls_threshold
show_table_uuid_in_table_create_query_if_not_nil
single_join_prefer_left_table
skip_redundant_aliases_in_udf
skip_unavailable_shards
sleep_after_receiving_query_ms
sleep_in_send_data_ms
sleep_in_send_tables_status_ms
sort_overflow_mode
split_intersecting_parts_ranges_into_layers_final
split_parts_ranges_into_intersecting_and_non_intersecting_final
splitby_max_substrings_includes_remaining_string
stop_refreshable_materialized_views_on_startup
storage_file_read_method
storage_system_stack_trace_pipe_read_timeout_ms
stream_flush_interval_ms
stream_like_engine_allow_direct_select
stream_like_engine_insert_queue
stream_poll_timeout_ms
system_events_show_zero_values
table_function_remote_max_addresses
tcp_keep_alive_timeout
temporary_data_in_cache_reserve_space_wait_lock_timeout_milliseconds
temporary_files_codec
throw_if_deduplication_in_dependent_materialized_views_enabled_with_async_insert
throw_if_no_data_to_insert
throw_on_error_from_cache_on_write_operations
throw_on_max_partitions_per_insert_block
throw_on_unsupported_query_inside_transaction
timeout_before_checking_execution_speed
timeout_overflow_mode
timeout_overflow_mode_leaf
totals_auto_threshold
totals_mode
trace_profile_events
transfer_overflow_mode
transform_null_in
traverse_shadow_remote_data_paths
union_default_mode
unknown_packet_in_send_data
use_async_executor_for_materialized_views
use_cache_for_count_from_files
use_client_time_zone
use_compact_format_in_distributed_parts_names
use_concurrency_control
use_hedged_requests
use_hive_partitioning
use_iceberg_partition_pruning
use_index_for_in_with_subqueries
use_index_for_in_with_subqueries_max_values
use_json_alias_for_old_object_type
use_page_cache_for_disks_without_file_cache
use_page_cache_with_distributed_cache
use_query_cache
use_query_condition_cache
use_skip_indexes
use_skip_indexes_if_final
use_structure_from_insertion_table_in_table_functions
use_uncompressed_cache
use_variant_as_common_type
use_with_fill_by_sorting_prefix
validate_enum_literals_in_operators
validate_mutation_query
validate_polygons
wait_changes_become_visible_after_commit_mode
wait_for_async_insert
wait_for_async_insert_timeout
wait_for_window_view_fire_signal_timeout
window_view_clean_interval
window_view_heartbeat_interval
workload
write_through_distributed_cache
zstd_window_log_max

add_http_cors_header​

additional_result_filter​

additional_table_filters​

aggregate_functions_null_for_empty​

aggregation_in_order_max_block_bytes​

aggregation_memory_efficient_merge_threads​

allow_aggregate_partitions_independently​

allow_archive_path_syntax​

allow_asynchronous_read_from_io_pool_for_merge_tree​

allow_changing_replica_until_first_data_packet​

allow_create_index_without_type​

allow_custom_error_code_in_throwif​

allow_ddl​

allow_deprecated_database_ordinary​

allow_deprecated_error_prone_window_functions​

allow_deprecated_snowflake_conversion_functions​

allow_deprecated_syntax_for_merge_tree​

allow_distributed_ddl​

allow_drop_detached​

allow_execute_multiif_columnar​

allow_experimental_analyzer​

allow_experimental_codecs​

allow_experimental_database_glue_catalog​

allow_experimental_database_iceberg​

allow_experimental_database_materialized_postgresql​

allow_experimental_database_unity_catalog​

allow_experimental_dynamic_type​

allow_experimental_full_text_index​

allow_experimental_funnel_functions​

allow_experimental_hash_functions​

allow_experimental_inverted_index​

allow_experimental_join_condition​

allow_experimental_join_right_table_sorting​

allow_experimental_json_type​

allow_experimental_kafka_offsets_storage_in_keeper​

allow_experimental_kusto_dialect​

allow_experimental_live_view​

allow_experimental_materialized_postgresql_table​

allow_experimental_nlp_functions​

allow_experimental_object_type​

allow_experimental_parallel_reading_from_replicas​

allow_experimental_prql_dialect​

allow_experimental_query_deduplication​

allow_experimental_shared_set_join​

allow_experimental_statistics​

allow_experimental_time_series_table​

allow_experimental_ts_to_grid_aggregate_function​

allow_experimental_variant_type​

allow_experimental_vector_similarity_index​

allow_experimental_window_view​

allow_general_join_planning​

allow_get_client_http_header​

allow_hyperscan​

allow_introspection_functions​

allow_materialized_view_with_bad_select​

allow_named_collection_override_by_default​

allow_non_metadata_alters​

allow_nonconst_timezone_arguments​

allow_nondeterministic_mutations​

allow_nondeterministic_optimize_skip_unused_shards​

allow_not_comparable_types_in_comparison_functions​

allow_not_comparable_types_in_order_by​

allow_prefetched_read_pool_for_local_filesystem​

allow_prefetched_read_pool_for_remote_filesystem​

allow_push_predicate_ast_for_distributed_subqueries​

allow_push_predicate_when_subquery_contains_with​

allow_reorder_prewhere_conditions​

allow_settings_after_format_in_insert​

allow_simdjson​

allow_statistics_optimize​

allow_suspicious_codecs​

allow_suspicious_fixed_string_types​

allow_suspicious_indices​

allow_suspicious_low_cardinality_types​

allow_suspicious_primary_key​

allow_suspicious_ttl_expressions​

allow_suspicious_types_in_group_by​

allow_suspicious_types_in_order_by​

allow_suspicious_variant_types​

allow_unrestricted_reads_from_keeper​

add_http_cors_header

additional_result_filter

additional_table_filters

aggregate_functions_null_for_empty

aggregation_in_order_max_block_bytes

aggregation_memory_efficient_merge_threads

allow_aggregate_partitions_independently

allow_archive_path_syntax

allow_asynchronous_read_from_io_pool_for_merge_tree

allow_changing_replica_until_first_data_packet

allow_create_index_without_type

allow_custom_error_code_in_throwif

allow_ddl

allow_deprecated_database_ordinary

allow_deprecated_error_prone_window_functions

allow_deprecated_snowflake_conversion_functions

allow_deprecated_syntax_for_merge_tree

allow_distributed_ddl

allow_drop_detached

allow_execute_multiif_columnar

allow_experimental_analyzer

allow_experimental_codecs

allow_experimental_database_glue_catalog

allow_experimental_database_iceberg

allow_experimental_database_materialized_postgresql

allow_experimental_database_unity_catalog

allow_experimental_dynamic_type

allow_experimental_full_text_index

allow_experimental_funnel_functions

allow_experimental_hash_functions

allow_experimental_inverted_index

allow_experimental_join_condition

allow_experimental_join_right_table_sorting

allow_experimental_json_type

allow_experimental_kafka_offsets_storage_in_keeper

allow_experimental_kusto_dialect

allow_experimental_live_view

allow_experimental_materialized_postgresql_table

allow_experimental_nlp_functions

allow_experimental_object_type

allow_experimental_parallel_reading_from_replicas

allow_experimental_prql_dialect

allow_experimental_query_deduplication

allow_experimental_shared_set_join

allow_experimental_statistics

allow_experimental_time_series_table

allow_experimental_ts_to_grid_aggregate_function

allow_experimental_variant_type

allow_experimental_vector_similarity_index

allow_experimental_window_view

allow_general_join_planning

allow_get_client_http_header

allow_hyperscan

allow_introspection_functions

allow_materialized_view_with_bad_select

allow_named_collection_override_by_default

allow_non_metadata_alters

allow_nonconst_timezone_arguments

allow_nondeterministic_mutations

allow_nondeterministic_optimize_skip_unused_shards

allow_not_comparable_types_in_comparison_functions

allow_not_comparable_types_in_order_by

allow_prefetched_read_pool_for_local_filesystem

allow_prefetched_read_pool_for_remote_filesystem

allow_push_predicate_ast_for_distributed_subqueries

allow_push_predicate_when_subquery_contains_with

allow_reorder_prewhere_conditions

allow_settings_after_format_in_insert

allow_simdjson

allow_statistics_optimize

allow_suspicious_codecs

allow_suspicious_fixed_string_types

allow_suspicious_indices

allow_suspicious_low_cardinality_types

allow_suspicious_primary_key

allow_suspicious_ttl_expressions

allow_suspicious_types_in_group_by

allow_suspicious_types_in_order_by

allow_suspicious_variant_types

allow_unrestricted_reads_from_keeper