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

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

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

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

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

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

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 — Интроспекционные функции отключены.

См. также

Профилировщик запросов снять выборку
Системная таблица trace_log

allow_materialized_view_with_bad_select

Тип: Bool

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

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

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

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

apply_mutations_on_fly

Тип: Bool

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

Если true, мутации (обновления и удаления), которые не материализованы в части данных, будут применяться при 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 blob, чтобы убедиться в успешности загрузки

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 blob.

azure_throw_on_zero_files_match

Тип: Bool

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

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

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

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, оператор CAST в тип 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

Совместимость игнорирования collation при создании таблицы

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, но набор результатов идентичен - логика Boolean не изменена:

Возможные значения: 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

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

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

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

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

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

default_materialized_view_sql_security

Тип: SQLSecurityType

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

Позволяет установить значение по умолчанию для параметра SQL SECURITY при создании материализованного представления. Подробнее о безопасности 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 или аналогичных ошибок. В этом случае повторная попытка не поможет (и это застрянет в распределённых отправках для таблицы), но отправка файлов из этого пакета по одному может привести к успешной вставке.

Установка этой настройки на 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

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

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

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

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 секунд

Управляет скоростью обнуления ошибок в распределённых таблицах. Если реплика недоступна в течение некоторого времени, накапливает 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

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, то данные могут быть распарсены напрямую в столбцы с пользовательской сериализацией (например, Sparse) в соответствии с подсказками для сериализации, полученными из таблицы.

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

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

Автоматически применяет модификатор FINAL ко всем таблицам в запросе, к таблицам, где FINAL применим, включая соединённые таблицы и таблицы в подзапросах, и распределённые таблицы.

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

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

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

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

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

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' возвращает (долгота, широта), если установлено в true, иначе (широта, долгота).

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

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

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 символов.

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

Пример: 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 во время insert. Допустимое значение лежит в интервале [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 — Повторные попытки отключены

Значение по умолчанию в Cloud: 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 согласованность для получения более подробной информации.

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

Если 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

примечание

Включает или отключает параллелизм для запросов 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 предоставляет опцию алгorithms, которая предоставляет эффективные сложные соединения при ограниченном использовании памяти.

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

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

hash

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

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

parallel_hash

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

При использовании алгоритма 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.

auto

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

full_sorting_merge

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

prefer_partial_merge

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

default (устарело)

Устаревшее значение, пожалуйста, не используйте больше. То же самое, что и direct,hash, т.е. попытаться использовать direct join и 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, выполняемых на диске.

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

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

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

join_output_by_rowlist_perkey_rows_threshold

Тип: UInt64

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

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

join_overflow_mode

Тип: OverflowMode

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

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

join_to_sort_maximum_table_rows

Experimental feature. Learn more.

Тип: UInt64

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

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

join_to_sort_minimum_perkey_rows

Experimental feature. Learn more.

Тип: UInt64

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

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

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

Интервал передачи сигналов (heartbeat) в секундах для указания, что активный запрос жив.

load_balancing

Тип: LoadBalancing

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

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

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

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

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

distributed_replica_max_ignored_errors

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

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

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

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

Например, 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

Тип: Seconds

Значение по умолчанию: 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

Тип: Milliseconds

Значение по умолчанию: 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, который может быть записан в файловую систему хранилища. Эта настройка предотвращает проблемы с ОЗУ в случае неограниченного роста словаря. Все данные, которые не могут быть закодированы из-за ограничения на размер словаря, 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 MiB). Указание меньшего размера блока обычно приводит к небольшому уменьшению коэффициента сжатия, скорость сжатия и декомпрессии немного повышается за счёт локальности кэша, и использование памяти уменьшается.

примечание

Это настройка уровня эксперта, и вы не должны изменять её, если только не начинаете работу с 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

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

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

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

Положительное целое число.
0 — Неограниченная глубина.

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

Положительное целое число.
0 или 1 — Отключено. Запросы SELECT выполняются в одном потоке.

max_http_get_redirects

Тип: UInt64

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

Максимальное количество допустимых HTTP GET перенаправлений. Обеспечивает дополнительные меры безопасности для предотвращения ситуации, при которой злонамеренный сервер перенаправляет ваши запросы на неожиданные сервисы.

Это происходит, когда внешний сервер перенаправляет на другой адрес, но этот адрес оказывается внутренним для инфраструктуры компании, и, отправив HTTP-запрос на внутренний сервер, вы можете запросить внутренний API из внутренней сети, обходя аутентификацию, или даже обращаться к другим сервисам, таким как Redis или Memcached. Когда у вас нет внутренней инфраструктуры (включая что-то работающее на вашем localhost), или вы доверяете серверу, безопасно разрешить перенаправления. Однако помните, что если URL использует HTTP вместо HTTPS, вы должны доверять не только удалённому серверу, но и вашему провайдеру и каждой сети посередине.

max_hyperscan_regexp_length

Тип: UInt64

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

Определяет максимальную длину для каждого регулярного выражения в функциях многоразового поиска hyperscan.

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

Положительное целое число.
0 - Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. также

max_hyperscan_regexp_total_length

max_hyperscan_regexp_total_length

Тип: UInt64

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

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

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

Положительное целое число.
0 - Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. также

max_hyperscan_regexp_length

max_insert_block_size

Тип: UInt64

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

Размер блоков (в количестве строк) для формирования при вставке в таблицу. Эта настройка применяется только в тех случаях, когда сервер формирует блоки. Например, для INSERT через HTTP интерфейс сервер разбирает формат данных и формирует блоки заданного размера. Однако при использовании clickhouse-client клиент сам разбирает данные, и настройка 'max_insert_block_size' на сервере не влияет на размер вставляемых блоков. Настройка также не имеет цели при использовании INSERT SELECT, так как данные вставляются с использованием тех же блоков, которые сформированы после SELECT.

Значение по умолчанию немного больше, чем max_block_size. Причина в том, что определённые движки таблиц (*MergeTree) формируют часть данных на диске для каждого вставляемого блока, что является достаточно большой сущностью. Аналогично, таблицы *MergeTree сортируют данные при вставке, и достаточно большой размер блока позволяет сортировать больше данных в ОЗУ.

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

Использовать ли только размер столбцов prewhere для определения размера задачи чтения.

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 — Прямой ввод-вывод отключён.
Положительное целое число.

min_bytes_to_use_mmap_io

Тип: UInt64

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

Это экспериментальная настройка. Устанавливает минимальное количество памяти для чтения больших файлов без копирования данных из ядра в пространство пользователя. Рекомендуемый порог составляет около 64 МБ, потому что mmap/munmap медленный. Это имеет смысл только для больших файлов и помогает только в том случае, если данные находятся в кэше страниц.

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

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

min_chunk_bytes_for_parallel_parsing

Тип: NonZeroUInt64

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

Тип: неотрицательное целое число
Значение по умолчанию: 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

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 (причина в том, что однажды это может быть включено по умолчанию, и это будет работать правильно только если данные были вставлены через распределенную таблицу, т. е. данные распределены согласно ключу шардирования).

optimize_extract_common_expressions

Тип: Bool

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

Разрешить извлечение общих выражений из дизъюнкций в выражениях WHERE, PREWHERE, ON, HAVING и QUALIFY. Логическое выражение вроде (A AND B) OR (A AND C) можно переписать как A AND (B OR C), что может помочь в использовании:

индексов в простых фильтрующих выражениях
оптимизации cross to inner join

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

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

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

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

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

Использовать приблизительное значение для оптимизации тривиального подсчёта для хранилищ, поддерживающих такую оценку, например, 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

Использовать ограничения для оптимизации запросов. По умолчанию ложь.

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

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, эта настройка явно задаёт размер окна сжатия (степень двойки) и включает режим сжатия на дальние расстояния для 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

Включает/отключает предпочтительное использование локальной реплики при обработке распределённых запросов.

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

1 — ClickHouse всегда отправляет запрос на локальную реплику, если она существует.
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 попытается применить указанную проекцию в запросе.

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

строка: имя предпочитаемой проекции

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

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

Если установлено любое отрицательное значение, он примет значение collect_interval_milliseconds из настройки журнала метрики запросов или по умолчанию 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

Переключает оптимизацию уровня плана запроса, которая перемещает большие поддеревья плана запроса в объединение, чтобы обеспечить дальнейшие оптимизации. Действует только если настройка 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

Переключает оптимизацию уровня плана запроса, которая перемещает LIMIT'ы вниз в плане выполнения. Действует только если настройка 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), чтобы сделать seek, вместо чтения с игнорированием.

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 consistency для получения дополнительной информации о поведении 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 значений в аргументах функции превышает порог короткозамкнутой оценки для NULL, система пропускает построчную оценку функции. Вместо этого она сразу возвращает NULL для всех строк, избегая ненужных вычислений.

short_circuit_function_evaluation_for_nulls_threshold

Тип: Double

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

Пороговое значение отношения значений NULL для выполнения функций с аргументами Nullable только на строках с ненулевыми значениями во всех аргументах. Применяется, когда включена настройка 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

Проходить по замороженным данным (каталог теней) в дополнение к актуальным данным таблицы при запросе 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' включенной.

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

Если установлено в true, ждать обработки асинхронной вставки.

Тип: 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_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
- Параллельная обработка с использованием SAMPLE ключа
- Параллельная обработка с использованием parallel_replicas_custom_key
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