Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.
use_async_executor_for_materialized_views
Использовать асинхронное и, возможно, многопоточное выполнение запроса materialized view; это может ускорить обработку materialized view при INSERT, но также может увеличить потребление памяти.
use_cache_for_count_from_files
Включает кэширование количества строк при подсчете строк в файлах с помощью табличных функций file/s3/url/hdfs/azureBlobStorage.
Включено по умолчанию.
Использовать часовой пояс клиента для интерпретации строковых значений DateTime вместо часового пояса сервера.
Использует компактный формат для хранения блоков при фоновой (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, поэтому учитывайте это.
Учитывать управление параллелизмом на сервере (см. глобальные настройки сервера concurrent_threads_soft_limit_num и concurrent_threads_soft_limit_ratio_to_cores). Если отключено, позволяет использовать больше потоков, даже если сервер перегружен (не рекомендуется для обычной работы и в основном требуется для тестов).
use_constant_folding_in_index_analysis
Подставляет константы уровня партиции в предикат фильтра при анализе первичного ключа и индекса пропуска данных для каждой части.
Если ключ партиционирования используется в фильтре вместе со столбцами первичного ключа или индекса пропуска данных, анализ индексов может отдельно сворачивать значение партиции в пределах каждой части. Это особенно полезно для дизъюнктивных фильтров, ветви которых относятся к разным партициям. Например, при PARTITION BY a и ORDER BY b:
Для части в партиции a = 1 условие упрощается до b >= 1, а для партиций a = 2 и a = 3 — до b > 10, поэтому каждая часть анализируется с предикатом, который действительно к ней применим.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
use_hash_table_stats_for_join_reordering
Включает использование собранной статистики хеш-таблиц для оценки мощности при переупорядочивании JOIN
Включает логику hedged requests для удалённых запросов. Позволяет устанавливать для одного запроса несколько соединений с разными репликами.
Новое соединение создаётся, если существующее соединение с репликой не было установлено в течение hedged_connection_timeout
или если в течение receive_data_timeout не были получены данные. Запрос использует первое соединение, которое отправит непустой пакет Прогресс (или пакет данные, если allow_changing_replica_until_first_data_packet);
остальные соединения отменяются. Поддерживаются запросы с max_parallel_replicas > 1.
Включено по умолчанию.
Значение по умолчанию в Cloud: 0.
Когда настройка включена, ClickHouse обнаруживает секционирование в стиле Hive в пути (/name=value/) в табличных движках File/S3/URL/HDFS/AzureBlobStorage и позволяет использовать столбцы партиции в запросе как виртуальные столбцы. Эти виртуальные столбцы будут иметь те же имена, что и в секционированном пути, но с префиксом _.
use_join_disjunctions_push_down
Включает перенос на соответствующие стороны входных данных частей условий JOIN, объединённых через OR (“частичный pushdown”).
Это позволяет движкам хранения данных фильтровать данные на более раннем этапе, что может сократить объём читаемых данных.
Оптимизация не меняет семантику и применяется только тогда, когда каждая OR-ветвь верхнего уровня содержит хотя бы один детерминированный
предикат для целевой стороны.
Если настройка включена, можно использовать устаревшую функцию toTime, которая преобразует дату и время в определённую фиксированную дату, сохраняя время.
В противном случае используется новая функция toTime, которая преобразует данные различных типов в тип Time.
Старая функция также всегда доступна как toTimeWithFixedDate.
use_lightweight_primary_key_index_analysis
Оптимизирует анализ индекса первичного ключа для таблиц MergeTree с длинным первичным ключом.
Если настройка включена, время выполнения анализа индекса в основном зависит от сложности фильтра запроса (то есть от столбцов ключа, которые он фактически использует), а не от длины первичного ключа. Поэтому расширение ключа сортировки почти не добавляет накладных расходов при анализе индекса для запросов, которые фильтруют только по нескольким его столбцам.
Возможные значения:
- 0 — Отключено. При анализе индекса обрабатываются все столбцы первичного ключа.
- 1 — Включено.
Если параметр включен, формат Parquet может использовать кэш метаданных Parquet.
Возможные значения:
- 0 - Отключено
- 1 - Включено
Использовать первичный ключ для отсечения гранул при выполнении запроса в таблицах MergeTree.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Экспериментально. Маршрутизирует чтение через новый конвейер ReaderExecutor вместо устаревшей матрёшки буферов чтения. Для конфигураций, которые исполнитель пока не поддерживает, используется устаревший путь.
use_roaring_bitmap_iceberg_positional_deletes
Использовать roaring-битмап для позиционных удалений в Iceberg.
use_streaming_marks_compression
При загрузке marks для частей MergeTree сжимайте их во внутреннее представление в памяти по одному блоку за раз (стриминг) вместо того, чтобы сначала материализовать полный обычный массив marks. Это значительно снижает пиковое использование памяти при загрузке marks для компактных частей с большим количеством substreams (например, для таблиц с JSON-столбцами и включенной настройкой write_marks_for_substreams_in_compact_parts).
use_strict_insert_block_limits
Если включено, строго применяются и минимальные, и максимальные ограничения на размер блока вставки.
Блок формируется, когда:
- Минимальные пороги (побитовое И): достигнуты оба значения — min_insert_block_size_rows и min_insert_block_size_bytes.
- Максимальные пороги (OR): достигнуто либо max_insert_block_size_rows, либо max_insert_block_size_bytes.
Если отключено, блок формируется, когда:
- Минимальные пороги (OR): достигнуто min_insert_block_size_rows или min_insert_block_size_bytes.
Note: Если максимальные настройки меньше минимальных, приоритет имеют максимальные ограничения, и блоки будут формироваться до достижения минимальных порогов.
Note: Эта настройка автоматически отключается для async inserts, поскольку async inserts добавляют токены дедупликации для каждой записи, что несовместимо с разбиением блоков, необходимым для соблюдения строгих ограничений.
По умолчанию отключено.
use_structure_from_insertion_table_in_table_functions
Использовать структуру таблицы назначения вместо автоматического определения схемы по данным. Возможные значения: 0 — отключено, 1 — включено, 2 — автоматически
Определяет, использовать ли кэш несжатых данных. Допустимые значения: 0 или 1. По умолчанию — 0 (отключено).
Использование кэша несжатых данных (только для таблиц семейства MergeTree) может значительно снизить задержку и повысить пропускную способность при работе с большим количеством коротких запросов. Включайте этот параметр для пользователей, которые часто отправляют короткие запросы. Также обратите внимание на параметр конфигурации uncompressed_cache_size (задается только в файле конфигурации) — размер блоков кэша несжатых данных. По умолчанию он составляет 8 GiB. Кэш несжатых данных заполняется по мере необходимости, а наименее используемые данные удаляются автоматически.
Для запросов, которые считывают хотя бы относительно большой объем данных (один миллион строк или более), кэш несжатых данных отключается автоматически, чтобы освободить место для действительно небольших запросов. Это означает, что параметр ‘use_uncompressed_cache’ можно всегда оставлять равным 1.
use_with_fill_by_sorting_prefix
Столбцы, расположенные перед столбцами WITH FILL в предложении ORDER BY, образуют префикс сортировки. Строки с разными значениями префикса сортировки заполняются независимо Последнее изменение 24 июля 2026 г.