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

allow_aggregate_partitions_independently

Включает независимую агрегацию партиций в отдельных потоках, если ключ партиционирования соответствует ключу GROUP BY. Полезно, когда число партиций близко к числу ядер, а сами партиции имеют примерно одинаковый размер. Эвристики в ReadFromMergeTree автоматически отключают эту оптимизацию при неблагоприятной структуре (слишком мало партиций, слишком много партиций или размеры партиций сильно перекошены); чтобы обойти эти проверки, см. force_aggregate_partitions_independently.

allow_archive_path_syntax

Движки File/S3 и табличная функция будут разбирать пути с ’::’ как <archive> :: <file>, если у архива корректное расширение.

allow_asynchronous_read_from_io_pool_for_merge_tree

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

allow_calculating_subcolumns_sizes_for_merge_tree_reading

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

allow_changing_replica_until_first_data_packet

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

allow_create_index_without_type

Разрешает выполнение запроса CREATE INDEX без TYPE. Запрос будет проигнорирован. Предназначено для тестов совместимости с SQL.

allow_custom_error_code_in_throwif

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

allow_ddl

Если установлено значение true, пользователю разрешается выполнять DDL-запросы.

allow_distributed_ddl

Если установлено значение true, пользователю разрешено выполнять распределённые DDL-запросы.

allow_drop_detached

Разрешает запросы ALTER TABLE … DROP DETACHED PART[ITION] …

allow_dynamic_type_in_join_keys

Разрешает использовать тип Dynamic в ключах JOIN. Добавлено для совместимости. Не рекомендуется использовать тип Dynamic в ключах JOIN, поскольку сравнение с другими типами может приводить к неожиданным результатам.

allow_execute_multiif_columnar

Разрешает выполнять функцию multiIf в столбцовом режиме

allow_fuzz_query_functions

Включает функцию fuzzQuery, которая применяет к строке запроса случайные мутации AST.

allow_general_join_planning

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

allow_get_client_http_header

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

allow_hyperscan

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

allow_iceberg_remove_orphan_files

Разрешает использовать ALTER TABLE ... EXECUTE remove_orphan_files() для таблиц Iceberg.

allow_insert_into_iceberg

Псевдонимы: allow_experimental_insert_into_iceberg Разрешает выполнять запросы insert в Iceberg.

allow_introspection_functions

Включает или отключает функции интроспекции при профилировании запросов. Возможные значения:
  • 1 — функции интроспекции включены.
  • 0 — функции интроспекции отключены.
См. также

allow_key_condition_coalesce_rewrite

Разрешает первичному ключу и индексам пропуска данных MergeTree отсекать гранулы для предикатов WHERE/PREWHERE, в которых используется coalesce или ifNull. Без этой настройки такие предикаты непрозрачны для анализа индексов и не позволяют отсекать данные, поэтому гранулы, которые заведомо не могут подойти, всё равно читаются. Это влияет только на то, какие гранулы читаются; результаты запроса не меняются, поскольку строки по-прежнему фильтруются исходным предикатом. Перед анализом индексов переписываются две формы предикатов:
  • Сравнение с coalesce/ifNull, например coalesce(a, b) = 5, преобразуется в дизъюнкцию, чтобы индекс по каждому аргументу мог отсекать данные: a = 5 OR (a IS NULL AND b = 5), с соответствующим расширением для большего числа аргументов.
  • coalesce/ifNull с ложной (нулевой) константой по умолчанию, используемый непосредственно как условие, например ifNull(a = 5, 0) или coalesce(a = 5, 0), разворачивается во внутренний предикат a = 5. Такие обёртки сводят трёхзначный результат внутреннего предиката к однозначному булевому значению (сопоставляя NULL со false).

allow_limit_by_partitions_independently

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

allow_materialized_view_with_bad_select

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

allow_minmax_index_for_json

Разрешает создавать индексы пропуска данных minmax для столбцов JSON (Object). По умолчанию отключено, поскольку путь сериализации индекса minmax не может обрабатывать неоднородные значения Field, которые могут содержаться в JSON-столбцах.

allow_named_collection_override_by_default

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

allow_non_metadata_alters

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

allow_nonconst_timezone_arguments

Разрешает использовать неконстантные аргументы часового пояса в некоторых функциях, связанных со временем, таких как toTimeZone(), fromUnixTimestamp*(), snowflakeIDToDateTime*(). Этот параметр существует исключительно для совместимости. В ClickHouse часовой пояс — это свойство типа данных, а значит, и столбца. Включение этого параметра создаёт ложное впечатление, что разные значения в одном столбце могут иметь разные часовые пояса. Поэтому, пожалуйста, не включайте этот параметр.

allow_nullable_tuple_in_extracted_subcolumns

Определяет, могут ли извлечённые подстолбцы типа Tuple(...) иметь тип Nullable(Tuple(...)).
  • false: Возвращает Tuple(...) и использует значения кортежа по умолчанию для строк, в которых подстолбец отсутствует.
  • true: Возвращает Nullable(Tuple(...)) и использует NULL для строк, в которых подстолбец отсутствует.
Эта настройка управляет только поведением извлечённых подстолбцов. Она не определяет, можно ли создавать в таблицах столбцы Nullable(Tuple(...)); это регулируется параметром enable_nullable_tuple_type. ClickHouse использует значение этой настройки, загруженное при запуске сервера. Изменения, внесённые с помощью SET или SETTINGS на уровне запроса, не меняют поведение извлечённых подстолбцов. Чтобы изменить поведение извлечённых подстолбцов, обновите allow_nullable_tuple_in_extracted_subcolumns в конфигурации профиля запуска (например, в users.xml) и перезапустите сервер.

allow_rank_dense_rank_arguments

Разрешает передавать аргументы в оконные функции RANK и DENSE_RANK для обратной совместимости. Согласно стандарту SQL, RANK и DENSE_RANK не принимают аргументов — они ранжируют строки только по окну OVER (ORDER BY ...). В версиях ClickHouse до 26.5 запросы вида RANK(x) OVER (...) молча принимали и игнорировали аргумент, что приводило к путанице у пользователей (наличие аргумента создавало впечатление, что он влияет на ранжирование, хотя это было не так). Когда эта настройка имеет значение false (по умолчанию), RANK и DENSE_RANK отклоняют любые аргументы и генерируют ошибку NUMBER_OF_ARGUMENTS_DOESNT_MATCH. Если установить значение true, восстанавливается прежнее более мягкое поведение — аргументы молча игнорируются, как и до версии 26.5.

allow_reorder_prewhere_conditions

При перемещении условий из WHERE в PREWHERE разрешает менять их порядок для оптимизации фильтрации

allow_replace_partition_from_empty_source

Разрешает ALTER TABLE ... REPLACE PARTITION ... FROM ... молча удалять партицию пункта назначения, если в источнике нет частей в этой партиции. По умолчанию это запрещено: REPLACE PARTITION из источника, в котором нет данных в запрошенной партиции, вызывает исключение, поскольку в таком случае операция фактически превращается в молчаливый DROP PARTITION для пункта назначения (данные в партиции пункта назначения удаляются, но взамен ничего не записывается), что нередко приводит к случайной потере данных (см. #23727). Включите эту настройку, чтобы вернуть прежнее поведение, например если вы намеренно используете пустую исходную партицию для очистки данных в пункте назначения. Если нужно просто удалить партицию без дополнительных условий, предпочтительнее использовать ALTER TABLE ... DROP PARTITION ....

allow_settings_after_format_in_insert

Управляет тем, разрешён ли SETTINGS после FORMAT в INSERT-запросах. Использовать это не рекомендуется, поскольку часть SETTINGS может быть интерпретирована как значения. Пример:
Но следующий запрос будет работать только при включённой настройке allow_settings_after_format_in_insert:
Возможные значения:
  • 0 — Запрещено.
  • 1 — Разрешено.
Используйте эту настройку только для обратной совместимости, если ваши сценарии зависят от старого синтаксиса.

allow_simdjson

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

allow_special_serialization_kinds_in_output_formats

Позволяет выводить столбцы со специальными видами сериализации, такими как Sparse и Replicated, без преобразования их в полные столбцы. Это помогает избежать лишнего копирования данных при форматировании.

allow_unrestricted_reads_from_keeper

Разрешает неограниченное чтение (без условия по path) из таблицы system.zookeeper; может быть удобно, но небезопасно для ZooKeeper
Последнее изменение 24 июля 2026 г.