настройки сеанса enable_* - ClickHouse Documentation

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

enable_adaptive_memory_spill_scheduler

Включает адаптивную выгрузку данных из памяти во внешнее хранилище. На данный момент поддерживается только Grace JOIN.

enable_add_distinct_to_in_subqueries

Включает DISTINCT в подзапросах IN. Это компромиссная настройка: при включении она может значительно уменьшить размер временных таблиц, передаваемых для распределённых подзапросов IN, и существенно ускорить передачу данных между сегментами, поскольку отправляются только уникальные значения. Однако включение этой настройки требует дополнительных затрат на слияние на каждом узле, так как необходимо выполнять дедупликацию (DISTINCT). Используйте эту настройку, если передача данных по сети является узким местом, а дополнительные затраты на слияние допустимы.

enable_automatic_decision_for_merging_across_partitions_for_final

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

enable_early_constant_folding

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

enable_extended_results_for_datetime_functions

Включает или отключает возврат результатов типа Date32 с расширенным диапазоном значений (по сравнению с типом Date) или DateTime64 с расширенным диапазоном значений (по сравнению с типом DateTime). Возможные значения:

0 — Функции возвращают Date или DateTime для аргументов всех типов.
1 — Функции возвращают Date32 или DateTime64 для аргументов типа Date32 или DateTime64, а в остальных случаях — Date или DateTime.

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

Функция	`enable_extended_results_for_datetime_functions = 0`	`enable_extended_results_for_datetime_functions = 1`
`toStartOfYear`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfISOYear`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfQuarter`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfMonth`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` при вводе `Date`/`DateTime` Возвращает `Date32`/`DateTime64` при вводе `Date32`/`DateTime64`
`toStartOfWeek`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для аргументов `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для аргументов `Date32`/`DateTime64`
`toLastDayOfWeek`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toLastDayOfMonth`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toMonday`	Возвращает `Date` или `DateTime`	Возвращает `Date`/`DateTime` для входных значений `Date`/`DateTime` Возвращает `Date32`/`DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfDay`	Возвращает `DateTime` Note: Некорректные результаты для значений за пределами диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfHour`	Возвращает `DateTime` Note: Некорректные результаты для значений за пределами диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfFifteenMinutes`	Возвращает `DateTime` Note: Некорректные результаты для значений вне диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfTenMinutes`	Возвращает `DateTime` Примечание: неправильные результаты для значений вне диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfFiveMinutes`	Возвращает `DateTime` Note: Неверные результаты для значений вне диапазона 1970-2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`toStartOfMinute`	Возвращает `DateTime` Note: Некорректные результаты для значений вне диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`
`timeSlot`	Возвращает `DateTime` Примечание: неверные результаты для значений за пределами диапазона 1970–2149	Возвращает `DateTime` для входных значений `Date`/`DateTime` Возвращает `DateTime64` для входных значений `Date32`/`DateTime64`

enable_full_text_index

Псевдонимы: allow_experimental_full_text_index Если установлено значение true, разрешает использование текстового индекса.

enable_global_with_statement

Распространяет операторы WITH на запросы UNION и все подзапросы

enable_hdfs_pread

Включает или отключает использование pread для файлов HDFS. По умолчанию используется hdfsPread. Если параметр отключен, для чтения файлов HDFS используются hdfsRead и hdfsSeek.

enable_http_compression

Включает или отключает сжатие данных в ответе на HTTP-запрос. Дополнительные сведения см. в описании HTTP-интерфейса. Возможные значения:

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

enable_identifier_resolve_cache

Включает кэш разрешения идентификаторов в анализаторе запросов. Кэш повторно использует уже разрешённые узлы псевдонимов, чтобы предотвратить разрастание AST, когда на один и тот же псевдоним ссылаются несколько раз. Установите false, чтобы отключить кэширование, если есть подозрение на некорректные результаты.

enable_job_stack_trace

Выводит трассировку стека создателя задачи, если при выполнении задачи возникает исключение. По умолчанию отключён, чтобы избежать снижения производительности.

enable_lazy_columns_replication

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

enable_materialized_cte

Включает материализованные CTE; эта настройка имеет приоритет над enable_global_with_statement

enable_memory_bound_merging_of_aggregation_results

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

enable_multiple_prewhere_read_steps

Перемещает больше условий из WHERE в PREWHERE и выполняет чтение с диска и фильтрацию в несколько этапов, если есть несколько условий, объединённых оператором побитового И

enable_named_columns_in_function_tuple

Генерировать именованные Tuple в функции tuple(), если все имена уникальны и могут использоваться как идентификаторы без кавычек.

enable_order_by_all

Включает или отключает сортировку с использованием синтаксиса ORDER BY ALL, см. ORDER BY. Возможные значения:

0 — Отключает ORDER BY ALL.
1 — Включает ORDER BY ALL.

Пример Запрос:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

Результат:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴────┴─────┘

enable_parallel_blocks_marshalling

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

enable_parsing_to_custom_serialization

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

enable_producing_buckets_out_of_order_in_aggregation

Разрешает агрегированию с эффективным использованием памяти (см. distributed_aggregation_memory_efficient) выдавать бакеты не по порядку. Это может повысить производительность при неравномерном распределении размеров бакетов, так как реплика может отправлять инициатору бакеты с более высокими идентификаторами, пока ещё обрабатывает тяжёлые бакеты с более низкими идентификаторами. Недостаток — потенциально более высокое использование памяти.

enable_reads_from_query_cache

Если параметр включен, результаты SELECT-запросов берутся из кэша запросов. Возможные значения:

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

enable_s3_requests_logging

Включает максимально подробное логирование запросов к S3. Имеет смысл только для отладки.

enable_scalar_subquery_optimization

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

enable_scopes_for_with_statement

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

enable_sharding_aggregator

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

0 — Оптимизация сегментированной агрегации отключена.
1 — Оптимизация сегментированной агрегации включена.

enable_shared_storage_snapshot_in_query

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

SELECT
    count()
FROM events
WHERE (_part, _part_offset) IN (
    SELECT _part, _part_offset
    FROM events
    WHERE user_id = 42
)

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

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

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

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

enable_sharing_sets_for_mutations

Разрешает совместно использовать объекты Set, созданные для подзапросов IN, в разных задачах одной мутации. Это снижает использование памяти и потребление CPU

enable_streaming_queries

Разрешает непрерывные запросы SELECT ... FROM t STREAM [CURSOR '{...}']. Если настройка отключена, любое табличное выражение, использующее модификатор STREAM, отклоняется на этапе построения плана выполнения. Это основной переключатель для возможности стриминг-запросов; дополнительные возможности могут управляться собственными настройками.

enable_time_time64_type

Псевдонимы: allow_experimental_time_time64_type Позволяет создавать типы данных Time и Time64.

enable_unaligned_array_join

Разрешает ARRAY JOIN с несколькими массивами разной длины. Когда этот параметр включен, массивы будут приведены к длине самого длинного.

enable_url_encoding

Позволяет включать и отключать декодирование/кодирование пути в URI в таблицах с движком URL. По умолчанию отключено.

enable_vertical_final

Если включено, во время FINAL дублирующиеся строки удаляются путём пометки строк как удалённых и их последующей фильтрации вместо слияния строк

enable_writes_to_query_cache

Если параметр включен, результаты запросов SELECT сохраняются в кэше запросов. Возможные значения:

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

​enable_adaptive_memory_spill_scheduler

​enable_add_distinct_to_in_subqueries

​enable_automatic_decision_for_merging_across_partitions_for_final

​enable_early_constant_folding

​enable_extended_results_for_datetime_functions

​enable_full_text_index

​enable_global_with_statement

​enable_hdfs_pread

​enable_http_compression

​enable_identifier_resolve_cache

​enable_job_stack_trace

​enable_lazy_columns_replication

​enable_materialized_cte

​enable_memory_bound_merging_of_aggregation_results

​enable_multiple_prewhere_read_steps

​enable_named_columns_in_function_tuple

​enable_order_by_all

​enable_parallel_blocks_marshalling

​enable_parsing_to_custom_serialization

​enable_producing_buckets_out_of_order_in_aggregation

​enable_reads_from_query_cache

​enable_s3_requests_logging

​enable_scalar_subquery_optimization

​enable_scopes_for_with_statement

​enable_sharding_aggregator

​enable_shared_storage_snapshot_in_query

​enable_sharing_sets_for_mutations

​enable_streaming_queries

​enable_time_time64_type

​enable_unaligned_array_join

​enable_url_encoding

​enable_vertical_final

​enable_writes_to_query_cache