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

use_async_executor_for_materialized_views

Использовать асинхронное и, возможно, многопоточное выполнение запроса materialized view; это может ускорить обработку materialized view при INSERT, но также может увеличить потребление памяти.

use_cache_for_count_from_files

Включает кэширование количества строк при подсчете строк в файлах с помощью табличных функций file/s3/url/hdfs/azureBlobStorage. Включено по умолчанию.

use_client_time_zone

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

use_compact_format_in_distributed_parts_names

Использует компактный формат для хранения блоков при фоновой (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

Учитывать управление параллелизмом на сервере (см. глобальные настройки сервера 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

use_hedged_requests

Включает логику hedged requests для удалённых запросов. Позволяет устанавливать для одного запроса несколько соединений с разными репликами. Новое соединение создаётся, если существующее соединение с репликой не было установлено в течение hedged_connection_timeout или если в течение receive_data_timeout не были получены данные. Запрос использует первое соединение, которое отправит непустой пакет Прогресс (или пакет данные, если allow_changing_replica_until_first_data_packet); остальные соединения отменяются. Поддерживаются запросы с max_parallel_replicas > 1. Включено по умолчанию. Значение по умолчанию в Cloud: 0.

use_hive_partitioning

Когда настройка включена, ClickHouse обнаруживает секционирование в стиле Hive в пути (/name=value/) в табличных движках File/S3/URL/HDFS/AzureBlobStorage и позволяет использовать столбцы партиции в запросе как виртуальные столбцы. Эти виртуальные столбцы будут иметь те же имена, что и в секционированном пути, но с префиксом _.

use_join_disjunctions_push_down

Включает перенос на соответствующие стороны входных данных частей условий JOIN, объединённых через OR (“частичный pushdown”). Это позволяет движкам хранения данных фильтровать данные на более раннем этапе, что может сократить объём читаемых данных. Оптимизация не меняет семантику и применяется только тогда, когда каждая OR-ветвь верхнего уровня содержит хотя бы один детерминированный предикат для целевой стороны.

use_legacy_to_time

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

use_lightweight_primary_key_index_analysis

Оптимизирует анализ индекса первичного ключа для таблиц MergeTree с длинным первичным ключом. Если настройка включена, время выполнения анализа индекса в основном зависит от сложности фильтра запроса (то есть от столбцов ключа, которые он фактически использует), а не от длины первичного ключа. Поэтому расширение ключа сортировки почти не добавляет накладных расходов при анализе индекса для запросов, которые фильтруют только по нескольким его столбцам. Возможные значения:
  • 0 — Отключено. При анализе индекса обрабатываются все столбцы первичного ключа.
  • 1 — Включено.

use_parquet_metadata_cache

Если параметр включен, формат Parquet может использовать кэш метаданных Parquet. Возможные значения:
  • 0 - Отключено
  • 1 - Включено

use_primary_key

Использовать первичный ключ для отсечения гранул при выполнении запроса в таблицах MergeTree. Возможные значения:
  • 0 — Отключено.
  • 1 — Включено.

use_reader_executor

Экспериментально. Маршрутизирует чтение через новый конвейер 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 — автоматически

use_uncompressed_cache

Определяет, использовать ли кэш несжатых данных. Допустимые значения: 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 г.