Настройки сеанса use_*

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

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

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

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

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

Если ключ партиционирования используется в фильтре вместе со столбцами первичного ключа или индекса пропуска данных, анализ индексов может отдельно сворачивать значение партиции в пределах каждой части. Это особенно полезно для дизъюнктивных фильтров, ветви которых относятся к разным партициям. Например, при PARTITION BY a и ORDER BY b:

SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)

Для части в партиции a = 1 условие упрощается до b >= 1, а для партиций a = 2 и a = 3 — до b > 10, поэтому каждая часть анализируется с предикатом, который действительно к ней применим.

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

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

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

Применяет индексы, вычисляемые при чтении данных, непосредственно внутри пулов чтения MergeTree: диапазоны меток, полностью отфильтрованные индексами пропуска данных (см. use_skip_indexes_on_data_read) или индексом проекции (см. optimize_use_projection_filtering), отбрасываются до создания задач чтения, а не пропускаются гранула за гранулой в процессе чтения.

В пуле чтения с предварительным чтением отброшенные диапазоны никогда не подвергаются предварительному чтению, однако границы задач и допуск предварительного чтения через filesystem_prefetch_max_memory_usage / filesystem_prefetches_limit по-прежнему определяются до фильтрации. Поэтому при высокоселективных фильтрах оставшиеся задачи могут оказаться меньше заданного размера, а допуск — излишне консервативным.

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

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

Устаревшая функция также всегда доступна как toTimeWithFixedDate независимо от этой настройки. Когда эта настройка включена, используйте CAST(x AS Time) или x::Time для преобразования в тип Time.

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

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

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

• 0 — Отключено. При анализе индекса обрабатываются все столбцы первичного ключа.
• 1 — Включено.

Если параметр включен, формат Parquet может использовать кэш метаданных Parquet.

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

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

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

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

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

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

Использовать roaring-битмап для позиционных удалений в Iceberg.

При загрузке marks для частей MergeTree сжимайте их во внутреннее представление в памяти по одному блоку за раз (стриминг) вместо того, чтобы сначала материализовать полный обычный массив marks. Это значительно снижает пиковое использование памяти при загрузке marks для компактных частей с большим количеством substreams (например, для таблиц с JSON-столбцами и включенной настройкой write_marks_for_substreams_in_compact_parts).

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

Блок формируется, когда:

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

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

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

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

Для запросов, которые считывают хотя бы относительно большой объем данных (один миллион строк или более), кэш несжатых данных отключается автоматически, чтобы освободить место для действительно небольших запросов. Это означает, что параметр 'use_uncompressed_cache' можно всегда оставлять равным 1.

Столбцы, расположенные перед столбцами WITH FILL в предложении ORDER BY, образуют префикс сортировки. Строки с разными значениями префикса сортировки заполняются независимо