Перейти к основному содержимому
Перейти к основному содержимому

Настройки сессии

Все нижеуказанные настройки также доступны в таблице system.settings. Эти настройки автогенерируются из источника.

add_http_cors_header​

ТипПо умолчанию
Bool0

Добавить заголовок http CORS.

additional_result_filter​

Дополнительное выражение фильтра для применения к результату запроса SELECT. Эта настройка не применяется к любому подзапросу.

Пример

additional_table_filters​

ТипПо умолчанию
Map{}

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

Пример

aggregate_functions_null_for_empty​

ТипПо умолчанию
Bool0

Включает или отключает переписывание всех агрегатных функций в запросе, добавляя суффикс -OrNull к ним. Включите его для совместимости со стандартом SQL. Это реализовано через переписывание запроса (аналогично настройке count_distinct_implementation), чтобы получить согласованные результаты для распределенных запросов.

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

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

Пример

Рассмотрим следующий запрос с агрегатными функциями:

С aggregate_functions_null_for_empty = 0 он даст:

С aggregate_functions_null_for_empty = 1 результат будет:

aggregation_in_order_max_block_bytes​

ТипПо умолчанию
UInt6450000000

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

aggregation_memory_efficient_merge_threads​

ТипПо умолчанию
UInt640

Количество потоков для объединения промежуточных результатов агрегации в режиме эффективного использования памяти. При увеличении потребляется больше памяти. 0 означает - то же самое, что и 'max_threads'.

allow_aggregate_partitions_independently​

ТипПо умолчанию
Bool0

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

allow_archive_path_syntax​

Experimental feature. Learn more.
ТипПо умолчанию
Bool1

Движки/файлы S3 будут разбирать пути с '::' как <archive> :: <file>\ если архив имеет правильное расширение.

allow_asynchronous_read_from_io_pool_for_merge_tree​

ТипПо умолчанию
Bool0

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

allow_changing_replica_until_first_data_packet​

ТипПо умолчанию
Bool0

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

allow_create_index_without_type​

ТипПо умолчанию
Bool0

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

allow_custom_error_code_in_throwif​

ТипПо умолчанию
Bool0

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

allow_ddl​

ТипПо умолчанию
Bool1

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

allow_deprecated_database_ordinary​

ТипПо умолчанию
Bool0

Разрешить создание баз данных со устаревшим обычным движком.

allow_deprecated_error_prone_window_functions​

ТипПо умолчанию
Bool0

Разрешить использование устаревших потенциально ошибочных оконных функций (neighbor, runningAccumulate, runningDifferenceStartingWithFirstValue, runningDifference).

allow_deprecated_snowflake_conversion_functions​

ТипПо умолчанию
Bool0

Функции snowflakeToDateTime, snowflakeToDateTime64, dateTimeToSnowflake и dateTime64ToSnowflake устарели и выключены по умолчанию. Пожалуйста, используйте функции snowflakeIDToDateTime, snowflakeIDToDateTime64, dateTimeToSnowflakeID и dateTime64ToSnowflakeID вместо этого.

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

allow_deprecated_syntax_for_merge_tree​

ТипПо умолчанию
Bool0

Разрешить создание *MergeTree таблиц с устаревшим синтаксисом определения движка.

allow_distributed_ddl​

ТипПо умолчанию
Bool1

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

allow_drop_detached​

ТипПо умолчанию
Bool0

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

allow_execute_multiif_columnar​

ТипПо умолчанию
Bool1

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

allow_experimental_analyzer​

ТипПо умолчанию
Bool1

Разрешить новый анализатор запросов.

allow_experimental_codecs​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

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

allow_experimental_database_glue_catalog​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить экспериментальный движок базы данных DataLakeCatalog с catalog_type = 'glue'.

allow_experimental_database_iceberg​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить экспериментальный движок базы данных DataLakeCatalog с catalog_type = 'iceberg'.

allow_experimental_database_materialized_postgresql​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить создание базы данных с Engine=MaterializedPostgreSQL(...).

allow_experimental_database_unity_catalog​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить экспериментальный движок базы данных DataLakeCatalog с catalog_type = 'unity'.

allow_experimental_dynamic_type​

ТипПо умолчанию
Bool1

Разрешает создание типа данных Dynamic.

allow_experimental_full_text_index​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Если установлено в true, разрешить использовать экспериментальный полнотекстовый индекс.

allow_experimental_funnel_functions​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

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

allow_experimental_hash_functions​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Включить экспериментальные хеш-функции.

allow_experimental_inverted_index​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Если установлено в true, разрешить использовать экспериментальный обратный индекс.

allow_experimental_join_condition​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Поддержка соединения с неравенствующими условиями, которые включают столбцы как из левой, так и из правой таблицы. Например, t1.y < t2.y.

allow_experimental_join_right_table_sorting​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Если установлено в true и выполнены условия join_to_sort_minimum_perkey_rows и join_to_sort_maximum_table_rows, перенастройте правую таблицу по ключу для повышения производительности в левом или внутреннем хеш-соединении.

allow_experimental_json_type​

ТипПо умолчанию
Bool1

Разрешает создание типа данных JSON.

allow_experimental_kafka_offsets_storage_in_keeper​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

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

allow_experimental_kusto_dialect​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Включить язык запросов Kusto (KQL) - альтернативу SQL.

allow_experimental_live_view​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешает создание устаревшего LIVE VIEW.

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

  • 0 — Работа с живыми представлениями отключена.
  • 1 — Работа с живыми представлениями включена.

allow_experimental_materialized_postgresql_table​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

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

allow_experimental_nlp_functions​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

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

allow_experimental_object_type​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить устаревший тип данных Object.

allow_experimental_parallel_reading_from_replicas​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Использовать до max_parallel_replicas количество реплик из каждой шард для выполнения запроса SELECT. Чтение будет параллелизовано и координировано динамически. 0 - отключено, 1 - включено, молча отключить в случае сбоя, 2 - включено, выбросить исключение в случае сбоя.

allow_experimental_prql_dialect​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Включить PRQL - альтернативу SQL.

allow_experimental_query_deduplication​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Экспериментальная дедупликация данных для запросов SELECT на основе UUID частей.

allow_experimental_shared_set_join​

Experimental feature. Learn more.
ClickHouse Cloud only
ТипПо умолчанию
Bool1

Влияет только на ClickHouse Cloud. Разрешить создание ShareSet и SharedJoin.

allow_experimental_statistics​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Позволяет определять столбцы со статистикой и манипулировать статистикой.

allow_experimental_time_series_table​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешает создание таблиц с использованием движка таблицы TimeSeries.

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

  • 0 — движок таблицы TimeSeries отключен.
  • 1 — движок таблицы TimeSeries включен.

allow_experimental_ts_to_grid_aggregate_function​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Экспериментальная агрегатная функция tsToGrid для повторной выборки временных рядов, похожих на Prometheus. Только для Cloud.

allow_experimental_variant_type​

ТипПо умолчанию
Bool1

Разрешает создание типа данных Variant.

allow_experimental_vector_similarity_index​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешить экспериментальный индекс векторного сходства.

allow_experimental_window_view​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Включить WINDOW VIEW. Недостаточно зрелый.

allow_general_join_planning​

ТипПо умолчанию
Bool1

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

allow_get_client_http_header​

ТипПо умолчанию
Bool0

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

allow_hyperscan​

ТипПо умолчанию
Bool1

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

allow_introspection_functions​

ТипПо умолчанию
Bool0

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

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

  • 1 — Функции интроспекции включены.
  • 0 — Функции интроспекции отключены.

Смотрите также

allow_materialized_view_with_bad_select​

ТипПо умолчанию
Bool0

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

allow_named_collection_override_by_default​

ТипПо умолчанию
Bool1

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

allow_non_metadata_alters​

ТипПо умолчанию
Bool1

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

allow_nonconst_timezone_arguments​

ТипПо умолчанию
Bool0

Разрешить не константные аргументы часового пояса в некоторых функциях, связанных со временем, таких как toTimeZone(), fromUnixTimestamp*(), snowflakeToDateTime*().

allow_nondeterministic_mutations​

ТипПо умолчанию
Bool0

Пользовательская настройка, которая позволяет мутациям в реплицированных таблицах использовать недетерминированные функции, такие как dictGet.

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

Пример

allow_nondeterministic_optimize_skip_unused_shards​

ТипПо умолчанию
Bool0

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

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

  • 0 — Запрещено.
  • 1 — Разрешено.

allow_not_comparable_types_in_comparison_functions​

ТипПо умолчанию
Bool0

Разрешает или ограничивает использование несравнимых типов (таких как JSON/Object/AggregateFunction) в функциях сравнения equal/less/greater/etc.

allow_not_comparable_types_in_order_by​

ТипПо умолчанию
Bool0

Разрешает или ограничивает использование несравнимых типов (таких как JSON/Object/AggregateFunction) в ключах ORDER BY.

allow_prefetched_read_pool_for_local_filesystem​

ТипПо умолчанию
Bool0

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

allow_prefetched_read_pool_for_remote_filesystem​

ТипПо умолчанию
Bool1

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

allow_push_predicate_ast_for_distributed_subqueries​

ТипПо умолчанию
Bool1

Разрешает продвигать предикат на уровне AST для распределенных подзапросов с включенным анализатором.

allow_push_predicate_when_subquery_contains_with​

ТипПо умолчанию
Bool1

Разрешает продвигать предикат, когда подзапрос содержит WITH клаузу.

allow_reorder_prewhere_conditions​

ТипПо умолчанию
Bool1

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

allow_settings_after_format_in_insert​

ТипПо умолчанию
Bool0

Контролирует, разрешены ли SETTINGS после FORMAT в запросах INSERT. Рекомендуется не использовать это, так как это может интерпретировать часть SETTINGS как значения.

Пример:

Но следующий запрос будет работать только с allow_settings_after_format_in_insert:

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

  • 0 — Запрещено.
  • 1 — Разрешено.
примечание

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

allow_simdjson​

ТипПо умолчанию
Bool1

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

allow_statistics_optimize​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Разрешает использование статистики для оптимизации запросов.

allow_suspicious_codecs​

ТипПо умолчанию
Bool0

Если установлено в true, разрешить указание бессмысленных кодеков сжатия.

allow_suspicious_fixed_string_types​

ТипПо умолчанию
Bool0

В команде CREATE TABLE разрешает создание столбцов типа FixedString(n) с n > 256. FixedString с длиной >= 256 является подозрительным и, скорее всего, указывает на неправильное использование.

allow_suspicious_indices​

ТипПо умолчанию
Bool0

Отклонить первичные/вторичные индексы и ключи сортировки с идентичными выражениями.

allow_suspicious_low_cardinality_types​

ТипПо умолчанию
Bool0

Разрешает или ограничивает использование LowCardinality с типами данных с фиксированным размером 8 байт или меньше: числовые типы данных и FixedString(8_bytes_or_less).

Для небольших фиксированных значений использование LowCardinality обычно неэффективно, поскольку ClickHouse хранит числовой индекс для каждой строки. В результате:

  • Использование дискового пространства может увеличиваться.
  • Потребление оперативной памяти может быть выше, в зависимости от размера словаря.
  • Некоторые функции могут работать медленнее из-за дополнительных операций кодирования/декодирования.

Время слияния в таблицах с движками MergeTree может увеличиваться по всем вышеописанным причинам.

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

  • 1 — Использование LowCardinality не ограничено.
  • 0 — Использование LowCardinality ограничено.

allow_suspicious_primary_key​

ТипПо умолчанию
Bool0

Разрешить подозрительные PRIMARY KEY/ORDER BY для MergeTree (т.е. SimpleAggregateFunction).

allow_suspicious_ttl_expressions​

ТипПо умолчанию
Bool0

Отклонить выражения TTL, которые не зависят от каких-либо столбцов таблицы. Это почти всегда указывает на ошибку пользователя.

allow_suspicious_types_in_group_by​

ТипПо умолчанию
Bool0

Разрешает или ограничивает использование типов Variant и Dynamic в ключах GROUP BY.

allow_suspicious_types_in_order_by​

ТипПо умолчанию
Bool0

Разрешает или ограничивает использование типов Variant и Dynamic в ключах ORDER BY.

allow_suspicious_variant_types​

ТипПо умолчанию
Bool0

В команде CREATE TABLE позволяет указать тип Variant с похожими вариантными типами (например, с различными числовыми или датированными типами). Включение этой настройки может ввести некоторую неопределенность при работе со значениями с похожими типами.

allow_unrestricted_reads_from_keeper​

ТипПо умолчанию
Bool0

Разрешить неограниченные (без условия на путь) чтения из системной таблицы zookeeper, может быть полезно, но не безопасно для zookeeper.

alter_move_to_space_execute_async​

ТипПо умолчанию
Bool0

Выполнять ALTER TABLE MOVE ... TO [DISK|VOLUME] асинхронно.

alter_partition_verbose_result​

ТипПо умолчанию
Bool0

Включает или отключает отображение информации о частях, к которым успешно применены операции с партициями и частями. Применимо к ATTACH PARTITION|PART и к FREEZE PARTITION.

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

  • 0 — отключить подробность.
  • 1 — включить подробность.

Пример

alter_sync​

ТипПо умолчанию
UInt641

Позволяет настроить ожидание выполнения действий на репликах в результатах ALTER, OPTIMIZE или TRUNCATE.

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

  • 0 — Не ждать.
  • 1 — Ждать своей реализации.
  • 2 — Ждать всех.

Cloud значение по умолчанию: 0.

примечание

alter_sync применяется только к Replicated таблицам, он ничего не делает для изменений не Replicated таблиц.

analyze_index_with_space_filling_curves​

ТипПо умолчанию
Bool1

Если у таблицы есть заполняющая кривую в своем индексе, например, ORDER BY mortonEncode(x, y) или ORDER BY hilbertEncode(x, y), и в запросе есть условия на его аргументы, например, x >= 10 AND x <= 20 AND y >= 20 AND y <= 30, используйте заполняющую кривую для анализа индекса.

analyzer_compatibility_join_using_top_level_identifier​

ТипПо умолчанию
Bool0

Заставляет решать идентификатор в JOIN USING из проекции (например, в SELECT a + 1 AS b FROM t1 JOIN t2 USING (b) соединение будет выполнено по t1.a + 1 = t2.b, а не по t1.b = t2.b).

any_join_distinct_right_table_keys​

ТипПо умолчанию
Bool0

Включает наследуемое поведение сервера ClickHouse в операциях ANY INNER|LEFT JOIN.

примечание

Используйте эту настройку только для обратной совместимости, если ваши случаи использования зависят от наследуемого поведения JOIN.

Когда включено наследуемое поведение:

  • Результаты операций t1 ANY LEFT JOIN t2 и t2 ANY RIGHT JOIN t1 не равны, потому что ClickHouse использует логику с множественным отображением ключей с левой на правую таблицу.
  • Результаты операций ANY INNER JOIN содержат все строки из левой таблицы, как операции SEMI LEFT JOIN.

Когда наследуемое поведение отключено:

  • Результаты операций t1 ANY LEFT JOIN t2 и t2 ANY RIGHT JOIN t1 равны, потому что ClickHouse использует логику, обеспечивающую одно-ко-многим отображение ключей в операциях ANY RIGHT JOIN.
  • Результаты операций ANY INNER JOIN содержат одну строку на ключ из обеих левых и правых таблиц.

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

  • 0 — Наследуемое поведение отключено.
  • 1 — Наследуемое поведение включено.

Смотрите также:

apply_deleted_mask​

ТипПо умолчанию
Bool1

Включает фильтрацию строк, удаленных с помощью легковесного DELETE. Если отключено, запрос сможет прочитать эти строки. Это полезно для отладки и сценариев "восстановления".

apply_mutations_on_fly​

ТипПо умолчанию
Bool0

Если да, мутации (UPDATE и DELETE), которые не материализованы в части данных, будут применяться при SELECT.

apply_settings_from_server​

ТипПо умолчанию
Bool1

Должен ли клиент принимать настройки от сервера.

Это затрагивает только операции, выполняемые на стороне клиента, в частности, парсинг входных данных INSERT и форматирование результата запроса. Большинство выполнения запроса происходит на сервере и не затрагивается этой настройкой.

Обычно эта настройка устанавливается в профиле пользователя (users.xml или запросы, такие как ALTER USER), а не через клиент (аргументы командной строки клиента, запрос SET или секция SETTINGS запроса SELECT). Через клиент ее можно изменить на false, но не можно изменить на true (поскольку сервер не отправит настройки, если профиль пользователя имеет apply_settings_from_server = false).

Обратите внимание, что изначально (24.12) была серверная настройка (send_settings_to_client), но позднее она была заменена этой клиентской настройкой для лучшей удобочитаемости.

asterisk_include_alias_columns​

ТипПо умолчанию
Bool0

Включить ALIAS столбцы для запросов с подстановочными знаками (SELECT *).

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

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

asterisk_include_materialized_columns​

ТипПо умолчанию
Bool0

Включите MATERIALIZED колонки для запроса с подстановочным знаком (SELECT *).

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

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

async_insert​

ТипПо умолчанию
Bool0

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

async_insert_busy_timeout_decrease_rate​

ТипПо умолчанию
Double0.2

Экспоненциальная скорость роста, с которой уменьшается адаптивный таймаут асинхронной вставки.

async_insert_busy_timeout_increase_rate​

ТипПо умолчанию
Double0.2

Экспоненциальная скорость роста, с которой увеличивается адаптивный таймаут асинхронной вставки.

async_insert_busy_timeout_max_ms​

ТипПо умолчанию
Milliseconds200

Максимальное время ожидания перед сбросом собранных данных за запрос с момента появления первых данных.

async_insert_busy_timeout_min_ms​

ТипПо умолчанию
Milliseconds50

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

async_insert_deduplicate​

ТипПо умолчанию
Bool0

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

async_insert_max_data_size​

ТипПо умолчанию
UInt6410485760

Максимальный размер в байтах неподобранных данных, собранных за запрос перед вставкой.

async_insert_max_query_number​

ТипПо умолчанию
UInt64450

Максимальное количество запросов на вставку перед вставкой.

async_insert_poll_timeout_ms​

ТипПо умолчанию
Milliseconds10

Таймаут для опроса данных из очереди асинхронной вставки.

async_insert_use_adaptive_busy_timeout​

ТипПо умолчанию
Bool1

Если установлено в true, использовать адаптивный таймаут при асинхронных вставках.

async_query_sending_for_remote​

ТипПо умолчанию
Bool1

Включает создание асинхронных соединений и отправку запросов при выполнении удаленного запроса.

Включено по умолчанию.

async_socket_for_remote​

ТипПо умолчанию
Bool1

Включает асинхронное чтение из сокета при выполнении удаленного запроса.

Включено по умолчанию.

azure_allow_parallel_part_upload​

ТипПо умолчанию
Bool1

Используйте несколько потоков для загрузки нескольких частей в Azure.

azure_check_objects_after_upload​

ТипПо умолчанию
Bool0

Проверьте каждый загруженный объект в хранилище блобов Azure, чтобы убедиться, что загрузка прошла успешно.

azure_create_new_file_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает создание нового файла при каждой вставке в таблицы Azure engine.

azure_ignore_file_doesnt_exist​

ТипПо умолчанию
Bool0

Игнорировать отсутствие файла, если он не существует, при чтении определенных ключей.

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

  • 1 — SELECT возвращает пустой результат.
  • 0 — SELECT вызывает исключение.

azure_list_object_keys_size​

ТипПо умолчанию
UInt641000

Максимальное количество файлов, которые могут быть возвращены в пакетном запросе ListObject.

azure_max_blocks_in_multipart_upload​

ТипПо умолчанию
UInt6450000

Максимальное количество блоков в загрузке нескольких частей для Azure.

azure_max_inflight_parts_for_one_file​

ТипПо умолчанию
UInt6420

Максимальное количество одновременно загружаемых частей в запросе на загрузку нескольких частей. 0 означает неограниченное.

azure_max_single_part_copy_size​

ТипПо умолчанию
UInt64268435456

Максимальный размер объекта для копирования с использованием копирования одной части в хранилище блобов Azure.

azure_max_single_part_upload_size​

ТипПо умолчанию
UInt64104857600

Максимальный размер объекта для загрузки с использованием загрузки одной части в хранилище блобов Azure.

azure_max_single_read_retries​

ТипПо умолчанию
UInt644

Максимальное количество повторных попыток во время чтения из хранилища блобов Azure.

azure_max_unexpected_write_error_retries​

ТипПо умолчанию
UInt644

Максимальное количество повторных попыток в случае неожиданных ошибок при записи в хранилище блобов Azure.

azure_max_upload_part_size​

ТипПо умолчанию
UInt645368709120

Максимальный размер части для загрузки при загрузке нескольких частей в хранилище блобов Azure.

azure_min_upload_part_size​

ТипПо умолчанию
UInt6416777216

Минимальный размер части для загрузки при загрузке нескольких частей в хранилище блобов Azure.

azure_sdk_max_retries​

ТипПо умолчанию
UInt6410

Максимальное количество повторных попыток в Azure SDK.

azure_sdk_retry_initial_backoff_ms​

ТипПо умолчанию
UInt6410

Минимальное время ожидания между повторными попытками в Azure SDK.

azure_sdk_retry_max_backoff_ms​

ТипПо умолчанию
UInt641000

Максимальное время ожидания между повторными попытками в Azure SDK.

azure_skip_empty_files​

ТипПо умолчанию
Bool0

Включает или отключает пропуск пустых файлов в движке S3.

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

  • 0 — SELECT вызывает исключение, если пустой файл не совместим с запрашиваемым форматом.
  • 1 — SELECT возвращает пустой результат для пустого файла.

azure_strict_upload_part_size​

ТипПо умолчанию
UInt640

Точный размер части для загрузки при загрузке нескольких частей в хранилище блобов Azure.

azure_throw_on_zero_files_match​

ТипПо умолчанию
Bool0

Выдавать ошибку, если соответствуют нулю файлов в соответствии с правилами расширения glob.

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

  • 1 — SELECT вызывает исключение.
  • 0 — SELECT возвращает пустой результат.

azure_truncate_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает обрезку перед вставкой в таблицы Azure engine.

azure_upload_part_size_multiply_factor​

ТипПо умолчанию
UInt642

Умножьте azure_min_upload_part_size на этот коэффициент каждый раз, когда azure_multiply_parts_count_threshold части были загружены из одной записи в хранилище блобов Azure.

azure_upload_part_size_multiply_parts_count_threshold​

ТипПо умолчанию
UInt64500

Каждый раз, когда это количество частей загружается в хранилище блобов Azure, azure_min_upload_part_size умножается на azure_upload_part_size_multiply_factor.

backup_restore_batch_size_for_keeper_multi​

ТипПо умолчанию
UInt641000

Максимальный размер партии для много запросов к [Zoo]Keeper во время резервного копирования или восстановления.

backup_restore_batch_size_for_keeper_multiread​

ТипПо умолчанию
UInt6410000

Максимальный размер партии для многочтений запроса к [Zoo]Keeper во время резервного копирования или восстановления.

backup_restore_failure_after_host_disconnected_for_seconds​

ТипПо умолчанию
UInt643600

Если хост во время операции BACKUP ON CLUSTER или RESTORE ON CLUSTER не восстанавливает свой эпhemerный узел 'alive' в ZooKeeper в течение этого времени, то вся операция резервного копирования или восстановления считается неудачной. Это значение должно быть больше любого разумного времени для хоста, чтобы повторно подключиться к ZooKeeper после сбоя. Ноль означает неограниченное.

backup_restore_finish_timeout_after_error_sec​

ТипПо умолчанию
UInt64180

Как долго инициатор должен ждать, чтобы другие хосты отреагировали на узел 'error' и остановили свою работу над текущей операцией BACKUP ON CLUSTER или RESTORE ON CLUSTER.

backup_restore_keeper_fault_injection_probability​

ТипПо умолчанию
Float0

Приблизительная вероятность сбоя для запроса Keeper во время резервного копирования или восстановления. Допустимое значение находится в интервале [0.0f, 1.0f].

backup_restore_keeper_fault_injection_seed​

ТипПо умолчанию
UInt640

0 - случайное начальное значение, иначе значение настройки.

backup_restore_keeper_max_retries​

ТипПо умолчанию
UInt641000

Максимальное количество повторных попыток для операций с [Zoo]Keeper в процессе операции BACKUP или RESTORE. Должно быть достаточно большим, чтобы вся операция не завершилась неудачей из-за временной ошибки [Zoo]Keeper.

backup_restore_keeper_max_retries_while_handling_error​

ТипПо умолчанию
UInt6420

Максимальное количество повторных попыток для операций с [Zoo]Keeper во время обработки ошибки операции BACKUP ON CLUSTER или RESTORE ON CLUSTER.

backup_restore_keeper_max_retries_while_initializing​

ТипПо умолчанию
UInt6420

Максимальное количество повторных попыток для операций с [Zoo]Keeper во время инициализации операции BACKUP ON CLUSTER или RESTORE ON CLUSTER.

backup_restore_keeper_retry_initial_backoff_ms​

ТипПо умолчанию
UInt64100

Начальный таймаут ожидания для операций с [Zoo]Keeper во время резервного копирования или восстановления.

backup_restore_keeper_retry_max_backoff_ms​

ТипПо умолчанию
UInt645000

Максимальный таймаут ожидания для операций с [Zoo]Keeper во время резервного копирования или восстановления.

backup_restore_keeper_value_max_size​

ТипПо умолчанию
UInt641048576

Максимальный размер данных узла [Zoo]Keeper во время резервного копирования.

backup_restore_s3_retry_attempts​

ТипПо умолчанию
UInt641000

Настройка для Aws::Client::RetryStrategy, Aws::Client выполняет повторные попытки сам, 0 означает отсутствие повторных попыток. Это происходит только для резервного копирования/восстановления.

cache_warmer_threads​

ClickHouse Cloud only
ТипПо умолчанию
UInt644

Имеет эффект только в ClickHouse Cloud. Количество фоновых потоков для спекулятивной загрузки новых частей данных в кеш файла, когда cache_populated_by_fetch включен. Ноль для отключения.

calculate_text_stack_trace​

ТипПо умолчанию
Bool1

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

cancel_http_readonly_queries_on_client_close​

ТипПо умолчанию
Bool0

Отменяет HTTP-запросы только для чтения (например, SELECT), когда клиент закрывает соединение, не дожидаясь ответа.

Значение по умолчанию в облаке: 1.

cast_ipv4_ipv6_default_on_conversion_error​

ТипПо умолчанию
Bool0

Оператор CAST в IPv4, оператор CAST в IPV6, функции toIPv4, toIPv6 вернут значение по умолчанию вместо возникновения исключения при ошибке преобразования.

cast_keep_nullable​

ТипПо умолчанию
Bool0

Включает или отключает сохранение типа данных Nullable в операциях CAST.

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

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

  • 0 — Результат CAST имеет точно указанный целевой тип.
  • 1 — Если тип аргумента Nullable, результат CAST преобразуется в Nullable(ЦелевойТипДанных).

Примеры

Следующий запрос приводит к получению результата с точно указанным целевым типом:

Результат:

Следующий запрос приводит к модификации типа в Nullable:

Результат:

См. также

  • CAST функция.

cast_string_to_dynamic_use_inference​

ТипПо умолчанию
Bool0

Использовать вывод типов при преобразовании строки в динамический.

check_query_single_value_result​

ТипПо умолчанию
Bool1

Определяет уровень детализации результата запроса CHECK TABLE для движков семейства MergeTree.

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

  • 0 — запрос показывает статус проверки для каждой отдельной части данных таблицы.
  • 1 — запрос показывает общий статус проверки таблицы.

check_referential_table_dependencies​

ТипПо умолчанию
Bool0

Проверяет, что запрос DDL (например, DROP TABLE или RENAME) не нарушит референциальные зависимости.

check_table_dependencies​

ТипПо умолчанию
Bool1

Проверяет, что запрос DDL (например, DROP TABLE или RENAME) не нарушит зависимости.

checksum_on_read​

ТипПо умолчанию
Bool1

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

cloud_mode​

ТипПо умолчанию
Bool0

Облачный режим.

cloud_mode_database_engine​

ТипПо умолчанию
UInt641

Движок базы данных, разрешенный в облаке. 1 - переписать DDL для использования реплицированной базы данных, 2 - переписать DDL для использования совместной базы данных.

cloud_mode_engine​

ТипПо умолчанию
UInt641

Семейство движков, разрешенных в облаке.

  • 0 - разрешить все
  • 1 - переписать DDL для использования *ReplicatedMergeTree
  • 2 - переписать DDL для использования SharedMergeTree
  • 3 - переписать DDL для использования SharedMergeTree, кроме случаев, когда явно указан удаленный диск

UInt64 для минимизации публичной части.

cluster_for_parallel_replicas​

Beta feature. Learn more.

Кластер для шардов, в котором находится текущий сервер.

collect_hash_table_stats_during_aggregation​

ТипПо умолчанию
Bool1

Включает сбор статистики хеш-таблицы для оптимизации распределения памяти.

collect_hash_table_stats_during_joins​

ТипПо умолчанию
Bool1

Включает сбор статистики хеш-таблицы для оптимизации распределения памяти.

compatibility​

Настройка compatibility заставляет ClickHouse использовать настройки по умолчанию предыдущей версии ClickHouse, где предыдущая версия указывается как настройка.

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

Эта настройка принимает номер версии ClickHouse в виде строки, например, 22.3, 22.8. Пустое значение означает, что эта настройка отключена.

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

примечание

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

compatibility_ignore_auto_increment_in_create_table​

ТипПо умолчанию
Bool0

Игнорировать ключевое слово AUTO_INCREMENT в объявлении колонки, если true, иначе вернуть ошибку. Упрощает миграцию с MySQL.

compatibility_ignore_collation_in_create_table​

ТипПо умолчанию
Bool1

Совместимость игнорирует сортировку при создании таблицы.

compile_aggregate_expressions​

ТипПо умолчанию
Bool1

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

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

  • 0 — Агрегация осуществляется без JIT-компиляции.
  • 1 — Агрегация осуществляется с JIT-компиляцией.

См. Также

compile_expressions​

ТипПо умолчанию
Bool0

Компилировать некоторые скалярные функции и операторы в нативный код. Из-за ошибки в инфраструктуре компилятора LLVM на машинах AArch64 известно, что это может привести к разыменованию nullptr и, следовательно, к сбою сервера. Не включайте эту настройку.

compile_sort_description​

ТипПо умолчанию
Bool1

Компилировать описание сортировки в нативный код.

connect_timeout​

ТипПо умолчанию
Seconds10

Таймаут подключения, если реплики отсутствуют.

connect_timeout_with_failover_ms​

ТипПо умолчанию
Milliseconds1000

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

connect_timeout_with_failover_secure_ms​

ТипПо умолчанию
Milliseconds1000

Таймаут подключения для выбора первой здоровой реплики (для защищенных соединений).

connection_pool_max_wait_ms​

ТипПо умолчанию
Milliseconds0

Время ожидания в миллисекундах для подключения, когда пул подключений полон.

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

  • Положительное целое число.
  • 0 — Неограниченный таймаут.

connections_with_failover_max_tries​

ТипПо умолчанию
UInt643

Максимальное количество попыток подключения к каждой реплике для распределенного движка таблиц.

convert_query_to_cnf​

ТипПо умолчанию
Bool0

При установке в true запрос SELECT будет преобразован в конъюнктивную нормальную форму (CNF). Есть сценарии, когда переписывание запроса в CNF может выполняться быстрее (просмотрите проблему на Github для объяснения).

Например, обратите внимание, что следующий запрос SELECT не модифицируется (поведение по умолчанию):

Результат:

Давайте установим convert_query_to_cnf в true и посмотрим, что изменится:

Обратите внимание, что условие WHERE переписывается в CNF, но результирующий набор одинаков - логика булевых выражений не изменилась:

Возможные значения: true, false.

count_distinct_implementation​

ТипПо умолчанию
StringuniqExact

Указывает, какая из функций uniq* должна использоваться для выполнения конструкции COUNT(DISTINCT ...).

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

count_distinct_optimization​

ТипПо умолчанию
Bool0

Переписывать count distinct в подзапрос группировки.

create_if_not_exists​

ТипПо умолчанию
Bool0

Включить IF NOT EXISTS для оператора CREATE по умолчанию. Если эта настройка или IF NOT EXISTS указаны, и таблица с указанным именем уже существует, исключение не будет выдано.

create_index_ignore_unique​

ТипПо умолчанию
Bool0

Игнорировать уникальные ключевые слова в CREATE UNIQUE INDEX. Сделано для тестов на совместимость SQL.

create_replicated_merge_tree_fault_injection_probability​

ТипПо умолчанию
Float0

Вероятность инъекции сбоя при создании таблицы после создания метаданных в ZooKeeper.

create_table_empty_primary_key_by_default​

ТипПо умолчанию
Bool0

Позволяет создавать таблицы *MergeTree с пустым первичным ключом, когда ORDER BY и PRIMARY KEY не указаны.

cross_join_min_bytes_to_compress​

ТипПо умолчанию
UInt641073741824

Минимальный размер блока для сжатия в CROSS JOIN. Нулевое значение означает - отключить этот порог. Этот блок сжимается, когда достигается любой из двух порогов (по строкам или по байтам).

cross_join_min_rows_to_compress​

ТипПо умолчанию
UInt6410000000

Минимальное количество строк для сжатия блока в CROSS JOIN. Нулевое значение означает - отключить этот порог. Этот блок сжимается, когда достигается любой из двух порогов (по строкам или по байтам).

data_type_default_nullable​

ТипПо умолчанию
Bool0

Позволяет типам данных без явных модификаторов NULL или NOT NULL в определении колонки быть Nullable.

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

  • 1 — Типы данных в определениях колонок по умолчанию устанавливаются в Nullable.
  • 0 — Типы данных в определениях колонок по умолчанию устанавливаются как не Nullable.

database_atomic_wait_for_drop_and_detach_synchronously​

ТипПо умолчанию
Bool0

Добавляет модификатор SYNC ко всем запросам DROP и DETACH.

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

  • 0 — Запросы выполняются с задержкой.
  • 1 — Запросы выполняются без задержки.

database_replicated_allow_explicit_uuid​

ТипПо умолчанию
UInt640

0 - Не разрешать явно указывать UUID для таблиц в реплицированных базах данных. 1 - Разрешить. 2 - Разрешить, но игнорировать указанный UUID и генерировать случайный взамен.

database_replicated_allow_heavy_create​

ТипПо умолчанию
Bool0

Разрешить выполнение долгосрочных DDL-запросов (CREATE AS SELECT и POPULATE) в реплицированном движке базы данных. Обратите внимание, что это может блокировать очередь DDL на длительное время.

database_replicated_allow_only_replicated_engine​

ТипПо умолчанию
Bool0

Разрешить создавать только реплицированные таблицы в базе данных с движком Replicated.

database_replicated_allow_replicated_engine_arguments​

ТипПо умолчанию
UInt640

0 - Не разрешать явно указывать путь ZooKeeper и имя реплики для таблиц *MergeTree в реплицированных базах данных. 1 - Разрешить. 2 - Разрешить, но игнорировать указанный путь и использовать вместо него путь по умолчанию. 3 - Разрешить и не записывать предупреждение в журнал.

database_replicated_always_detach_permanently​

ТипПо умолчанию
Bool0

Выполнять DETACH TABLE как DETACH TABLE PERMANENTLY, если движок базы данных Replicated.

database_replicated_enforce_synchronous_settings​

ТипПо умолчанию
Bool0

Принуждает синхронное ожидание для некоторых запросов (см. также database_atomic_wait_for_drop_and_detach_synchronously, mutations_sync, alter_sync). Не рекомендуется включать эти настройки.

database_replicated_initial_query_timeout_sec​

ТипПо умолчанию
UInt64300

Устанавливает, как долго начальный DDL запрос должен ждать, пока реплицированная база данных обработает предыдущие записи очереди DDL в секундах.

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

  • Положительное целое число.
  • 0 — Неограниченно.

decimal_check_overflow​

ТипПо умолчанию
Bool1

Проверять переполнение при арфметических/сравнительных операциях с десятичными значениями.

deduplicate_blocks_in_dependent_materialized_views​

ТипПо умолчанию
Bool0

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

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

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

Использование

По умолчанию дедупликация не выполняется для материализованных представлений, а производится в источнике, в основной таблице. Если вставленный блок пропускается из-за дедупликации в основной таблице, то вставка в прикрепленные материализованные представления не произойдет. Это поведение существует, чтобы позволить вставку высоко агрегированных данных в материализованные представления, для случаев, когда вставленные блоки одинаковы после агрегации материализованного представления, но происходят из разных вставок в основную таблицу. В то же время это поведение "ломает" идемпотентность INSERT. Если вставка в основную таблицу прошла успешно, а вставка в материализованное представление не удалась (например, из-за сбоя связи с ClickHouse Keeper), клиент получит ошибку и может повторить операцию. Однако материализованное представление не получит вторую вставку, потому что она будет отброшена дедупликацией в основной (исходной) таблице. Настройка deduplicate_blocks_in_dependent_materialized_views позволяет изменить это поведение. При повторной попытке материализованное представление получит повторную вставку и проверит дедупликацию самостоятельно, игнорируя результат проверки для основной таблицы, и вставит строки, потерянные из-за первой ошибки.

default_materialized_view_sql_security​

ТипПо умолчанию
SQLSecurityTypeDEFINER

Позволяет установить значение по умолчанию для опции SQL SECURITY при создании материализованного представления. Дополнительная информация о SQL безопасности.

Значение по умолчанию: DEFINER.

default_max_bytes_in_join​

ТипПо умолчанию
UInt641000000000

Максимальный размер таблицы правой стороны, если ограничение требуется, но max_bytes_in_join не установлено.

default_normal_view_sql_security​

ТипПо умолчанию
SQLSecurityTypeINVOKER

Позволяет установить значение по умолчанию для опции SQL SECURITY при создании обычного представления. Дополнительная информация о SQL безопасности.

Значение по умолчанию: INVOKER.

default_table_engine​

ТипПо умолчанию
DefaultTableEngineMergeTree

Движок таблиц по умолчанию, используемый при отсутствии ENGINE в операторе CREATE.

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

  • строка, представляющая любое допустимое имя движка таблицы

Значение по умолчанию в облаке: SharedMergeTree.

Пример

Запрос:

Результат:

В этом примере любая новая таблица, которая не указывает Engine, будет использовать движок таблицы Log:

Запрос:

Результат:

default_temporary_table_engine​

ТипПо умолчанию
DefaultTableEngineMemory

То же, что и default_table_engine, но для временных таблиц.

В этом примере любая новая временная таблица, которая не указывает Engine, будет использовать движок таблицы Log:

Запрос:

Результат:

default_view_definer​

ТипПо умолчанию
StringCURRENT_USER

Позволяет установить значение по умолчанию для опции DEFINER при создании представления. Дополнительная информация о SQL безопасности.

Значение по умолчанию: CURRENT_USER.

describe_compact_output​

ТипПо умолчанию
Bool0

Если true, включает только имена колонок и типы в результат запроса DESCRIBE.

describe_extend_object_types​

ТипПо умолчанию
Bool0

Определяет конкретный тип столбцов типа Object в запросе DESCRIBE.

describe_include_subcolumns​

ТипПо умолчанию
Bool0

Включает описание субколонок для запроса DESCRIBE. Например, элементы Tuple или субколонки типа Map, Nullable или Array.

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

  • 0 — Субколонки не включены в запросы DESCRIBE.
  • 1 — Субколонки включены в запросы DESCRIBE.

Пример

Смотрите пример для оператора DESCRIBE.

describe_include_virtual_columns​

ТипПо умолчанию
Bool0

Если true, виртуальные колонки таблицы будут включены в результат запроса DESCRIBE.

dialect​

ТипПо умолчанию
Dialectclickhouse

Какой диалект будет использоваться для разбора запроса.

dictionary_validate_primary_key_type​

ТипПо умолчанию
Bool0

Проверяет тип первичного ключа для словарей. По умолчанию тип id для простых макетов будет неявно преобразован в UInt64.

distinct_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Определяет, что происходит, когда количество данных превышает один из лимитов.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как будто исходные данные закончились.

distributed_aggregation_memory_efficient​

ТипПо умолчанию
Bool1

Включен ли режим экономии памяти распределенной агрегации.

distributed_background_insert_batch​

ТипПо умолчанию
Bool0

Включает/выключает отправку вставленных данных пакетами.

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

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

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

distributed_background_insert_max_sleep_time_ms​

ТипПо умолчанию
Milliseconds30000

Максимальный интервал для движка таблиц Distributed для отправки данных. Ограничивает экспоненциальный рост интервала, установленного в настройке distributed_background_insert_sleep_time_ms.

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

  • Положительное целое число миллисекунд.

distributed_background_insert_sleep_time_ms​

ТипПо умолчанию
Milliseconds100

Базовый интервал для движка таблиц Distributed для отправки данных. Фактический интервал увеличивается экспоненциально в случае ошибок.

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

  • Положительное целое число миллисекунд.

distributed_background_insert_split_batch_on_failure​

ТипПо умолчанию
Bool0

Включает/выключает разделение пакетов при ошибках.

Иногда отправка конкретного пакета на удаленный шард может завершиться неудачей из-за сложного конвейера после (например, MATERIALIZED VIEW с GROUP BY) из-за Memory limit exceeded или подобных ошибок. В этом случае повторная попытка не поможет (и это заблокирует распределенные отправки для таблицы), но отправка файлов из этого пакета по одному может привести к успешной вставке.

Поэтому установка этой настройки в 1 отключит пакетирование для таких пакетов (например, временно отключит distributed_background_insert_batch для неудачных пакетов).

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

  • 1 — Включено.
  • 0 — Выключено.
примечание

Эта настройка также влияет на поврежденные пакеты (которые могут появиться из-за ненормального завершения работы сервера (машины) и отсутствия fsync_after_insert/fsync_directories для движка таблиц Distributed).

примечание

Не следует полагаться на автоматическое разделение пакетов, так как это может негативно сказаться на производительности.

distributed_background_insert_timeout​

ТипПо умолчанию
UInt640

Таймаут для запроса вставки в распределенный. Настройка используется только с включенным insert_distributed_sync. Нулевое значение означает отсутствие таймаута.

distributed_cache_bypass_connection_pool​

ClickHouse Cloud only
ТипПо умолчанию
Bool0

Имеет эффекты только в ClickHouse Cloud. Позволяет обойти пул соединений распределенного кэша.

distributed_cache_connect_max_tries​

ClickHouse Cloud only
ТипПо умолчанию
UInt6420

Имеет эффекты только в ClickHouse Cloud. Количество попыток подключения к распределенному кэшу в случае неудачи.

distributed_cache_data_packet_ack_window​

ClickHouse Cloud only
ТипПо умолчанию
UInt645

Имеет эффекты только в ClickHouse Cloud. Окно для отправки ACK для последовательности DataPacket в одном запросе чтения с распределенного кэша.

distributed_cache_discard_connection_if_unread_data​

ClickHouse Cloud only
ТипПо умолчанию
Bool1

Имеет эффекты только в ClickHouse Cloud. Отбросить соединение, если есть необработанные данные.

distributed_cache_fetch_metrics_only_from_current_az​

ClickHouse Cloud only
ТипПо умолчанию
Bool1

Имеет эффекты только в ClickHouse Cloud. Получать метрики только из текущей зоны доступности в system.distributed_cache_metrics, system.distributed_cache_events.

distributed_cache_log_mode​

ClickHouse Cloud only
ТипПо умолчанию
DistributedCacheLogModeon_error

Имеет эффекты только в ClickHouse Cloud. Режим записи в system.distributed_cache_log.

distributed_cache_max_unacked_inflight_packets​

ClickHouse Cloud only
ТипПо умолчанию
UInt6410

Имеет эффекты только в ClickHouse Cloud. Максимальное количество неподтвержденных в пути пакетов в одном запросе чтения с распределенного кэша.

distributed_cache_min_bytes_for_seek​

ClickHouse Cloud only
ТипПо умолчанию
UInt640

Имеет эффекты только в ClickHouse Cloud. Минимальное количество байт для осуществления поиска в распределенном кэше.

distributed_cache_pool_behaviour_on_limit​

ClickHouse Cloud only
ТипПо умолчанию
DistributedCachePoolBehaviourOnLimitwait

Имеет эффекты только в ClickHouse Cloud. Определяет поведение соединения кэширования при достижении лимита пула.

distributed_cache_read_alignment​

ClickHouse Cloud only
ТипПо умолчанию
UInt640

Имеет эффекты только в ClickHouse Cloud. Настройка для тестовых целей, не изменяйте ее.

distributed_cache_receive_response_wait_milliseconds​

ClickHouse Cloud only
ТипПо умолчанию
UInt6460000

Имеет эффекты только в ClickHouse Cloud. Время ожидания в миллисекундах для получения данных по запросу из распределенного кэша.

distributed_cache_receive_timeout_milliseconds​

ClickHouse Cloud only
ТипПо умолчанию
UInt6410000

Имеет эффекты только в ClickHouse Cloud. Время ожидания в миллисекундах для получения ответа любого вида из распределенного кэша.

distributed_cache_throw_on_error​

ClickHouse Cloud only
ТипПо умолчанию
Bool0

Имеет эффекты только в ClickHouse Cloud. Повторный выброс исключения, произошедшего во время общения с распределенным кэшем, или исключения, полученного от распределенного кэша. В противном случае возврат к пропуску распределенного кэша в случае ошибки.

distributed_cache_wait_connection_from_pool_milliseconds​

ClickHouse Cloud only
ТипПо умолчанию
UInt64100

Имеет эффекты только в ClickHouse Cloud. Время ожидания в миллисекундах для получения соединения из пула соединений, если distributed_cache_pool_behaviour_on_limit выставлен на wait.

distributed_connections_pool_size​

ТипПо умолчанию
UInt641024

Максимальное количество одновременно открытых соединений с удаленными серверами для распределенной обработки всех запросов к одной таблице Distributed. Рекомендуется устанавливать значение не ниже количества серверов в кластере.

distributed_ddl_entry_format_version​

ТипПо умолчанию
UInt645

Версия совместимости распределенных DDL (ON CLUSTER) запросов.

distributed_ddl_output_mode​

ТипПо умолчанию
DistributedDDLOutputModethrow

Устанавливает формат результата запроса распределенного DDL.

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

  • throw — Возвращает набор результатов с состоянием выполнения запроса для всех хостов, где запрос завершен. Если запрос не удался на некоторых хостах, будет повторно выброшено первое исключение. Если запрос не завершен еще на некоторых хостах и превышен distributed_ddl_task_timeout, будет выброшено исключение TIMEOUT_EXCEEDED.
  • none — Аналогично throw, но запрос распределенного DDL не возвращает набор результатов.
  • null_status_on_timeout — Возвращает NULL в качестве статуса выполнения в некоторых строках набора результатов вместо выброса TIMEOUT_EXCEEDED, если запрос не завершен на соответствующих хостах.
  • never_throw — Не выбрасывать TIMEOUT_EXCEEDED и не повторно выбрасывать исключения, если запрос не удался на некоторых хостах.
  • none_only_active - аналогично none, но не дожидается неактивных реплик базы данных Replicated. Примечание: с этим режимом невозможно понять, что запрос не был выполнен на некоторой реплике и будет выполнен в фоновом режиме.
  • null_status_on_timeout_only_active — аналогично null_status_on_timeout, но не дожидается неактивных реплик базы данных Replicated.
  • throw_only_active — аналогично throw, но не дожидается неактивных реплик базы данных Replicated.

Значение по умолчанию в облаке: none.

distributed_ddl_task_timeout​

ТипПо умолчанию
Int64180

Устанавливает таймаут для ответов DDL запросов от всех хостов в кластере. Если DDL запрос не был выполнен на всех хостах, ответ будет содержать ошибку таймаута и запрос будет выполнен в асинхронном режиме. Отрицательное значение означает бесконечный таймаут.

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

  • Положительное целое число.
  • 0 — асинхронный режим.
  • Отрицательное целое число — бесконечный таймаут.

distributed_foreground_insert​

ТипПо умолчанию
Bool0

Включает или выключает синхронную вставку данных в таблицу Distributed.

По умолчанию, при вставке данных в таблицу Distributed, сервер ClickHouse отправляет данные на узлы кластера в фоновом режиме. Когда distributed_foreground_insert=1, данные обрабатываются синхронно, и операция INSERT завершается успешно только после того, как все данные сохранены на всех шардах (по крайней мере, одна реплика для каждого шард, если internal_replication равно true).

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

  • 0 — Данные вставляются в фоновом режиме.
  • 1 — Данные вставляются в синхронном режиме.

Значение по умолчанию в облаке: 1.

Смотрите также

distributed_group_by_no_merge​

ТипПо умолчанию
UInt640

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

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

  • 0 — Отключено (финальная обработка запроса выполняется на узле-инициаторе).
  • 1 - Не объединять состояния агрегации с разных серверов для распределенной обработки запросов (запрос полностью обрабатывается на шарде, инициатор только проксирует данные), можно использовать в случае, если точно известно, что на разных шардах находятся разные ключи.
  • 2 - То же, что и 1, но применяется ORDER BY и LIMIT (это невозможно, когда запрос полностью обрабатывается на удаленном узле, например, для distributed_group_by_no_merge=1) на инициаторе (можно использовать для запросов с ORDER BY и/или LIMIT).

Пример

distributed_insert_skip_read_only_replicas​

ТипПо умолчанию
Bool0

Включает пропуск реплик только для чтения для запросов INSERT в Distributed.

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

  • 0 — INSERT выполняется как обычно, если он попадает на реплику только для чтения, он завершится с ошибкой.
  • 1 — Инициатор пропустит реплики только для чтения перед отправкой данных на шарды.

distributed_product_mode​

ТипПо умолчанию
DistributedProductModedeny

Изменяет поведение распределенных подзапросов.

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

Ограничения:

  • Применяется только для подзапросов IN и JOIN.
  • Только если раздел FROM использует распределенную таблицу, содержащую более одного шарда.
  • Если подзапрос касается распределенной таблицы, содержащей более одного шара.
  • Не используется для функции, имеющей значение таблицы remote.

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

  • deny — Значение по умолчанию. Запрещает использование таких типов подзапросов (возвращает исключение "Double-distributed in/JOIN subqueries is denied").
  • local — Заменяет базу данных и таблицу в подзапросе на локальные для целевого сервера (шара), оставляя обычные IN/JOIN.
  • global — Заменяет запрос IN/JOIN на GLOBAL IN/GLOBAL JOIN.
  • allow — Позволяет использование таких типов подзапросов.

distributed_push_down_limit​

ТипПо умолчанию
UInt641

Включает или выключает применение LIMIT на каждом шарде отдельно.

Это позволит избежать:

  • Отправки лишних строк по сети;
  • Обработки строк превышающих лимит на инициаторе.

Начиная с версии 21.9 вы не сможете получить неточные результаты, так как distributed_push_down_limit изменяет выполнение запроса только в случае выполнения хотя бы одного из условий:

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

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

Смотрите также:

distributed_replica_error_cap​

ТипПо умолчанию
UInt641000
  • Тип: беззнаковое целое
  • Значение по умолчанию: 1000

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

Смотрите также:

distributed_replica_error_half_life​

ТипПо умолчанию
Seconds60
  • Тип: секунды
  • Значение по умолчанию: 60 секунд

Контролирует, как быстро ошибки в распределенных таблицах обнуляются. Если реплика недоступна в течение некоторого времени, накапливает 5 ошибок, и значение distributed_replica_error_half_life установлено на 1 секунду, тогда реплика считается нормальной через 3 секунды после последней ошибки.

Смотрите также:

distributed_replica_max_ignored_errors​

ТипПо умолчанию
UInt640
  • Тип: беззнаковое целое
  • Значение по умолчанию: 0

Количество ошибок, которые будут проигнорированы при выборе реплик (в соответствии с алгоритмом load_balancing).

Смотрите также:

do_not_merge_across_partitions_select_final​

ТипПо умолчанию
Bool0

Объединять части только в одной партиции в select final.

empty_result_for_aggregation_by_constant_keys_on_empty_set​

ТипПо умолчанию
Bool1

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

empty_result_for_aggregation_by_empty_set​

ТипПо умолчанию
Bool0

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

enable_adaptive_memory_spill_scheduler​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Запускает процессор для адаптивного сброса данных во внешнее хранилище. В настоящее время поддерживается grace join.

enable_blob_storage_log​

ТипПо умолчанию
Bool1

Записывает информацию о операциях блочного хранилища в таблицу system.blob_storage_log.

enable_deflate_qpl_codec​

ТипПо умолчанию
Bool0

Если включено, можно использовать кодек DEFLATE_QPL для сжатия колонок.

enable_early_constant_folding​

ТипПо умолчанию
Bool1

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

enable_extended_results_for_datetime_functions​

ТипПо умолчанию
Bool0

Включает или отключает возвращение результатов типа:

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

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

enable_filesystem_cache​

ТипПо умолчанию
Bool1

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

enable_filesystem_cache_log​

ТипПо умолчанию
Bool0

Разрешает записывать журнал кэширования файловой системы для каждого запроса.

enable_filesystem_cache_on_write_operations​

ТипПо умолчанию
Bool0

Запись в кэш при операциях записи. Для полноценной работы этой настройки необходимо также добавить её в конфигурацию диска.

enable_filesystem_read_prefetches_log​

ТипПо умолчанию
Bool0

Запись в system.filesystem prefetch_log во время запроса. Следует использовать только для тестирования или отладки, не рекомендуется включать по умолчанию.

enable_global_with_statement​

ТипПо умолчанию
Bool1

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

enable_hdfs_pread​

ТипПо умолчанию
Bool1

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

enable_http_compression​

ТипПо умолчанию
Bool0

Включает или отключает сжатие данных в ответе на HTTP запрос.

Для получения дополнительной информации читайте описание HTTP интерфейса.

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

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

enable_job_stack_trace​

ТипПо умолчанию
Bool1

Выводит трассировку стека создателя задания, когда задание приводит к исключению.

enable_lightweight_delete​

ТипПо умолчанию
Bool1

Включает легковесные мутации удаления для таблиц mergetree.

enable_memory_bound_merging_of_aggregation_results​

ТипПо умолчанию
Bool1

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

enable_multiple_prewhere_read_steps​

ТипПо умолчанию
Bool1

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

enable_named_columns_in_function_tuple​

ТипПо умолчанию
Bool0

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

enable_optimize_predicate_expression​

ТипПо умолчанию
Bool1

Включает вытаскивание предикатов в запросах SELECT.

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

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

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

Использование

Рассмотрите следующие запросы:

  1. SELECT count() FROM test_table WHERE date = '2018-10-10'
  2. SELECT count() FROM (SELECT * FROM test_table) WHERE date = '2018-10-10'

Если enable_optimize_predicate_expression = 1, то время выполнения этих запросов будет одинаковым, так как ClickHouse применяет WHERE к подзапросу во время его обработки.

Если enable_optimize_predicate_expression = 0, то время выполнения второго запроса будет значительно больше, поскольку условие WHERE применяется ко всем данным после завершения подзапроса.

enable_optimize_predicate_expression_to_final_subquery​

ТипПо умолчанию
Bool1

Позволяет проталкивать предикат к конечному подзапросу.

enable_order_by_all​

ТипПо умолчанию
Bool1

Включает или отключает сортировку с синтаксисом ORDER BY ALL, см. ORDER BY.

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

  • 0 — Отключить ORDER BY ALL.
  • 1 — Включить ORDER BY ALL.

Пример

Запрос:

Результат:

enable_parsing_to_custom_serialization​

ТипПо умолчанию
Bool1

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

enable_positional_arguments​

ТипПо умолчанию
Bool1

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

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

  • 0 — Позиционные аргументы не поддерживаются.
  • 1 — Позиционные аргументы поддерживаются: номера колонок могут использоваться вместо имен колонок.

Пример

Запрос:

Результат:

enable_reads_from_query_cache​

ТипПо умолчанию
Bool1

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

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

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

enable_s3_requests_logging​

ТипПо умолчанию
Bool0

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

enable_scalar_subquery_optimization​

ТипПо умолчанию
Bool1

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

enable_sharing_sets_for_mutations​

ТипПо умолчанию
Bool1

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

enable_software_prefetch_in_aggregation​

ТипПо умолчанию
Bool1

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

enable_unaligned_array_join​

ТипПо умолчанию
Bool0

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

enable_url_encoding​

ТипПо умолчанию
Bool1

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

Включено по умолчанию.

enable_vertical_final​

ТипПо умолчанию
Bool1

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

enable_writes_to_query_cache​

ТипПо умолчанию
Bool1

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

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

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

enable_zstd_qat_codec​

ТипПо умолчанию
Bool0

Если включено, может использоваться кодек ZSTD_QAT для сжатия колонок.

enforce_strict_identifier_format​

ТипПо умолчанию
Bool0

Если включено, разрешены только идентификаторы, содержащие алфавитно-цифровые символы и символы подчеркивания.

engine_file_allow_create_multiple_files​

ТипПо умолчанию
Bool0

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

data.Parquet -> data.1.Parquet -> data.2.Parquet, и т.д.

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

  • 0 — Запрос INSERT добавляет новые данные в конец файла.
  • 1 — Запрос INSERT создает новый файл.

engine_file_empty_if_not_exists​

ТипПо умолчанию
Bool0

Разрешает выбор данных из таблицы с файловым движком без файла.

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

  • 0 — SELECT выдает исключение.
  • 1 — SELECT возвращает пустой результат.

engine_file_skip_empty_files​

ТипПо умолчанию
Bool0

Включает или отключает пропуск пустых файлов в таблицах с движком File.

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

  • 0 — SELECT выдает исключение, если пустой файл несовместим с запрашиваемым форматом.
  • 1 — SELECT возвращает пустой результат для пустого файла.

engine_file_truncate_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает усечение перед вставкой в таблицах с движком File.

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

  • 0 — Запрос INSERT добавляет новые данные в конец файла.
  • 1 — Запрос INSERT заменяет существующее содержание файла новыми данными.

engine_url_skip_empty_files​

ТипПо умолчанию
Bool0

Включает или отключает пропуск пустых файлов в таблицах с движком URL.

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

  • 0 — SELECT выдает исключение, если пустой файл несовместим с запрашиваемым форматом.
  • 1 — SELECT возвращает пустой результат для пустого файла.

except_default_mode​

ТипПо умолчанию
SetOperationModeALL

Устанавливает режим по умолчанию в запросе EXCEPT. Возможные значения: пустая строка, 'ALL', 'DISTINCT'. Если пусто, запрос без режима вызовет исключение.

external_storage_connect_timeout_sec​

ТипПо умолчанию
UInt6410

Тайм-аут соединения в секундах. В настоящее время поддерживается только для MySQL.

external_storage_max_read_bytes​

ТипПо умолчанию
UInt640

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

external_storage_max_read_rows​

ТипПо умолчанию
UInt640

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

external_storage_rw_timeout_sec​

ТипПо умолчанию
UInt64300

Тайм-аут чтения/записи в секундах. В настоящее время поддерживается только для MySQL.

external_table_functions_use_nulls​

ТипПо умолчанию
Bool1

Определяет, как функции таблиц mysql, postgresql и odbc используют Nullable колонки.

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

  • 0 — Функция таблицы явно использует Nullable колонки.
  • 1 — Функция таблицы неявно использует Nullable колонки.

Использование

Если настройка установлена в 0, функция таблицы не создает Nullable колонки и вставляет значения по умолчанию вместо NULL. Это также применимо для значений NULL внутри массивов.

external_table_strict_query​

ТипПо умолчанию
Bool0

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

extract_key_value_pairs_max_pairs_per_row​

ТипПо умолчанию
UInt641000

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

extremes​

ТипПо умолчанию
Bool0

Учитывать экстремальные значения (минимумы и максимумы в колонках результата запроса). Принимает 0 или 1. По умолчанию 0 (отключено). Для получения дополнительной информации смотрите раздел "Экстремальные значения".

fallback_to_stale_replicas_for_distributed_queries​

ТипПо умолчанию
Bool1

Принуждает запрос к устаревшей реплике, если обновленные данные недоступны. См. Репликация.

ClickHouse выбирает наиболее актуальную из устаревших реплик таблицы.

Используется при выполнении SELECT из таблицы распределенной, указывающей на реплицированные таблицы.

По умолчанию 1 (включено).

filesystem_cache_boundary_alignment​

ТипПо умолчанию
UInt640

Выравнивание границ кэша файловой системы. Эта настройка применяется только к не-дисковым чтениям (например, для кэша удаленных движков таблиц / табличных функций, но не для конфигурации хранения таблиц MergeTree). Значение 0 означает отсутствие выравнивания.

filesystem_cache_enable_background_download_during_fetch​

ClickHouse Cloud only
ТипПо умолчанию
Bool1

Имеет значение только в ClickHouse Cloud. Время ожидания для блокировки кэша для резервирования места в файловом кэше.

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage​

ClickHouse Cloud only
ТипПо умолчанию
Bool1

Имеет значение только в ClickHouse Cloud. Время ожидания для блокировки кэша для резервирования места в файловом кэше.

filesystem_cache_max_download_size​

ТипПо умолчанию
UInt64137438953472

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

filesystem_cache_name​

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

filesystem_cache_prefer_bigger_buffer_size​

ТипПо умолчанию
Bool1

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

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds​

ТипПо умолчанию
UInt641000

Время ожидания для блокировки кэша для резервирования места в файловом кэше.

filesystem_cache_segments_batch_size​

ТипПо умолчанию
UInt6420

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

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit​

ТипПо умолчанию
Bool1

Пропустите загрузку с удаленной файловой системы, если превышен размер кэша запроса.

filesystem_prefetch_max_memory_usage​

ТипПо умолчанию
UInt641073741824

Максимальное использование памяти для предварительных загрузок.

filesystem_prefetch_step_bytes​

ТипПо умолчанию
UInt640

Шаг предварительной загрузки в байтах. Ноль означает auto — приблизительно лучший шаг предварительной загрузки будет автоматически определен, но может не быть на 100% лучшим. Фактическое значение может быть другим из-за настройки filesystem_prefetch_min_bytes_for_single_read_task.

filesystem_prefetch_step_marks​

ТипПо умолчанию
UInt640

Шаг предварительной загрузки в метках. Ноль означает auto — приблизительно лучший шаг предварительной загрузки будет автоматически определен, но может не быть на 100% лучшим. Фактическое значение может быть другим из-за настройки filesystem_prefetch_min_bytes_for_single_read_task.

filesystem_prefetches_limit​

ТипПо умолчанию
UInt64200

Максимальное количество предварительных загрузок. Ноль означает неограниченно. Рекомендуется установка filesystem_prefetches_max_memory_usage, если вы хотите ограничить количество предварительных загрузок.

final​

ТипПо умолчанию
Bool0

Автоматически применяет модификатор FINAL ко всем таблицам в запросе, к таблицам, где FINAL применим, включая объединенные таблицы и таблицы в подзапросах, и распределенные таблицы.

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

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

Пример:

flatten_nested​

ТипПо умолчанию
Bool1

Устанавливает формат данных для колонок nested.

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

  • 1 — Вложенная колонка уплощается в отдельные массивы.
  • 0 — Вложенная колонка остается единым массивом кортежей.

Использование

Если настройка установлена в 0, возможно использование произвольного уровня вложенности.

Примеры

Запрос:

Результат:

Запрос:

Результат:

force_aggregate_partitions_independently​

ТипПо умолчанию
Bool0

Принуждает использование оптимизации, когда это применимо, но эвристика решила не использовать её.

force_aggregation_in_order​

ТипПо умолчанию
Bool0

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

force_data_skipping_indices​

Отключает выполнение запроса, если переданные индексы пропуска данных не были использованы.

Рассмотрим следующий пример:

force_grouping_standard_compatibility​

ТипПо умолчанию
Bool1

Заставляет функцию GROUPING возвращать 1, когда аргумент не используется в качестве ключа агрегации.

force_index_by_date​

ТипПо умолчанию
Bool0

Отключает выполнение запроса, если индекс не может быть использован по дате.

Работает с таблицами в семье MergeTree.

Если force_index_by_date=1, ClickHouse проверяет, есть ли в запросе условие по ключу даты, которое можно использовать для ограничения диапазонов данных. Если соответствующего условия нет, оно вызывает исключение. Однако оно не проверяет, сокращает ли условие объем данных, которые необходимо прочитать. Например, условие Date != ' 2000-01-01 ' является допустимым, даже если оно соответствует всем данным в таблице (т.е. выполнение запроса требует полного сканирования). Для получения дополнительной информации о диапазонах данных в таблицах MergeTree см. MergeTree.

force_optimize_projection​

ТипПо умолчанию
Bool0

Включает или отключает обязательное использование проекций в запросах SELECT, когда оптимизация проекций включена (см. настройку optimize_use_projections).

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

  • 0 — Оптимизация проекций не обязательна.
  • 1 — Оптимизация проекций обязательна.

force_optimize_projection_name​

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

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

  • строка: имя проекции, которая используется в запросе.

force_optimize_skip_unused_shards​

ТипПо умолчанию
UInt640

Включает или отключает выполнение запроса, если optimize_skip_unused_shards включен и пропуск неиспользуемых шардов невозможен. Если пропуск невозможен и настройка включена, будет выброшено исключение.

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

  • 0 — Отключено. ClickHouse не вызывает исключение.
  • 1 — Включено. Выполнение запроса отключается только в том случае, если таблица имеет ключ шардирования.
  • 2 — Включено. Выполнение запроса отключается независимо от того, определен ли ключ шардирования для таблицы.

force_optimize_skip_unused_shards_nesting​

ТипПо умолчанию
UInt640

Управляет force_optimize_skip_unused_shards (поэтому все еще требует force_optimize_skip_unused_shards), в зависимости от уровня вложенности распределенного запроса (случай, когда у вас есть Distributed таблица, которая обращается к другой Distributed таблице).

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

  • 0 - Отключено, force_optimize_skip_unused_shards всегда работает.
  • 1 — Включает force_optimize_skip_unused_shards только для первого уровня.
  • 2 — Включает force_optimize_skip_unused_shards до второго уровня.

force_primary_key​

ТипПо умолчанию
Bool0

Отключает выполнение запроса, если индексирование по первичному ключу невозможно.

Работает с таблицами в семье MergeTree.

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

force_remove_data_recursively_on_drop​

ТипПо умолчанию
Bool0

Рекурсивно удаляет данные при выполнении запроса DROP. Избегает ошибки 'Каталог не пуст', но может молча удалить открепленные данные.

formatdatetime_f_prints_scale_number_of_digits​

ТипПо умолчанию
Bool0

Форматировщик '%f' в функции 'formatDateTime' печатает только количество разрядов для масштабирования для DateTime64 вместо фиксированных 6 разрядов.

formatdatetime_f_prints_single_zero​

ТипПо умолчанию
Bool0

Форматировщик '%f' в функции 'formatDateTime' печатает единственный ноль вместо шести нулей, если отформатированное значение не имеет дробных секунд.

formatdatetime_format_without_leading_zeros​

ТипПо умолчанию
Bool0

Форматировщики '%c', '%l' и '%k' в функции 'formatDateTime' печатают месяцы и часы без ведущих нулей.

formatdatetime_parsedatetime_m_is_month_name​

ТипПо умолчанию
Bool1

Форматировщик '%M' в функциях 'formatDateTime' и 'parseDateTime' печатает/парсит имя месяца вместо минут.

fsync_metadata​

ТипПо умолчанию
Bool1

Включает или отключает fsync при записи .sql файлов. Включено по умолчанию.

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

function_implementation​

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

function_json_value_return_type_allow_complex​

ТипПо умолчанию
Bool0

Управляет тем, разрешено ли возвращать сложный тип (например: структуру, массив, карту) для функции json_value.

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

  • true — Разрешить.
  • false — Запретить.

function_json_value_return_type_allow_nullable​

ТипПо умолчанию
Bool0

Контролирует, разрешено ли возвращать NULL, когда значение не существует для функции JSON_VALUE.

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

  • true — Разрешить.
  • false — Запретить.

function_locate_has_mysql_compatible_argument_order​

ТипПо умолчанию
Bool1

Контролирует порядок аргументов в функции locate.

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

  • 0 — Функция locate принимает аргументы (haystack, needle[, start_pos]).
  • 1 — Функция locate принимает аргументы (needle, haystack, [, start_pos]) (поведение, совместимое с MySQL).

function_range_max_elements_in_block​

ТипПо умолчанию
UInt64500000000

Устанавливает предельное значение для объема данных, генерируемого функцией range. Определяет максимальное количество значений, создаваемых функцией на блок данных (сумма размеров массивов для каждой строки в блоке).

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

  • Положительное целое число.

См. также

function_sleep_max_microseconds_per_block​

ТипПо умолчанию
UInt643000000

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

function_visible_width_behavior​

ТипПо умолчанию
UInt641

Версия поведения visibleWidth. 0 - учитывает только количество кодовых точек; 1 - корректно считает символы с нулевой шириной и комбинирующими символами, считает полноширинные символы как два, оценивает ширину табуляции, считает символы удаления.

geo_distance_returns_float64_on_float64_arguments​

ТипПо умолчанию
Bool1

Если все четыре аргумента для функций geoDistance, greatCircleDistance, greatCircleAngle являются Float64, вернуть Float64 и использовать двойную точность для внутренних расчетов. В предыдущих версиях ClickHouse эти функции всегда возвращали Float32.

glob_expansion_max_elements​

ТипПо умолчанию
UInt641000

Максимальное количество разрешенных адресов (Для внешних хранилищ, табличных функций и т.д.).

grace_hash_join_initial_buckets​

Experimental feature. Learn more.
ТипПо умолчанию
NonZeroUInt641

Начальное количество ведер для соединения grace hash.

grace_hash_join_max_buckets​

Experimental feature. Learn more.
ТипПо умолчанию
NonZeroUInt641024

Предел по количеству ведер для соединения grace hash.

group_by_overflow_mode​

ТипПо умолчанию
OverflowModeGroupBythrow

Устанавливает, что происходит, когда количество уникальных ключей для агрегации превышает предел:

  • throw: выбросить исключение
  • break: остановить выполнение запроса и вернуть частичный результат
  • any: продолжить агрегацию для ключей, которые попали в набор, но не добавлять новые ключи в набор.

Использование значения 'any' позволяет вам выполнить приближение GROUP BY. Качество этого приближения зависит от статистической природы данных.

group_by_two_level_threshold​

ТипПо умолчанию
UInt64100000

С какого количества ключей начинается агрегация двух уровней. 0 - порог не установлен.

group_by_two_level_threshold_bytes​

ТипПо умолчанию
UInt6450000000

С какого размера состояния агрегации в байтах начинается использование двух уровней агрегации. 0 - порог не установлен. Двухуровневая агрегация используется, когда хотя бы один из порогов срабатывает.

group_by_use_nulls​

ТипПо умолчанию
Bool0

Изменяет способ, которым условие GROUP BY обрабатывает типы ключей агрегации. Когда используются спекifiers ROLLUP, CUBE или GROUPING SETS, некоторые ключи агрегации могут не использоваться для получения некоторых строк результата. Столбцы для этих ключей заполняются либо значением по умолчанию, либо NULL в соответствующих строках в зависимости от этой настройки.

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

  • 0 — Значение по умолчанию для типа ключа агрегации используется для получения отсутствующих значений.
  • 1 — ClickHouse выполняет GROUP BY так же, как это указано в стандарте SQL. Типы ключей агрегации преобразуются в Nullable. Столбцы для соответствующих ключей агрегации заполняются NULL для строк, которые не использовали его.

См. также:

h3togeo_lon_lat_result_order​

ТипПо умолчанию
Bool0

Функция 'h3ToGeo' возвращает (lon, lat), если true, иначе (lat, lon).

handshake_timeout_ms​

ТипПо умолчанию
Milliseconds10000

Тайм-аут в миллисекундах для получения пакета Hello от реплик во время рукопожатия.

hdfs_create_new_file_on_insert​

ТипПо умолчанию
Bool0

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

начальный: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz, и т.д.

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

  • 0 — Запрос INSERT добавляет новые данные в конец файла.
  • 1 — Запрос INSERT создает новый файл.

hdfs_ignore_file_doesnt_exist​

ТипПо умолчанию
Bool0

Игнорирует отсутствие файла, если он не существует при чтении определенных ключей.

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

  • 1 — SELECT возвращает пустой результат.
  • 0 — SELECT выдает исключение.

hdfs_replication​

ТипПо умолчанию
UInt640

Фактическое количество репликаций может быть указано при создании файла hdfs.

hdfs_skip_empty_files​

ТипПо умолчанию
Bool0

Включает или отключает пропуск пустых файлов в таблицах с движком HDFS.

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

  • 0 — SELECT выдает исключение, если пустой файл несовместим с запрашиваемым форматом.
  • 1 — SELECT возвращает пустой результат для пустого файла.

hdfs_throw_on_zero_files_match​

ТипПо умолчанию
Bool0

Выбросить ошибку, если по правилам глобального расширения не найдено ноль файлов.

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

  • 1 — SELECT выдает исключение.
  • 0 — SELECT возвращает пустой результат.

hdfs_truncate_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает усечение перед вставкой в таблицах с движком hdfs. Если отключено, будет выдано исключение при попытке вставить, если файл в HDFS уже существует.

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

  • 0 — Запрос INSERT добавляет новые данные в конец файла.
  • 1 — Запрос INSERT заменяет существующее содержание файла новыми данными.

hedged_connection_timeout_ms​

ТипПо умолчанию
Milliseconds50

Тайм-аут соединения для установления соединения с репликой для хеджированных запросов.

Experimental feature. Learn more.
ТипПо умолчанию
UInt64256

Размер динамического списка кандидатов при поиске в индексе векторного сходства, также известный как 'ef_search'.

hsts_max_age​

ТипПо умолчанию
UInt640

Срок действия для HSTS. 0 означает отключение HSTS.

http_connection_timeout​

ТипПо умолчанию
Seconds1

Тайм-аут соединения HTTP (в секундах).

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

  • Любое положительное целое число.
  • 0 - Отключено (бесконечный тайм-аут).

http_headers_progress_interval_ms​

ТипПо умолчанию
UInt64100

Не отправлять HTTP заголовки X-ClickHouse-Progress чаще, чем через указанный интервал.

http_make_head_request​

ТипПо умолчанию
Bool1

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

http_max_field_name_size​

ТипПо умолчанию
UInt64131072

Максимальная длина имени поля в HTTP заголовке

http_max_field_value_size​

ТипПо умолчанию
UInt64131072

Максимальная длина значения поля в HTTP заголовке

http_max_fields​

ТипПо умолчанию
UInt641000000

Максимальное количество полей в HTTP заголовке

http_max_multipart_form_data_size​

ТипПо умолчанию
UInt641073741824

Ограничение на размер содержимого multipart/form-data. Эта настройка не может быть распознана из параметров URL и должна быть установлена в пользовательском профиле. Обратите внимание, что содержимое разбирается, и внешние таблицы создаются в памяти до начала выполнения запроса. И это единственное ограничение, которое имеет значение на этом этапе (ограничения по максимальному использованию памяти и максимальному времени выполнения не влияют на чтение данных формы HTTP).

http_max_request_param_data_size​

ТипПо умолчанию
UInt6410485760

Ограничение на размер данных запроса, используемых в качестве параметра запроса в предопределённых HTTP запросах.

http_max_tries​

ТипПо умолчанию
UInt6410

Максимальное количество попыток чтения через HTTP.

http_max_uri_size​

ТипПо умолчанию
UInt641048576

Устанавливает максимальную длину URI HTTP запроса.

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

  • Положительное целое число.

http_native_compression_disable_checksumming_on_decompress​

ТипПо умолчанию
Bool0

Включает или отключает проверку контрольной суммы при распаковке данных HTTP POST от клиента. Используется только для формата сжатия ClickHouse (не используется с gzip или deflate).

Для получения дополнительной информации читайте описание HTTP интерфейса.

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

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

http_receive_timeout​

ТипПо умолчанию
Seconds30

Тайм-аут приёмки HTTP (в секундах).

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

  • Любое положительное целое число.
  • 0 - Отключено (бессрочный тайм-аут).

http_response_buffer_size​

ТипПо умолчанию
UInt640

Количество байт, которые будут буферизоваться в памяти сервера перед отправкой HTTP ответа клиенту или сбросом на диск (когда включен http_wait_end_of_query).

http_response_headers​

ТипПо умолчанию
Map{}

Позволяет добавлять или заменять HTTP заголовки, которые сервер вернёт в ответе с успешным результатом запроса. Это влияет только на HTTP интерфейс.

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

Настройка позволяет установить заголовок на постоянное значение. В данный момент нет способа установить заголовок на динамически рассчитанное значение.

Ни имена, ни значения не могут содержать управляющие символы ASCII.

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

Пример: SET http_response_headers = '{"Content-Type": "image/png"}'

http_retry_initial_backoff_ms​

ТипПо умолчанию
UInt64100

Минимум миллисекунд для задержки при повторной попытке чтения через HTTP.

http_retry_max_backoff_ms​

ТипПо умолчанию
UInt6410000

Максимум миллисекунд для задержки при повторной попытке чтения через HTTP.

http_send_timeout​

ТипПо умолчанию
Seconds30

Тайм-аут отправки HTTP (в секундах).

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

  • Любое положительное целое число.
  • 0 - Отключено (бессрочный тайм-аут).
примечание

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

http_skip_not_found_url_for_globs​

ТипПо умолчанию
Bool1

Пропускать URL для глобов с ошибкой HTTP_NOT_FOUND.

http_wait_end_of_query​

ТипПо умолчанию
Bool0

Включает буферизацию HTTP ответа на стороне сервера.

http_write_exception_in_output_format​

ТипПо умолчанию
Bool1

Записывает исключение в выходном формате для получения допустимого вывода. Работает с форматами JSON и XML.

http_zlib_compression_level​

ТипПо умолчанию
Int643

Устанавливает уровень сжатия данных в ответе на запрос HTTP, если enable_http_compression = 1.

Возможные значения: числа от 1 до 9.

iceberg_snapshot_id​

ТипПо умолчанию
Int640

Запрос к таблице Iceberg с использованием конкретного идентификатора снимка.

iceberg_timestamp_ms​

ТипПо умолчанию
Int640

Запрос к таблице Iceberg с использованием снимка, который был актуален в конкретный момент времени.

idle_connection_timeout​

ТипПо умолчанию
UInt643600

Тайм-аут для закрытия неактивных TCP соединений после указанного количества секунд.

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

  • Положительное целое число (0 - закрыть немедленно, через 0 секунд).

ignore_cold_parts_seconds​

ClickHouse Cloud only
ТипПо умолчанию
Int640

Влияет только в ClickHouse Cloud. Исключает новые части данных из запросов SELECT, пока они либо не будут предварительно разогреты (см. cache_populated_by_fetch), либо не станут старыми на это количество секунд. Только для Replicated-/SharedMergeTree.

ignore_data_skipping_indices​

Игнорирует индексы пропуска, указанные, если они используются в запросе.

Рассмотрим следующий пример:

Запрос без игнорирования индексов:

Игнорируя индекс xy_idx:

Работает с таблицами в семействе MergeTree.

ignore_drop_queries_probability​

ТипПо умолчанию
Float0

Если включено, сервер будет игнорировать все запросы DROP таблиц с заданной вероятностью (для Memory и JOIN движков будет заменять DROP на TRUNCATE). Используется для целей тестирования.

ignore_materialized_views_with_dropped_target_table​

ТипПо умолчанию
Bool0

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

ignore_on_cluster_for_replicated_access_entities_queries​

ТипПо умолчанию
Bool0

Игнорировать ON CLUSTER для управляющих запросов к реплицируемым сущностям доступа.

ignore_on_cluster_for_replicated_named_collections_queries​

ТипПо умолчанию
Bool0

Игнорировать ON CLUSTER для управляющих запросов к реплицируемым именованным коллекциям.

ignore_on_cluster_for_replicated_udf_queries​

ТипПо умолчанию
Bool0

Игнорировать ON CLUSTER для управляющих запросов к реплицируемым UDF.

implicit_select​

ТипПо умолчанию
Bool0

Разрешить написание простых запросов SELECT без ведущего ключевого слова SELECT, что делает их простыми для использования в стиле калькулятора, например, 1 + 2 становится допустимым запросом.

В clickhouse-local это включено по умолчанию и может быть явно отключено.

implicit_transaction​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

Если включено и не находится внутри транзакции, оборачивает запрос в полную транзакцию (начало + фиксация или откат).

input_format_parallel_parsing​

ТипПо умолчанию
Bool1

Включает или отключает параллельный парсинг форматов данных с сохранением порядка. Поддерживается только для форматов TSV, TSKV, CSV и JSONEachRow.

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

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

insert_allow_materialized_columns​

ТипПо умолчанию
Bool0

Если настройка включена, разрешает использование материализованных колонок в INSERT.

insert_deduplicate​

ТипПо умолчанию
Bool1

Включает или отключает дедупликацию блоков при INSERT (для таблиц Replicated*).

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

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

По умолчанию блоки, вставляемые в реплицируемые таблицы с помощью оператора INSERT, дедуплицируются (см. Репликация данных). Для реплицируемых таблиц по умолчанию только 100 самых последних блоков для каждой партиции дедуплицируются (см. replicated_deduplication_window, replicated_deduplication_window_seconds). Для нереплицируемых таблиц см. non_replicated_deduplication_window.

insert_deduplication_token​

Настройка позволяет пользователю предоставлять свою семантику дедупликации в MergeTree/ReplicatedMergeTree. Например, предоставив уникальное значение для настройки в каждом операторе INSERT, пользователь может избежать дедупликации одинаковых вставленных данных.

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

  • Любая строка

insert_deduplication_token используется для дедупликации только когда не пустое.

Для реплицируемых таблиц по умолчанию только 100 самых последних вставок для каждой партиции дедуплицируются (см. replicated_deduplication_window, replicated_deduplication_window_seconds). Для нереплицируемых таблиц см. non_replicated_deduplication_window.

примечание

insert_deduplication_token работает на уровне партиции (так же как и insert_deduplication контрольную сумму). Несколько партиций могут иметь одно и то же значение insert_deduplication_token.

Пример:

insert_keeper_fault_injection_probability​

ТипПо умолчанию
Float0

Приблизительная вероятность сбоя для запроса keeper во время вставки. Допустимое значение находится в интервале [0.0f, 1.0f].

insert_keeper_fault_injection_seed​

ТипПо умолчанию
UInt640

0 - случайное семя, иначе значение настройки.

insert_keeper_max_retries​

ТипПо умолчанию
UInt6420

Настройка устанавливает максимальное количество повторных попыток для запросов ClickHouse Keeper (или ZooKeeper) при вставке в реплицированный MergeTree. Учитываются только запросы Keeper, которые завершились неудачей из-за сетевой ошибки, таймаута сессии Keeper или таймаута запроса.

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

  • Положительное целое число.
  • 0 — Повторы отключены.

Значение по умолчанию в облаке: 20.

Повторы запросов Keeper выполняются после некоторого таймаута. Таймаут контролируется следующими настройками: insert_keeper_retry_initial_backoff_ms, insert_keeper_retry_max_backoff_ms. Первая повторная попытка выполняется после таймаута insert_keeper_retry_initial_backoff_ms. Последующие таймауты будут рассчитываться следующим образом:

Например, если insert_keeper_retry_initial_backoff_ms=100, insert_keeper_retry_max_backoff_ms=10000 и insert_keeper_max_retries=8, тогда таймауты будут 100, 200, 400, 800, 1600, 3200, 6400, 10000.

Помимо отказоустойчивости, повторы также нацелены на обеспечение лучшего пользовательского опыта - они позволяют избежать возврата ошибки во время выполнения INSERT, если Keeper перезапускается, например, из-за обновления.

insert_keeper_retry_initial_backoff_ms​

ТипПо умолчанию
UInt64100

Начальный таймаут (в миллисекундах) для повторной попытки неудачного запроса Keeper во время выполнения запроса INSERT.

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

  • Положительное целое число.
  • 0 — Без таймаута.

keeper_retry_max_backoff_ms​

ТипПо умолчанию
UInt645000

Максимальное время ожидания для общих операций Keeper

least_greatest_legacy_null_behavior​

ТипПо умолчанию
Bool0

Если включено, функции 'least' и 'greatest' возвращают NULL, если один из их аргументов равен NULL.

legacy_column_name_of_tuple_literal​

ТипПо умолчанию
Bool0

Список всех имен элементов больших литералов кортежей в их именах колонок вместо хеша. Эта настройка существует только по соображениям совместимости. Имеет смысл установить на 'true', при поэтапном обновлении кластера с версии ниже 21.7 на более высокую.

lightweight_deletes_sync​

ТипПо умолчанию
UInt642

То же самое, что и mutations_sync, но контролирует только выполнение легковесных удалений.

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

  • 0 - Мутации выполняются асинхронно.
  • 1 - Запрос ждет, пока легковесные удаления завершатся на текущем сервере.
  • 2 - Запрос ждет, пока легковесные удаления завершатся на всех репликах (если они существуют).

Смотрите также

limit​

ТипПо умолчанию
UInt640

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

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

  • 0 — Количество строк не ограничено.
  • Положительное целое число.

live_view_heartbeat_interval​

Experimental feature. Learn more.
ТипПо умолчанию
Seconds15

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

load_balancing​

ТипПо умолчанию
LoadBalancingrandom

Определяет алгоритм выбора реплик, который используется для распределенной обработки запросов.

ClickHouse поддерживает следующие алгоритмы выбора реплик:

Смотрите также:

Случайный (по умолчанию)​

Количество ошибок учитывается для каждой реплики. Запрос отправляется на реплику с наименьшим количеством ошибок, а если таких несколько, то на любую из них. Недостатки: Близость сервера не учитывается; если у реплик разные данные, вы также получите разные данные.

Ближайшее имя хоста​

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

Например, example01-01-1 и example01-01-2 отличаются в одной позиции, в то время как example01-01-1 и example01-02-2 различны в двух местах. Этот метод может показаться примитивным, но он не требует внешних данных о топологии сети, и он не сравнивает IP-адреса, что было бы сложно для наших IPv6-адресов.

Таким образом, если есть эквивалентные реплики, предпочтение отдается ближайшей по имени. Можно также предположить, что при отправке запроса на один и тот же сервер, в отсутствие сбоев, распределенный запрос также будет проходить через одни и те же серверы. Поэтому, даже если на репликах размещены разные данные, запрос вернет в основном одинаковые результаты.

Расстояние Левенштейна имени хоста​

Так же, как и nearest_hostname, но сравнивает имена хостов по расстоянию Левенштейна. Например:

По порядку​

Реплики с одинаковым количеством ошибок доступны в том порядке, в котором они указаны в конфигурации. Этот метод подходит, когда вы точно знаете, какая реплика предпочтительнее.

Первый или случайный​

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

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

Можно явно определить, какая реплика будет первой, с помощью настройки load_balancing_first_offset. Это дает больший контроль для перераспределения нагрузки запросов между репликами.

Круговая очередность​

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

load_balancing_first_offset​

ТипПо умолчанию
UInt640

Какая реплика предпочтительно посылать запрос, когда используется стратегия балансировки нагрузки FIRST_OR_RANDOM.

load_marks_asynchronously​

ТипПо умолчанию
Bool0

Загружать метки MergeTree асинхронно.

local_filesystem_read_method​

ТипПо умолчанию
Stringpread_threadpool

Метод чтения данных из локальной файловой системы, один из: read, pread, mmap, io_uring, pread_threadpool. Метод 'io_uring' является экспериментальным и не работает для Log, TinyLog, StripeLog, File, Set и Join и других таблиц с добавляемыми файлами при наличии одновременных чтений и записей.

local_filesystem_read_prefetch​

ТипПо умолчанию
Bool0

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

lock_acquire_timeout​

ТипПо умолчанию
Seconds120

Определяет, сколько секунд запрос блокировки будет ждать перед сбоем.

Тайм-аут блокировки используется для защиты от взаимных блокировок при выполнении операций чтения/записи с таблицами. Когда время тайм-аута истекает и запрос блокировки терпит неудачу, сервер ClickHouse выбрасывает исключение "Попытка блокировки завершилась тайм-аутом! Возможная взаимная блокировка предотвращена. Клиент должен повторить попытку." с кодом ошибки DEADLOCK_AVOIDED.

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

  • Положительное целое число (в секундах).
  • 0 — Нет тайм-аута для блокировки.

log_comment​

Определяет значение для поля log_comment таблицы system.query_log и текст комментария для журнальных записей сервера.

Это может быть использовано для повышения читаемости журналов сервера. Кроме того, это помогает выбрать запросы, относящиеся к тесту, из system.query_log после запуска clickhouse-test.

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

  • Любая строка не длиннее max_query_size. Если значение max_query_size превышается, сервер выбрасывает исключение.

Пример

Запрос:

Результат:

log_formatted_queries​

ТипПо умолчанию
Bool0

Позволяет логировать отформатированные запросы в системную таблицу system.query_log (заполняет колонку formatted_query в system.query_log).

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

  • 0 — Отформатированные запросы не логируются в системной таблице.
  • 1 — Отформатированные запросы логируются в системной таблице.

log_processors_profiles​

ТипПо умолчанию
Bool1

Записывать время, которое процессор потратил во время выполнения/ожидания данных в таблице system.processors_profile_log.

Смотрите также:

log_profile_events​

ТипПо умолчанию
Bool1

Логировать статистику производительности запроса в query_log, query_thread_log и query_views_log.

log_queries​

ТипПо умолчанию
Bool1

Настройка ведения журнала запросов.

Запросы, посылаемые в ClickHouse с этой настройкой, записываются в соответствии с правилами параметра конфигурации сервера query_log.

Пример:

log_queries_cut_to_length​

ТипПо умолчанию
UInt64100000

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

log_queries_min_query_duration_ms​

ТипПо умолчанию
Milliseconds0

Если включено (не ноль), запросы быстрее значения этой настройки не будут записываться (это можно рассматривать как long_query_time для MySQL Slow Query Log), и это, в основном, означает, что вы не найдете их в следующих таблицах:

  • system.query_log
  • system.query_thread_log

Только запросы с следующим типом попадут в журнал:

  • QUERY_FINISH

  • EXCEPTION_WHILE_PROCESSING

  • Тип: миллисекунды

  • Значение по умолчанию: 0 (любой запрос)

log_queries_min_type​

ТипПо умолчанию
LogQueriesTypeQUERY_START

Минимальный тип query_log для записи в журнал.

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

  • QUERY_START (=1)
  • QUERY_FINISH (=2)
  • EXCEPTION_BEFORE_START (=3)
  • EXCEPTION_WHILE_PROCESSING (=4)

Можно использовать, чтобы ограничить, какие сущности попадут в query_log, скажем, если вы интересуетесь только ошибками, тогда вы можете использовать EXCEPTION_WHILE_PROCESSING:

log_queries_probability​

ТипПо умолчанию
Float1

Позволяет пользователю записывать в системные таблицы query_log, query_thread_log и query_views_log только выборку запросов, выбранных случайным образом с заданной вероятностью. Это помогает снизить нагрузку при большом объеме запросов в секунду.

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

  • 0 — Запросы не записываются в системные таблицы.
  • Положительное дробное число в диапазоне [0..1]. Например, если значение настройки равно 0.5, примерно половина запросов записывается в системные таблицы.
  • 1 — Все запросы записываются в системные таблицы.

log_query_settings​

ТипПо умолчанию
Bool1

Логировать настройки запроса в query_log и журнале OpenTelemetry.

log_query_threads​

ТипПо умолчанию
Bool0

Настройка ведения журнала потоков запросов.

Потоки запросов логируются в таблице system.query_thread_log. Эта настройка имеет эффект только тогда, когда log_queries истинно. Потоки запросов, выполняемые ClickHouse с этой настройкой, логируются в соответствии с правилами параметра конфигурации сервера query_thread_log.

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

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

Пример

log_query_views​

ТипПо умолчанию
Bool1

Настройка ведения журнала представлений запросов.

Когда запрос, выполненный ClickHouse с этой включенной настройкой, имеет связанные представления (материализованные или живые представления), они записываются в параметре конфигурации сервера query_views_log.

Пример:

low_cardinality_allow_in_native_format​

ТипПо умолчанию
Bool1

Разрешает или ограничивает использование типа данных LowCardinality с форматом Native.

Если использование LowCardinality ограничено, сервер ClickHouse преобразует колонки LowCardinality в обыкновенные для SELECT запросов и преобразует обыкновенные колонки в колонки LowCardinality для INSERT запросов.

Эта настройка требуется в основном для сторонних клиентов, которые не поддерживают тип данных LowCardinality.

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

  • 1 — Использование LowCardinality не ограничено.
  • 0 — Использование LowCardinality ограничено.

low_cardinality_max_dictionary_size​

ТипПо умолчанию
UInt648192

Устанавливает максимальный размер в строках общего глобального словаря для типа данных LowCardinality, который может быть записан в файловую систему хранения. Эта настройка предотвращает проблемы с ОЗУ в случае неограниченного роста словаря. Все данные, которые не могут быть закодированы из-за ограничения максимального размера словаря, ClickHouse записывает обычным способом.

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

  • Любое положительное целое число.

low_cardinality_use_single_dictionary_for_part​

ТипПо умолчанию
Bool0

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

По умолчанию сервер ClickHouse контролирует размер словарей и, если словарь переполняется, сервер начинает записывать следующий. Чтобы запретить создание нескольких словарей, установите low_cardinality_use_single_dictionary_for_part = 1.

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

  • 1 — Создание нескольких словарей для части данных запрещено.
  • 0 — Создание нескольких словарей для части данных не запрещено.

low_priority_query_wait_time_ms​

Beta feature. Learn more.
ТипПо умолчанию
Milliseconds1000

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

materialize_skip_indexes_on_insert​

ТипПо умолчанию
Bool1

Строятся ли индекс-пропуски и сохраняются ли они при вставках. Если отключено, индексы-пропуски будут построены и сохранены во время объединений или с помощью явного MATERIALIZE INDEX.

materialize_statistics_on_insert​

ТипПо умолчанию
Bool1

Строятся ли и вставляются ли статистические данные при вставках. Если отключено, статистика будет построена и сохранена во время объединений или с помощью явного MATERIALIZE STATISTICS.

materialize_ttl_after_modify​

ТипПо умолчанию
Bool1

Применить TTL для старых данных после запроса ALTER MODIFY TTL.

materialized_views_ignore_errors​

ТипПо умолчанию
Bool0

Позволяет игнорировать ошибки для MATERIALIZED VIEW и доставлять оригинальный блок в таблицу независимо от MVs.

max_analyze_depth​

ТипПо умолчанию
UInt645000

Максимальное число анализов, выполняемых интерпретатором.

max_ast_depth​

ТипПо умолчанию
UInt641000

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

примечание

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

max_ast_elements​

ТипПо умолчанию
UInt6450000

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

примечание

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

max_autoincrement_series​

ТипПо умолчанию
UInt641000

Лимит на количество серий, созданных функцией generateSeriesID.

Поскольку каждая серия представляет собой узел в Keeper, рекомендуется не иметь более нескольких миллионов из них.

max_backup_bandwidth​

ТипПо умолчанию
UInt640

Максимальная скорость чтения в байтах в секунду для конкретной резервной копии на сервере. Ноль означает неограниченно.

max_block_size​

ТипПо умолчанию
UInt6465409

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

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

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

max_bytes_before_external_group_by​

ТипПо умолчанию
UInt640

Облачное значение по умолчанию: половина объема памяти на каждую реплику.

Включает или отключает выполнение операторов GROUP BY в внешней памяти. (Смотрите GROUP BY в внешней памяти)

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

  • Максимальный объем ОЗУ (в байтах), который может использовать одно GROUP BY операция.
  • 0 — GROUP BY в внешней памяти отключен.
примечание

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

Рекомендуемое значение — половина доступной системной памяти.

max_bytes_before_external_sort​

ТипПо умолчанию
UInt640

Облачное значение по умолчанию: половина объема памяти на каждую реплику.

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

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

  • Максимальный объем ОЗУ (в байтах), который может быть использован одной ORDER BY операцией. Рекомендуемое значение — половина доступной системной памяти
  • 0 — ORDER BY в внешней памяти отключен.

max_bytes_before_remerge_sort​

ТипПо умолчанию
UInt641000000000

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

max_bytes_in_distinct​

ТипПо умолчанию
UInt640

Максимальное количество байт состояния (в необработанных байтах) в памяти, которое используется хеш-таблицей при использовании DISTINCT.

max_bytes_in_join​

ТипПо умолчанию
UInt640

Максимальный размер в количестве байт хеш-таблицы, используемой при соединении таблиц.

Эта настройка применяется к операциям SELECT ... JOIN и к движку таблицы Join.

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

ClickHouse может выполнить различные действия, когда лимит достигнут. Используйте настройки join_overflow_mode, чтобы выбрать действие.

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

  • Положительное целое число.
  • 0 — Контроль памяти отключен.

max_bytes_in_set​

ТипПо умолчанию
UInt640

Максимальное количество байт (необработанных данных), используемое множеством в операторе IN, созданном из подзапроса.

max_bytes_ratio_before_external_group_by​

ТипПо умолчанию
Double0.5

Соотношение доступной памяти, разрешенной для GROUP BY. Как только оно будет достигнуто, внешняя память используется для агрегации.

Например, если установлено значение 0.6, GROUP BY позволит использовать 60% доступной памяти (для сервера/пользователя/слияний) в начале выполнения, после чего он начнет использовать внешнюю агрегацию.

max_bytes_ratio_before_external_sort​

ТипПо умолчанию
Double0.5

Соотношение доступной памяти, разрешенной для ORDER BY. Как только оно будет достигнуто, используется внешняя сортировка.

Например, если установлено значение 0.6, ORDER BY позволит использовать 60% доступной памяти (для сервера/пользователя/слияний) в начале выполнения, после чего он начнет использовать внешнюю сортировку.

max_bytes_to_read​

ТипПо умолчанию
UInt640

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

max_bytes_to_read_leaf​

ТипПо умолчанию
UInt640

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

Например, кластер состоит из 2 шардов, и каждый шард содержит таблицу с 100 байтами данных. Распределенный запрос, который должен прочитать все данные из обеих таблиц с установкой max_bytes_to_read=150, завершится с ошибкой, так как в сумме это будет 200 байт. Запрос с max_bytes_to_read_leaf=150 завершится успешно, так как узлы-листья прочитают максимум 100 байт.

Ограничение проверяется для каждого обрабатываемого блока данных.

примечание

Эта настройка нестабильна с prefer_localhost_replica=1.

max_bytes_to_sort​

ТипПо умолчанию
UInt640

Максимальное количество байт перед сортировкой. Если больше указанного количества необработанных байт должно быть обработано для операции ORDER BY, поведение будет определяться sort_overflow_mode, который по умолчанию установлен в throw.

max_bytes_to_transfer​

ТипПо умолчанию
UInt640

Максимальное количество байт (необработанных данных), которые могут быть переданы удаленному серверу или сохранены во временной таблице, когда выполняется GLOBAL IN/JOIN.

max_execution_time​

ТипПо умолчанию
Секунды0

Максимальное время выполнения запроса в секундах.

Параметр max_execution_time может быть немного запутанным. Он работает на основе интерполяции относительно скорости выполнения текущего запроса (это поведение контролируется параметром timeout_before_checking_execution_speed).

ClickHouse прервет запрос, если предполагаемое время выполнения превысит указанное max_execution_time. По умолчанию timeout_before_checking_execution_speed установлен на 10 секунд. Это означает, что через 10 секунд выполнения запроса ClickHouse начнет оценивать общее время выполнения. Если, например, max_execution_time установлен на 3600 секунд (1 час), ClickHouse завершит запрос, если оцененное время превысит этот лимит в 3600 секунд. Если вы установите timeout_before_checking_execution_speed в 0, ClickHouse будет использовать реальное время в качестве основы для max_execution_time.

Если время выполнения запроса превышает указанное количество секунд, поведение будет определяться параметром timeout_overflow_mode, который по умолчанию установлен на throw.

примечание

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

max_execution_time_leaf​

ТипПо умолчанию
Секунды0

Семантически аналогично max_execution_time, но применяется только на конечных узлах для распределенных или удаленных запросов.

Например, если мы хотим ограничить время выполнения на конечном узле до 10s, но не имеем ограничения на начальном узле, вместо того чтобы иметь max_execution_time в настройках вложенного подзапроса:

Мы можем использовать max_execution_time_leaf в качестве настроек запроса:

max_expanded_ast_elements​

ТипПо умолчанию
UInt64500000

Максимальный размер синтаксического дерева запроса в количестве узлов после расширения псевдонимов и звездочки.

max_fetch_partition_retries_count​

ТипПо умолчанию
UInt645

Количество попыток при получении партиции с другого узла.

max_final_threads​

ТипПо умолчанию
MaxThreads'auto(14)'

Устанавливает максимальное количество параллельных потоков для фазы чтения данных запроса SELECT с модификатором FINAL.

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

  • Положительное целое число.
  • 0 или 1 — Отключено. Запросы SELECT выполняются в одном потоке.

max_http_get_redirects​

ТипПо умолчанию
UInt640

Максимальное количество переходов HTTP GET редиректов, разрешенных. Обеспечивает дополнительные меры безопасности для предотвращения перенаправления ваших запросов на неожиданные сервисы с помощью вредоносного сервера.

Существуют случаи, когда внешний сервер перенаправляет на другой адрес, но этот адрес выглядит как внутренний в инфраструктуре компании, и отправив HTTP-запрос на внутренний сервер, вы могли бы запросить внутренний API из внутренней сети, минуя аутентификацию, или даже запрашивать другие сервисы, такие как Redis или Memcached. Когда у вас нет внутренней инфраструктуры (включая что-то, работащее на вашем localhost), или вы доверяете серверу, безопасно разрешать редиректы. Однако помните, если URL использует HTTP вместо HTTPS, и вы должны доверять не только удаленному серверу, но и вашему интернет-провайдеру и каждой сети посередине.

max_hyperscan_regexp_length​

ТипПо умолчанию
UInt640

Определяет максимальную длину для каждого регулярного выражения в функциях множественного совпадения hyperscan.

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

  • Положительное целое число.
  • 0 - Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. Также

max_hyperscan_regexp_total_length​

ТипПо умолчанию
UInt640

Устанавливает максимальную общую длину всех регулярных выражений в каждой функции множественного совпадения hyperscan.

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

  • Положительное целое число.
  • 0 - Длина не ограничена.

Пример

Запрос:

Результат:

Запрос:

Результат:

См. Также

max_insert_block_size​

ТипПо умолчанию
UInt641048449

Размер блоков (в количестве строк), которые формируются для вставки в таблицу. Эта настройка применяется только в тех случаях, когда сервер формирует блоки. Например, для INSERT через HTTP интерфейс сервер анализирует формат данных и формирует блоки указанного размера. Но при использовании clickhouse-client клиент сам разбирает данные, и настройка max_insert_block_size на сервере не влияет на размер вставляемых блоков. Настройка также не имеет значения при использовании INSERT SELECT, так как данные вставляются с использованием тех же блоков, которые формируются после SELECT.

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

max_insert_delayed_streams_for_parallel_write​

ТипПо умолчанию
UInt640

Максимальное количество потоков (колонок), для задержки финальной сброса части. По умолчанию - авто (100 в случае, если базовое хранилище поддерживает параллельную запись, например S3, и отключено в противном случае).

max_insert_threads​

ТипПо умолчанию
UInt640

Максимальное количество потоков для выполнения запроса INSERT SELECT.

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

  • 0 (или 1) — INSERT SELECT без параллельного выполнения.
  • Положительное целое число, большее 1.

Облачное значение по умолчанию: от 2 до 4, в зависимости от размера сервиса.

Параллельный INSERT SELECT имеет эффект только если часть SELECT выполняется параллельно, см. настройку max_threads. Более высокие значения приведут к более высокому использованию памяти.

max_joined_block_size_rows​

ТипПо умолчанию
UInt6465409

Максимальный размер блока для результата JOIN (если алгоритм соединения это поддерживает). 0 означает неограниченно.

max_limit_for_ann_queries​

Experimental feature. Learn more.
ТипПо умолчанию
UInt641000000

Запросы SELECT с LIMIT больше этого параметра не могут использовать индексы векторного сходства. Помогает предотвратить переполнение памяти в индексах векторного сходства.

max_live_view_insert_blocks_before_refresh​

Experimental feature. Learn more.
ТипПо умолчанию
UInt6464

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

max_local_read_bandwidth​

ТипПо умолчанию
UInt640

Максимальная скорость локальных чтений в байтах в секунду.

max_local_write_bandwidth​

ТипПо умолчанию
UInt640

Максимальная скорость локальных записей в байтах в секунду.

max_memory_usage​

ТипПо умолчанию
UInt640

Облачное значение по умолчанию: зависит от объема RAM на реплике.

Максимальный объем RAM, который можно использовать для выполнения запроса на одном сервере. Значение 0 означает неограничено.

Эта настройка не учитывает объем доступной памяти или общий объем памяти на машине. Ограничение применяется к одному запросу на одном сервере.

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

Использование памяти не отслеживается полностью для состояний следующих агрегатных функций с аргументами String и Array:

  • min
  • max
  • any
  • anyLast
  • argMin
  • argMax

Потребление памяти также ограничено параметрами max_memory_usage_for_user и max_server_memory_usage.

max_memory_usage_for_user​

ТипПо умолчанию
UInt640

Максимальный объем RAM для выполнения запросов пользователя на одном сервере. Значение 0 означает неограничено.

По умолчанию объем не ограничен (max_memory_usage_for_user = 0).

Смотрите также описание max_memory_usage.

Например, если вы хотите установить max_memory_usage_for_user на 1000 байт для пользователя с именем clickhouse_read, вы можете использовать оператор

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

max_network_bandwidth​

ТипПо умолчанию
UInt640

Ограничивает скорость обмена данными по сети в байтах в секунду. Эта настройка применяется к каждому запросу.

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

  • Положительное целое число.
  • 0 — Управление пропускной способностью отключено.

max_network_bandwidth_for_all_users​

ТипПо умолчанию
UInt640

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

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

  • Положительное целое число.
  • 0 — Управление скоростью данных отключено.

max_network_bandwidth_for_user​

ТипПо умолчанию
UInt640

Ограничивает скорость обмена данными по сети в байтах в секунду. Эта настройка применяется ко всем одновременно выполняемым запросам, выполняемым одним пользователем.

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

  • Положительное целое число.
  • 0 — Управление скоростью данных отключено.

max_network_bytes​

ТипПо умолчанию
UInt640

Ограничивает объем данных (в байтах), который принимается или передается по сети при выполнении запроса. Эта настройка применяется к каждому отдельному запросу.

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

  • Положительное целое число.
  • 0 — Управление объемом данных отключено.

max_number_of_partitions_for_independent_aggregation​

ТипПо умолчанию
UInt64128

Максимальное количество партиций в таблице для применения оптимизации.

max_parallel_replicas​

ТипПо умолчанию
NonZeroUInt641000

Максимальное количество реплик для каждой шард, когда выполняется запрос.

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

  • Положительное целое число.

Дополнительная информация

Эти параметры будут давать разные результаты в зависимости от используемых настроек.

примечание

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

Параллельная обработка с использованием ключа SAMPLE​

Запрос может обрабатываться быстрее, если он выполняется на нескольких серверах параллельно. Однако производительность запроса может ухудшиться в следующих случаях:

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

Параллельная обработка с использованием parallel_replicas_custom_key​

Эта настройка полезна для любой реплицированной таблицы.

max_parser_backtracks​

ТипПо умолчанию
UInt641000000

Максимальное количество возвратов парсера (как много раз он пробует разные альтернативы в процессе рекурсивного спуска парсинга).

max_parser_depth​

ТипПо умолчанию
UInt641000

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

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

  • Положительное целое число.
  • 0 — Глубина рекурсии не ограничена.

max_parsing_threads​

ТипПо умолчанию
MaxThreads'auto(14)'

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

max_partition_size_to_drop​

ТипПо умолчанию
UInt6450000000000

Ограничение на удаление партиций за время выполнения запроса. Значение 0 означает, что вы можете удалять партиции без каких-либо ограничений.

Облачное значение по умолчанию: 1 ТБ.

примечание

Эта настройка запроса перезаписывает соответствующую серверную настройку, см. max_partition_size_to_drop

max_partitions_per_insert_block​

ТипПо умолчанию
UInt64100

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

  • Положительное целое число.
  • 0 — Неограниченное количество партиций.

Детали

При вставке данных ClickHouse вычисляет количество партиций в вставляемом блоке. Если количество партиций превышает max_partitions_per_insert_block, ClickHouse либо записывает предупреждение, либо выбрасывает исключение в зависимости от throw_on_max_partitions_per_insert_block. Исключения имеют следующий текст:

"Слишком много партиций для одного INSERT блока (partitions_count партиций, лимит - " + toString(max_partitions) + "). Лимит контролируется настройкой max_partitions_per_insert_block. Большое количество партиций является общим заблуждением. Это приведет к серьезному отрицательному влиянию на производительность, включая медленный запуск сервера, медленные запросы INSERT и медленные запросы SELECT. Рекомендуемое общее количество партиций для таблицы - менее 1000..10000. Обратите внимание, что партиционирование не предназначено для ускорения запросов SELECT (ORDER BY ключа достаточно, чтобы сделать диапазонные запросы быстрыми). Партиции предназначены для манипуляции данными (DROP PARTITION и т. д.)."

примечание

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

max_partitions_to_read​

ТипПо умолчанию
Int64-1

Ограничивает максимальное количество партиций, которые могут быть доступны в одном запросе.

Значение настройки, указанное при создании таблицы, может быть переопределено через уровень настройки запроса.

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

  • Положительное целое число.
  • -1 - неограничено (по умолчанию).
примечание

Вы также можете указать настройку MergeTree max_partitions_to_read в настройках таблиц.

max_parts_to_move​

ТипПо умолчанию
UInt641000

Ограничивает количество частей, которые могут быть перемещены в одном запросе. Ноль означает неограниченно.

max_query_size​

ТипПо умолчанию
UInt64262144

Максимальное количество байтов строки запроса, обрабатываемой SQL парсером. Данные в предлоге VALUES запросов INSERT обрабатываются отдельным парсером потока (который потребляет O(1) RAM) и не затрагиваются этим ограничением.

примечание

max_query_size не может быть установлен внутри SQL-запроса (например, SELECT now() SETTINGS max_query_size=10000), потому что ClickHouse нужно выделить буфер для разбора запроса, и размер этого буфера определяется настройкой max_query_size, которую необходимо настроить до выполнения запроса.

max_read_buffer_size​

ТипПо умолчанию
UInt641048576

Максимальный размер буфера для чтения с файловой системы.

max_read_buffer_size_local_fs​

ТипПо умолчанию
UInt64131072

Максимальный размер буфера для чтения с локальной файловой системы. Если установить в 0, будет использоваться max_read_buffer_size.

max_read_buffer_size_remote_fs​

ТипПо умолчанию
UInt640

Максимальный размер буфера для чтения с удаленной файловой системы. Если установить в 0, будет использоваться max_read_buffer_size.

max_recursive_cte_evaluation_depth​

ТипПо умолчанию
UInt641000

Максимальный лимит на глубину оценки рекурсивных CTE.

max_remote_read_network_bandwidth​

ТипПо умолчанию
UInt640

Максимальная скорость обмена данными по сети в байтах в секунду для чтения.

max_remote_write_network_bandwidth​

ТипПо умолчанию
UInt640

Максимальная скорость обмена данными по сети в байтах в секунду для записи.

max_replica_delay_for_distributed_queries​

ТипПо умолчанию
UInt64300

Отключает отстающие реплики для распределенных запросов. См. Репликация.

Устанавливает время в секундах. Если задержка реплики больше или равна установленному значению, эта реплика не используется.

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

  • Положительное целое число.
  • 0 — Задержки реплик не проверяются.

Чтобы предотвратить использование любой реплики с ненулевой задержкой, установите этот параметр на 1.

Используется при выполнении SELECT из распределенной таблицы, указывающей на реплицированные таблицы.

max_result_bytes​

ТипПо умолчанию
UInt640

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

Предостережения

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

осторожно

Эта настройка является довольно низкоуровневой и должна использоваться с осторожностью.

max_result_rows​

ТипПо умолчанию
UInt640

Облачное значение по умолчанию: 0.

Ограничивает количество строк в результате. Также проверяется для подзапросов и на удаленных серверах при выполнении частей распределенного запроса. Ограничение не применяется, когда значение равно 0.

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

max_rows_in_distinct​

ТипПо умолчанию
UInt640

Максимальное количество различных строк при использовании DISTINCT.

max_rows_in_join​

ТипПо умолчанию
UInt640

Ограничивает количество строк в хеш-таблице, используемой при соединении таблиц.

Эта настройка применяется к операциям SELECT ... JOIN и к движку таблиц Join.

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

ClickHouse может продолжить с различными действиями, когда лимит достигнут. Используйте настройку join_overflow_mode, чтобы выбрать действие.

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

  • Положительное целое число.
  • 0 — Неограниченное количество строк.

max_rows_in_set​

ТипПо умолчанию
UInt640

Максимальное количество строк для набора данных в операторе IN, сформированном из подзапроса.

max_rows_in_set_to_optimize_join​

ТипПо умолчанию
UInt640

Максимальный размер набора для фильтрации соединенных таблиц по наборам строк друг друга перед соединением.

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

  • 0 — Отключить.
  • Любое положительное целое число.

max_rows_to_group_by​

ТипПо умолчанию
UInt640

Максимальное количество уникальных ключей, полученных из агрегации. Эта настройка позволяет ограничить использование памяти при агрегации.

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

max_rows_to_read​

ТипПо умолчанию
UInt640

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

max_rows_to_read_leaf​

ТипПо умолчанию
UInt640

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

Например, кластер состоит из 2 шард, и каждая шард содержит таблицу с 100 строками. Распределенный запрос, который должен прочитать все данные из обеих таблиц с настройкой max_rows_to_read=150, завершится ошибкой, так как всего будет 200 строк. Запрос с max_rows_to_read_leaf=150 будет успешным, так как листовые узлы будут читать максимум 100 строк.

Ограничение проверяется для каждого обработанного чанка данных.

примечание

Эта настройка нестабильна с prefer_localhost_replica=1.

max_rows_to_sort​

ТипПо умолчанию
UInt640

Максимальное количество строк до сортировки. Это позволяет ограничить использование памяти при сортировке. Если необходимо обработать более указанного количества записей для операции ORDER BY, поведение будет определяться sort_overflow_mode, который по умолчанию установлен на throw.

max_rows_to_transfer​

ТипПо умолчанию
UInt640

Максимальный размер (в строках), который может быть передан на удаленный сервер или сохранен во временной таблице, когда выполняется раздел GLOBAL IN/JOIN.

max_sessions_for_user​

ТипПо умолчанию
UInt640

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

Пример:

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

  • Положительное целое число.
  • 0 - бесконечное количество одновременных сессий (по умолчанию).

max_size_to_preallocate_for_aggregation​

ТипПо умолчанию
UInt641000000000000

На сколько элементов разрешается предварительно выделять место во всех хеш-таблицах в целом перед агрегацией.

max_size_to_preallocate_for_joins​

ТипПо умолчанию
UInt641000000000000

На сколько элементов разрешается предварительно выделять место во всех хеш-таблицах в целом перед соединениями.

max_streams_for_merge_tree_reading​

ТипПо умолчанию
UInt640

Если не ноль, ограничьте количество потоков чтения для таблицы MergeTree.

max_streams_multiplier_for_merge_tables​

ТипПо умолчанию
Float5

Запрашивает больше потоков при чтении из таблицы Merge. Потоки будут распределены по таблицам, которые использует таблица Merge. Это позволяет более равномерно распределить работу между потоками и особенно полезно, когда объединенные таблицы различаются по размеру.

max_streams_to_max_threads_ratio​

ТипПо умолчанию
Float1

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

max_subquery_depth​

ТипПо умолчанию
UInt64100

Если запрос содержит более указанного количества вложенных подзапросов, выбрасывает исключение.

подсказка

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

max_table_size_to_drop​

ТипПо умолчанию
UInt6450000000000

Ограничение на удаление таблиц за время выполнения запроса. Значение 0 означает, что вы можете удалять все таблицы без каких-либо ограничений.

Облачное значение по умолчанию: 1 ТБ.

примечание

Эта настройка запроса перезаписывает соответствующую серверную настройку, см. max_table_size_to_drop

max_temporary_columns​

ТипПо умолчанию
UInt640

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

подсказка

Эта настройка полезна для предотвращения чрезмерно сложных запросов.

Значение 0 означает неограничено.

max_temporary_data_on_disk_size_for_query​

ТипПо умолчанию
UInt640

Максимальное количество данных, потребляемых временными файлами на диске в байтах для всех одновременно выполняемых запросов.

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

  • Положительное целое число.
  • 0 — неограничено (по умолчанию).

max_temporary_data_on_disk_size_for_user​

ТипПо умолчанию
UInt640

Максимальное количество данных, потребляемых временными файлами на диске в байтах для всех одновременно выполняемых пользовательских запросов.

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

  • Положительное целое число.
  • 0 — неограничено (по умолчанию).

max_temporary_non_const_columns​

ТипПо умолчанию
UInt640

Как и max_temporary_columns, максимальное количество временных колонок, которые должны храниться в RAM одновременно при выполнении запроса, но без учета постоянных колонок.

примечание

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

max_threads​

ТипПо умолчанию
MaxThreads'auto(14)'

Максимальное количество потоков для обработки запросов, исключая потоки для извлечения данных с удаленных серверов (см. параметр 'max_distributed_connections').

Этот параметр применяется к потокам, которые выполняют одни и те же этапы пайплайна обработки запросов параллельно. Например, при чтении из таблицы, если возможно одновременно оценивать выражения с функциями, фильтровать с WHERE и производить предагрегацию для GROUP BY, используя по крайней мере 'max_threads' количество потоков, то будут использоваться 'max_threads'.

Для запросов, которые быстро завершаются из-за LIMIT, вы можете установить более низкое значение 'max_threads'. Например, если необходимое количество записей находится в каждом блоке, и max_threads = 8, то будет извлечено 8 блоков, хотя одной записи было бы достаточно.

Чем меньше значение max_threads, тем меньше потребляется памяти.

max_threads_for_indexes​

ТипПо умолчанию
UInt640

Максимальное количество потоков для обработки индексов.

max_untracked_memory​

ТипПо умолчанию
UInt644194304

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

memory_overcommit_ratio_denominator​

ТипПо умолчанию
UInt641073741824

Он представляет собой мягкий лимит памяти, когда достигнут жесткий лимит на глобальном уровне. Это значение используется для вычисления коэффициента перерасхода для запроса. Ноль означает пропуск запроса. Узнайте больше о перерасходе памяти.

memory_overcommit_ratio_denominator_for_user​

ТипПо умолчанию
UInt641073741824

Он представляет собой мягкий лимит памяти, когда достигнут жесткий лимит на уровне пользователя. Это значение используется для вычисления коэффициента перерасхода для запроса. Ноль означает пропуск запроса. Узнайте больше о перерасходе памяти.

memory_profiler_sample_max_allocation_size​

ТипПо умолчанию
UInt640

Собирает случайные выделения памяти размером меньше или равным указанному значению с вероятностью, равной memory_profiler_sample_probability. 0 означает отключение. Возможно, вы захотите установить 'max_untracked_memory' в 0, чтобы этот предел работал должным образом.

memory_profiler_sample_min_allocation_size​

ТипПо умолчанию
UInt640

Собирает случайные выделения памяти размером больше или равным указанному значению с вероятностью, равной memory_profiler_sample_probability. 0 означает отключение. Возможно, вы захотите установить 'max_untracked_memory' в 0, чтобы этот предел работал должным образом.

memory_profiler_sample_probability​

ТипПо умолчанию
Float0

Собирает случайные выделения и освобождения памяти и записывает их в system.trace_log с 'MemorySample' trace_type. Вероятность относится к каждому выделению/освобождению вне зависимости от размера выделения (можно изменить с помощью memory_profiler_sample_min_allocation_size и memory_profiler_sample_max_allocation_size). Обратите внимание, что выборка происходит только тогда, когда объем неучтенной памяти превышает 'max_untracked_memory'. Возможно, вам потребуется установить 'max_untracked_memory' в 0 для более тонкой выборки.

memory_profiler_step​

ТипПо умолчанию
UInt644194304

Устанавливает шаг анализатора памяти. Каждый раз, когда использование памяти запросом становится больше каждого следующего шага в байтах, анализатор памяти будет собирать стек вызовов выделения и записывать его в trace_log.

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

  • Положительное целое число в байтах.

  • 0 для отключения анализатора памяти.

memory_tracker_fault_probability​

ТипПо умолчанию
Float0

Для тестирования безопасности исключений - выбрасывать исключение каждый раз, когда вы выделяете память с заданной вероятностью.

memory_usage_overcommit_max_wait_microseconds​

ТипПо умолчанию
UInt645000000

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

merge_table_max_tables_to_look_for_schema_inference​

ТипПо умолчанию
UInt641000

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

merge_tree_coarse_index_granularity​

ТипПо умолчанию
UInt648

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

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

  • Любое положительное четное целое число.

merge_tree_compact_parts_min_granules_to_multibuffer_read​

ClickHouse Cloud only
ТипПо умолчанию
UInt6416

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

merge_tree_determine_task_size_by_prewhere_columns​

ТипПо умолчанию
Bool1

Использовать только размер колонок prewhere для определения размера задачи чтения.

merge_tree_max_bytes_to_use_cache​

ТипПо умолчанию
UInt642013265920

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

Кэш некорректированных блоков хранит данные, извлеченные для запросов. ClickHouse использует этот кэш для ускорения ответов на повторяемые небольшие запросы. Эта настройка защищает кэш от разрушения запросами, которые читают большой объем данных. Настройка сервера uncompressed_cache_size определяет размер кэша некорректированных блоков.

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

  • Любое положительное целое число.

merge_tree_max_rows_to_use_cache​

ТипПо умолчанию
UInt641048576

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

Кэш некорректированных блоков хранит данные, извлеченные для запросов. ClickHouse использует этот кэш для ускорения ответов на повторяемые небольшие запросы. Эта настройка защищает кэш от разрушения запросами, которые читают большой объем данных. Настройка сервера uncompressed_cache_size определяет размер кэша некорректированных блоков.

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

  • Любое положительное целое число.

merge_tree_min_bytes_for_concurrent_read​

ТипПо умолчанию
UInt64251658240

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

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

  • Положительное целое число.

merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem​

ТипПо умолчанию
UInt640

Минимальное количество байт для чтения из одного файла перед тем, как движок MergeTree сможет параллелизовать чтение при чтении из удаленной файловой системы. Мы не рекомендуем использовать эту настройку.

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

  • Положительное целое число.

merge_tree_min_bytes_for_seek​

ТипПо умолчанию
UInt640

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

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

  • Любое положительное целое число.

merge_tree_min_bytes_per_task_for_remote_reading​

ТипПо умолчанию
UInt642097152

Минимальное количество байт для чтения на задачу.

merge_tree_min_read_task_size​

ТипПо умолчанию
UInt648

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

merge_tree_min_rows_for_concurrent_read​

ТипПо умолчанию
UInt64163840

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

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

  • Положительное целое число.

merge_tree_min_rows_for_concurrent_read_for_remote_filesystem​

ТипПо умолчанию
UInt640

Минимальное количество строк для чтения из одного файла перед тем, как движок MergeTree сможет параллелизовать чтение при чтении из удаленной файловой системы. Мы не рекомендуем использовать эту настройку.

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

  • Положительное целое число.

merge_tree_min_rows_for_seek​

ТипПо умолчанию
UInt640

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

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

  • Любое положительное целое число.

merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability​

ТипПо умолчанию
Float0

Для тестирования PartsSplitter - разделяет диапазоны чтения на пересекающиеся и непересекающиеся каждый раз, когда вы читаете из MergeTree с заданной вероятностью.

merge_tree_use_const_size_tasks_for_remote_reading​

ТипПо умолчанию
Bool1

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

merge_tree_use_deserialization_prefixes_cache​

ТипПо умолчанию
Bool1

Включает кэширование метаданных колонок из префиксов файла при чтении из широких частей в MergeTree.

merge_tree_use_prefixes_deserialization_thread_pool​

ТипПо умолчанию
Bool1

Включает использование пула потоков для параллельного чтения префиксов в широких частях MergeTree. Размер этого пула потоков контролируется серверной настройкой max_prefixes_deserialization_thread_pool_size.

merge_tree_use_v1_object_and_dynamic_serialization​

ТипПо умолчанию
Bool0

Когда включено, версия сериализации V1 типов JSON и Dynamic будет использоваться в MergeTree вместо V2. Изменение этой настройки вступает в силу только после перезапуска сервера.

metrics_perf_events_enabled​

ТипПо умолчанию
Bool0

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

metrics_perf_events_list​

Список показателей производительности, разделенных запятыми, которые будут измеряться во время выполнения запросов. Пустой означает все события. Смотрите PerfEventInfo в источниках для доступных событий.

min_bytes_to_use_direct_io​

ТипПо умолчанию
UInt640

Минимальный объем данных, необходимый для использования прямого ввода-вывода к диску хранилища.

ClickHouse использует эту настройку при чтении данных из таблиц. Если общий объем хранимых данных для чтения превышает min_bytes_to_use_direct_io байт, ClickHouse читает данные с диска хранилища с опцией O_DIRECT.

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

  • 0 — Прямой ввод-вывод отключен.
  • Положительное целое число.

min_bytes_to_use_mmap_io​

ТипПо умолчанию
UInt640

Это экспериментальная настройка. Устанавливает минимальный объем памяти для чтения больших файлов без копирования данных из ядра в пространство пользователя. Рекомендуемый предел составляет около 64 МБ, потому что mmap/munmap работает медленно. Это имеет смысл только для больших файлов и помогает только в том случае, если данные находятся в кэше страниц.

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

  • Положительное целое число.
  • 0 — Большие файлы читаются только с копированием данных из ядра в пространство пользователя.

min_chunk_bytes_for_parallel_parsing​

ТипПо умолчанию
NonZeroUInt6410485760
  • Тип: беззнаковое целое
  • Значение по умолчанию: 1 МБ

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

min_compress_block_size​

ТипПо умолчанию
UInt6465536

Для таблиц MergeTree. Чтобы уменьшить задержку при обработке запросов, блок компрессируется при записи следующей метки, если его размер составляет не менее min_compress_block_size. По умолчанию 65,536.

Фактический размер блока, если необработанные данные меньше max_compress_block_size, не меньше этого значения и не меньше объема данных для одной метки.

Рассмотрим пример. Предположим, что index_granularity был установлен на 8192 во время создания таблицы.

Мы записываем колонку типа UInt32 (4 байта на значение). При записи 8192 строк общее будет 32 КБ данных. Поскольку min_compress_block_size = 65,536, сжатый блок будет сформирован для каждых двух меток.

Мы записываем колонку URL с типом String (средний размер 60 байт на значение). При записи 8192 строк среднее значение будет чуть менее 500 КБ данных. Поскольку это больше 65,536, сжатый блок будет сформирован для каждой метки. В этом случае, при чтении данных с диска в диапазоне одной метки, дополнительные данные не будут разжаты.

примечание

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

min_count_to_compile_aggregate_expression​

ТипПо умолчанию
UInt643

Минимальное количество идентичных агрегатных выражений, чтобы запустить JIT-компиляцию. Работает только если включена настройка compile_aggregate_expressions.

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

  • Положительное целое число.
  • 0 — Идентичные агрегатные выражения всегда JIT-компилируются.

min_count_to_compile_expression​

ТипПо умолчанию
UInt643

Минимальное количество выполнения одного и того же выражения, прежде чем оно будет скомпилировано.

min_count_to_compile_sort_description​

ТипПо умолчанию
UInt643

Количество идентичных описаний сортировки, прежде чем они будут JIT-компилированы.

min_execution_speed​

ТипПо умолчанию
UInt640

Минимальная скорость выполнения в строках в секунду. Проверяется на каждом блоке данных, когда истечет timeout_before_checking_execution_speed. Если скорость выполнения ниже, будет выброшено исключение.

min_execution_speed_bytes​

ТипПо умолчанию
UInt640

Минимальное количество байт выполнения в секунду. Проверяется на каждом блоке данных, когда истечет timeout_before_checking_execution_speed. Если скорость выполнения ниже, будет выброшено исключение.

min_external_sort_block_bytes​

ТипПо умолчанию
UInt64104857600

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

min_external_table_block_size_bytes​

ТипПо умолчанию
UInt64268402944

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

min_external_table_block_size_rows​

ТипПо умолчанию
UInt641048449

Сжимает блоки, переданные во внешнюю таблицу, до указанного размера в строках, если блоки недостаточно велики.

min_free_disk_bytes_to_perform_insert​

ТипПо умолчанию
UInt640

Минимальное количество свободного места на диске в байтах, чтобы выполнить вставку.

min_free_disk_ratio_to_perform_insert​

ТипПо умолчанию
Float0

Минимальное отношение свободного дискового пространства для выполнения вставки.

min_free_disk_space_for_temporary_data​

ТипПо умолчанию
UInt640

Минимальное дисковое пространство, которое нужно сохранить во время записи временных данных, используемых в внешней сортировке и агрегации.

min_hit_rate_to_use_consecutive_keys_optimization​

ТипПо умолчанию
Float0.5

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

min_insert_block_size_bytes​

ТипПо умолчанию
UInt64268402944

Устанавливает минимальное количество байт в блоке, который может быть вставлен в таблицу с помощью запроса INSERT. Более мелкие блоки сжимаются в более крупные.

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

  • Положительное целое число.
  • 0 — Сжатие отключено.

min_insert_block_size_bytes_for_materialized_views​

ТипПо умолчанию
UInt640

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

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

  • Любое положительное целое число.
  • 0 — Сжатие отключено.

См. также

min_insert_block_size_rows​

ТипПо умолчанию
UInt641048449

Устанавливает минимальное количество строк в блоке, которые могут быть вставлены в таблицу с помощью запроса INSERT. Более мелкие блоки сжимаются в более крупные.

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

  • Положительное целое число.
  • 0 — Сжатие отключено.

min_insert_block_size_rows_for_materialized_views​

ТипПо умолчанию
UInt640

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

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

  • Любое положительное целое число.
  • 0 — Сжатие отключено.

См. также

min_joined_block_size_bytes​

ТипПо умолчанию
UInt64524288

Минимальный размер блока для результата JOIN (если алгоритм соединения поддерживает это). 0 означает неограниченный.

mongodb_throw_on_unsupported_query​

ТипПо умолчанию
Bool1

Если включено, таблицы MongoDB вернут ошибку, когда запрос MongoDB не может быть построен. В противном случае ClickHouse считывает полную таблицу и обрабатывает ее локально. Эта опция не применяется, когда 'allow_experimental_analyzer=0'.

move_all_conditions_to_prewhere​

ТипПо умолчанию
Bool1

Переместить все подходящие условия из WHERE в PREWHERE.

move_primary_key_columns_to_end_of_prewhere​

ТипПо умолчанию
Bool1

Переместить условия PREWHERE, содержащие колонки первичного ключа, в конец цепочки AND. Вероятно, эти условия учитываются при анализе первичного ключа и, таким образом, не будут способствовать фильтрации PREWHERE.

multiple_joins_try_to_keep_original_names​

ТипПо умолчанию
Bool0

Не добавлять псевдонимы в список выражений верхнего уровня при переписывании нескольких соединений.

mutations_execute_nondeterministic_on_initiator​

ТипПо умолчанию
Bool0

Если true, постоянные недетерминированные функции (например, функция now()) выполняются на инициаторе и заменяются на литералы в запросах UPDATE и DELETE. Это помогает поддерживать данные синхронизированными на репликах во время выполнения мутаций с постоянными недетерминированными функциями. Значение по умолчанию: false.

mutations_execute_subqueries_on_initiator​

ТипПо умолчанию
Bool0

Если true, скалярные подзапросы выполняются на инициаторе и заменяются на литералы в запросах UPDATE и DELETE. Значение по умолчанию: false.

mutations_max_literal_size_to_replace​

ТипПо умолчанию
UInt6416384

Максимальный размер сериализованного литерала в байтах для замены в запросах UPDATE и DELETE. Действует только если включена хотя бы одна из двух вышеуказанных настроек. Значение по умолчанию: 16384 (16 KiB).

mutations_sync​

ТипПо умолчанию
UInt640

Позволяет выполнять запросы ALTER TABLE ... UPDATE|DELETE|MATERIALIZE INDEX|MATERIALIZE PROJECTION|MATERIALIZE COLUMN|MATERIALIZE STATISTICS (мутации) синхронно.

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

  • 0 - Мутации выполняются асинхронно.
  • 1 - Запрос ждет завершения всех мутаций на текущем сервере.
  • 2 - Запрос ждет завершения всех мутаций на всех репликах (если они существуют).

mysql_datatypes_support_level​

Определяет, как типы MySQL преобразуются в соответствующие типы ClickHouse. Список, разделенный запятыми, в любой комбинации decimal, datetime64, date2Date32 или date2String.

  • decimal: преобразовать типы NUMERIC и DECIMAL в Decimal, когда это позволяет точность.
  • datetime64: преобразовать типы DATETIME и TIMESTAMP в DateTime64 вместо DateTime, когда точность не равна 0.
  • date2Date32: преобразовать DATE в Date32 вместо Date. Имеет приоритет над date2String.
  • date2String: преобразовать DATE в String вместо Date. Переопределяется datetime64.

mysql_map_fixed_string_to_text_in_show_columns​

ТипПо умолчанию
Bool1

Когда включено, тип данных ClickHouse FixedString будет отображаться как TEXT в SHOW COLUMNS.

Действует только при подключении через протокол MySQL.

  • 0 - Используйте BLOB.
  • 1 - Используйте TEXT.

mysql_map_string_to_text_in_show_columns​

ТипПо умолчанию
Bool1

Когда включено, тип данных ClickHouse String будет отображаться как TEXT в SHOW COLUMNS.

Действует только при подключении через протокол MySQL.

  • 0 - Используйте BLOB.
  • 1 - Используйте TEXT.

mysql_max_rows_to_insert​

ТипПо умолчанию
UInt6465536

Максимальное количество строк в пакетной вставке MySQL для движка хранения MySQL.

network_compression_method​

ТипПо умолчанию
StringLZ4

Устанавливает метод сжатия данных, который используется для связи между серверами и между сервером и clickhouse-client.

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

  • LZ4 — устанавливает метод сжатия LZ4.
  • ZSTD — устанавливает метод сжатия ZSTD.

См. также

network_zstd_compression_level​

ТипПо умолчанию
Int641

Регулирует уровень сжатия ZSTD. Используется только когда network_compression_method установлен на ZSTD.

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

  • Положительное целое число от 1 до 15.

normalize_function_names​

ТипПо умолчанию
Bool1

Нормализует имена функций до их канонических имен.

number_of_mutations_to_delay​

ТипПо умолчанию
UInt640

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

number_of_mutations_to_throw​

ТипПо умолчанию
UInt640

Если в изменяемой таблице содержится как минимум столько же незавершенных мутаций, выбросить исключение 'Слишком много мутаций ...'. 0 - отключено.

odbc_bridge_connection_pool_size​

ТипПо умолчанию
UInt6416

Размер пула соединений для каждой строки настроек соединения в ODBC мосту.

odbc_bridge_use_connection_pooling​

ТипПо умолчанию
Bool1

Использовать пул соединений в ODBC мосту. Если установлено значение false, новое соединение создается каждый раз.

offset​

ТипПо умолчанию
UInt640

Устанавливает количество строк, которые следует пропустить перед началом возврата строк из запроса. Он корректирует смещение, заданное клаузой OFFSET, так что эти два значения суммируются.

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

  • 0 — Никакие строки не пропускаются.
  • Положительное целое число.

Пример

Входная таблица:

Запрос:

Результат:

opentelemetry_start_trace_probability​

ТипПо умолчанию
Float0

Устанавливает вероятность того, что ClickHouse может запустить трассировку для выполненных запросов (если не предоставлен родительский контекст трассировки).

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

  • 0 — Трассировка для всех выполненных запросов отключена (если не предоставлен родительский контекст трассировки).
  • Положительное число с плавающей запятой в диапазоне [0..1]. Например, если значение настройки равно 0.5, ClickHouse может запустить трассировку в среднем для половины запросов.
  • 1 — Трассировка для всех выполненных запросов включена.

opentelemetry_trace_processors​

ТипПо умолчанию
Bool0

Собирать OpenTelemetry диапазоны для процессоров.

optimize_aggregation_in_order​

ТипПо умолчанию
Bool0

Включает оптимизацию GROUP BY в запросах SELECT для агрегирования данных в соответствующем порядке в таблицах MergeTree.

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

  • 0 — Оптимизация GROUP BY отключена.
  • 1 — Оптимизация GROUP BY включена.

См. также

optimize_aggregators_of_group_by_keys​

ТипПо умолчанию
Bool1

Устраняет агрегаторы min/max/any/anyLast ключей GROUP BY в разделе SELECT.

optimize_and_compare_chain​

ТипПо умолчанию
Bool1

Заполняет константное сравнение в цепочках AND для усиления возможностей фильтрации. Поддерживает операторы <, <=, >, >=, = и их комбинации. Например, (a < b) AND (b < c) AND (c < 5) будет (a < b) AND (b < c) AND (c < 5) AND (b < 5) AND (a < 5).

optimize_append_index​

ТипПо умолчанию
Bool0

Используйте ограничения, чтобы добавить условие индекса. По умолчанию false.

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

  • true, false.

optimize_arithmetic_operations_in_aggregate_functions​

ТипПо умолчанию
Bool1

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

optimize_count_from_files​

ТипПо умолчанию
Bool1

Включает или отключает оптимизацию подсчета количества строк из файлов в разных входных форматах. Применяется к таблицам/движкам функции file/s3/url/hdfs/azureBlobStorage.

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

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

optimize_distinct_in_order​

ТипПо умолчанию
Bool1

Включить оптимизацию DISTINCT, если некоторые колонки в DISTINCT формируют префикс сортировки. Например, префикс ключа сортировки в дереве объединения или операторе ORDER BY.

optimize_distributed_group_by_sharding_key​

ТипПо умолчанию
Bool1

Оптимизирует запросы GROUP BY sharding_key, избегая затратной агрегации на инициирующем сервере (что снизит использование памяти для запроса на инициирующем сервере).

Поддерживаются следующие типы запросов (и все их комбинации):

  • SELECT DISTINCT [..., ]sharding_key[, ...] FROM dist
  • SELECT ... FROM dist GROUP BY sharding_key[, ...]
  • SELECT ... FROM dist GROUP BY sharding_key[, ...] ORDER BY x
  • SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1
  • SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1 BY x

Не поддерживаются следующие типы запросов (поддержка некоторых из них может быть добавлена позже):

  • SELECT ... GROUP BY sharding_key[, ...] WITH TOTALS
  • SELECT ... GROUP BY sharding_key[, ...] WITH ROLLUP
  • SELECT ... GROUP BY sharding_key[, ...] WITH CUBE
  • SELECT ... GROUP BY sharding_key[, ...] SETTINGS extremes=1

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

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

Смотрите также:

примечание

На данный момент это требует optimize_skip_unused_shards (причина в том, что однажды это может быть включено по умолчанию, и оно будет работать корректно только если данные были вставлены через распределённую таблицу, т.е. данные распределены в соответствии с sharding_key).

optimize_extract_common_expressions​

ТипПо умолчанию
Bool1

Разрешает извлечение общих выражений из дизъюнкций в WHERE, PREWHERE, ON, HAVING и QUALIFY выражениях. Логическое выражение, такое как (A AND B) OR (A AND C), может быть переписано как A AND (B OR C), что может помочь использовать:

  • индексы в простых фильтрах
  • оптимизацию перекрёстного к внутреннему соединению

optimize_functions_to_subcolumns​

ТипПо умолчанию
Bool1

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

Эти функции могут быть преобразованы:

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

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

optimize_group_by_constant_keys​

ТипПо умолчанию
Bool1

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

optimize_group_by_function_keys​

ТипПо умолчанию
Bool1

Устраняет функции других ключей в секции GROUP BY.

optimize_if_chain_to_multiif​

ТипПо умолчанию
Bool0

Заменяет цепочки if(cond1, then1, if(cond2, ...)) на multiIf. В настоящее время это не выгодно для числовых типов.

optimize_if_transform_strings_to_enum​

ТипПо умолчанию
Bool0

Заменяет аргументы строкового типа в If и Transform на enum. Отключено по умолчанию, так как это может привести к несогласованному изменению в распределённом запросе, что приведёт к его сбою.

optimize_injective_functions_in_group_by​

ТипПо умолчанию
Bool1

Заменяет инъективные функции их аргументами в секции GROUP BY.

optimize_injective_functions_inside_uniq​

ТипПо умолчанию
Bool1

Удаляет инъективные функции с одним аргументом внутри функций uniq*().

optimize_min_equality_disjunction_chain_length​

ТипПо умолчанию
UInt643

Минимальная длина выражения expr = x1 OR ... expr = xN для оптимизации.

optimize_min_inequality_conjunction_chain_length​

ТипПо умолчанию
UInt643

Минимальная длина выражения expr <> x1 AND ... expr <> xN для оптимизации.

optimize_move_to_prewhere​

ТипПо умолчанию
Bool1

Включает или отключает автоматическую оптимизацию PREWHERE в SELECT запросах.

Работает только для *MergeTree таблиц.

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

  • 0 — Автоматическая оптимизация PREWHERE отключена.
  • 1 — Автоматическая оптимизация PREWHERE включена.

optimize_move_to_prewhere_if_final​

ТипПо умолчанию
Bool0

Включает или отключает автоматическую оптимизацию PREWHERE в SELECT запросах с модификатором FINAL.

Работает только для *MergeTree таблиц.

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

  • 0 — Автоматическая оптимизация PREWHERE в SELECT запросах с модификатором FINAL отключена.
  • 1 — Автоматическая оптимизация PREWHERE в SELECT запросах с модификатором FINAL включена.

Смотрите также

optimize_multiif_to_if​

ТипПо умолчанию
Bool1

Заменяет 'multiIf' с единственным условием на 'if'.

optimize_normalize_count_variants​

ТипПо умолчанию
Bool1

Переписывает агрегатные функции, которые семантически эквивалентны count(), как count().

optimize_on_insert​

ТипПо умолчанию
Bool1

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

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

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

Пример

Разница между включённым и отключённым:

Запрос:

Результат:

Обратите внимание, что эта настройка влияет на поведение материализованного представления.

optimize_or_like_chain​

ТипПо умолчанию
Bool0

Оптимизирует множество OR LIKE в multiMatchAny. Эта оптимизация не должна быть включена по умолчанию, так как она нарушает анализ индекса в некоторых случаях.

optimize_read_in_order​

ТипПо умолчанию
Bool1

Включает оптимизацию ORDER BY в SELECT запросах для чтения данных из MergeTree таблиц.

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

  • 0 — Оптимизация ORDER BY отключена.
  • 1 — Оптимизация ORDER BY включена.

Смотрите также

optimize_read_in_window_order​

ТипПо умолчанию
Bool1

Включает оптимизацию ORDER BY в окне для чтения данных в соответствующем порядке в таблицах MergeTree.

optimize_redundant_functions_in_order_by​

ТипПо умолчанию
Bool1

Удаляет функции из ORDER BY, если их аргумент также присутствует в ORDER BY.

optimize_respect_aliases​

ТипПо умолчанию
Bool1

Если установлено в true, будет учтён псевдоним в WHERE/GROUP BY/ORDER BY, что поможет с обрезкой партиций/вторичными индексами/оптимизацией агрегации/оптимизацией чтения в порядке/оптимизацией тривиального счёта.

optimize_rewrite_aggregate_function_with_if​

ТипПо умолчанию
Bool1

Переписывает агрегатные функции с выражением if в качестве аргумента, когда они логически эквивалентны. Например, avg(if(cond, col, null)) может быть переписано как avgOrNullIf(cond, col). Это может улучшить производительность.

примечание

Поддерживается только с анализатором (enable_analyzer = 1).

optimize_rewrite_array_exists_to_has​

ТипПо умолчанию
Bool0

Переписывает функции arrayExists() в has(), когда они логически эквивалентны. Например, arrayExists(x -> x = 1, arr) может быть переписано в has(arr, 1).

optimize_rewrite_sum_if_to_count_if​

ТипПо умолчанию
Bool1

Переписывает функции sumIf() и sum(if()) в функцию countIf(), когда они логически эквивалентны.

optimize_skip_merged_partitions​

ТипПо умолчанию
Bool0

Включает или отключает оптимизацию для запроса OPTIMIZE TABLE ... FINAL, если существует только одна часть с уровнем > 0 и у неё нет истёкшего TTL.

  • OPTIMIZE TABLE ... FINAL SETTINGS optimize_skip_merged_partitions=1

По умолчанию запрос OPTIMIZE TABLE ... FINAL переписывает одну часть, даже если существует всего одна часть.

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

  • 1 - Включить оптимизацию.
  • 0 - Отключить оптимизацию.

optimize_skip_unused_shards​

ТипПо умолчанию
Bool0

Включает или отключает пропуск неиспользуемых шардов для SELECT запросов, которые имеют условие шардирования в WHERE/PREWHERE (при условии что данные распределены по ключу шардирования, иначе запрос будет давать некорректный результат).

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

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

optimize_skip_unused_shards_limit​

ТипПо умолчанию
UInt641000

Лимит для числа значений ключа шардирования, отключает optimize_skip_unused_shards, если лимит превышен.

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

optimize_skip_unused_shards_nesting​

ТипПо умолчанию
UInt640

Управляет optimize_skip_unused_shards (поэтому всё ещё требует optimize_skip_unused_shards) в зависимости от уровня вложенности распределённого запроса (случай, когда у вас есть Distributed таблица, которая смотрит на другую Distributed таблицу).

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

  • 0 — Отключено, optimize_skip_unused_shards всегда работает.
  • 1 — Включает optimize_skip_unused_shards только для первого уровня.
  • 2 — Включает optimize_skip_unused_shards до второго уровня.

optimize_skip_unused_shards_rewrite_in​

ТипПо умолчанию
Bool1

Переписывает IN в запросе для удалённых шардов, исключая значения, которые не принадлежат шару (требуется optimize_skip_unused_shards).

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

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

optimize_sorting_by_input_stream_properties​

ТипПо умолчанию
Bool1

Оптимизирует сортировку по свойствам входного потока.

optimize_substitute_columns​

ТипПо умолчанию
Bool0

Использует ограничения для замены колонок. По умолчанию установлено false.

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

  • true, false

optimize_syntax_fuse_functions​

ТипПо умолчанию
Bool0

Включает слияние агрегатных функций с идентичным аргументом. Он переписывает запрос, содержащий по меньшей мере две агрегатные функции из sum, count или avg с идентичным аргументом на sumCount.

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

  • 0 — Функции с идентичным аргументом не сливаются.
  • 1 — Функции с идентичным аргументом сливаются.

Пример

Запрос:

Результат:

optimize_throw_if_noop​

ТипПо умолчанию
Bool0

Включает или отключает выбрасывание исключения, если запрос OPTIMIZE не произвёл слияние.

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

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

  • 1 — Включено выбрасывание исключения.
  • 0 — Отключено выбрасывание исключения.

optimize_time_filter_with_preimage​

ТипПо умолчанию
Bool1

Оптимизирует предикаты Date и DateTime путём преобразования функций в эквивалентные сравнения без преобразований (например, toYear(col) = 2023 -> col >= '2023-01-01' AND col <= '2023-12-31').

optimize_trivial_approximate_count_query​

ТипПо умолчанию
Bool0

Использует приблизительное значение для тривиальной оптимизации счёта для хранилищ, которые поддерживают такую оценку, например, EmbeddedRocksDB.

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

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

optimize_trivial_count_query​

ТипПо умолчанию
Bool1

Включает или отключает оптимизацию тривиального запроса SELECT count() FROM table с использованием метаданных из MergeTree. Если вам нужно использовать безопасность на уровне строк, отключите эту настройку.

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

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

Смотрите также:

optimize_trivial_insert_select​

ТипПо умолчанию
Bool0

Оптимизирует тривиальный запрос 'INSERT INTO table SELECT ... FROM TABLES'.

optimize_uniq_to_count​

ТипПо умолчанию
Bool1

Переписывает uniq и его варианты (кроме uniqUpTo) в count, если подзапрос имеет оператор distinct или group by.

optimize_use_implicit_projections​

ТипПо умолчанию
Bool1

Автоматически выбирает неявные проекции для выполнения запроса SELECT.

optimize_use_projections​

ТипПо умолчанию
Bool1

Включает или отключает оптимизацию проекций при обработке запросов SELECT.

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

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

optimize_using_constraints​

ТипПо умолчанию
Bool0

Использует ограничения для оптимизации запросов. По умолчанию установлено false.

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

  • true, false

os_thread_priority​

ТипПо умолчанию
Int640

Устанавливает приоритет (nice) для потоков, которые выполняют запросы. Планировщик ОС учитывает этот приоритет при выборе следующего потока для запуска на каждом доступном ядре CPU.

примечание

Для использования этой настройки необходимо установить возможность CAP_SYS_NICE. Пакет clickhouse-server настраивает её во время установки. Некоторые виртуальные среды не позволяют установить возможность CAP_SYS_NICE. В этом случае clickhouse-server выводит сообщение об этом в начале.

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

  • Значения можно устанавливать в диапазоне [-20, 19].

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

output_format_compression_level​

ТипПо умолчанию
UInt643

Уровень сжатия по умолчанию, если вывод запроса сжат. Настройка применяется, когда запрос SELECT имеет INTO OUTFILE или когда осуществляется запись в табличные функции file, url, hdfs, s3 или azureBlobStorage.

Возможные значения: от 1 до 22.

output_format_compression_zstd_window_log​

ТипПо умолчанию
UInt640

Может быть использован, когда метод сжатия вывода - zstd. Если больше 0, эта настройка явно задаёт размер окна сжатия (степень 2) и включает режим длинного диапазона для сжатия zstd. Это может помочь достичь лучшего коэффициента сжатия.

Возможные значения: неотрицательные числа. Обратите внимание, что если значение слишком мало или слишком велико, zstdlib выбросит исключение. Типичные значения находятся в диапазоне от 20 (размер окна = 1MB) до 30 (размер окна = 1GB).

output_format_parallel_formatting​

ТипПо умолчанию
Bool1

Включает или отключает параллельное форматирование данных для форматов. Поддерживаются только для форматов TSV, TSKV, CSV и JSONEachRow.

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

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

page_cache_inject_eviction​

ТипПо умолчанию
Bool0

Кэш страниц пользовательского пространства иногда будет случайно аннулировать некоторые страницы. Предназначен для тестирования.

parallel_distributed_insert_select​

ТипПо умолчанию
UInt640

Включает параллельный распределённый запрос INSERT ... SELECT.

Если мы выполняем запросы INSERT INTO distributed_table_a SELECT ... FROM distributed_table_b и обе таблицы используют один и тот же кластер, и обе таблицы либо реплицированы, либо не реплицированы, то этот запрос обрабатывается локально на каждом шарде.

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

  • 0 — Отключено.
  • 1 — SELECT будет выполняться на каждом шарде из основной таблицы распределённого движка.
  • 2 — SELECT и INSERT будут выполняться на каждом шарде из/в основную таблицу распределённого движка.

parallel_replica_offset​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Это внутренняя настройка, которую не следует использовать напрямую, и она представляет собой реализацию «параллельных реплик». Эта настройка будет автоматически установлена инициирующим сервером для распределённых запросов на индекс реплики, участвующей в обработке запроса среди параллельных реплик.

parallel_replicas_allow_in_with_subquery​

Beta feature. Learn more.
ТипПо умолчанию
Bool1

Если true, подзапрос для IN будет выполняться на каждой вспомогательной реплике.

parallel_replicas_count​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Это внутренняя настройка, которую не следует использовать напрямую, и она представляет собой реализацию «параллельных реплик». Эта настройка будет автоматически установлена инициирующим сервером для распределённых запросов на количество параллельных реплик, участвующих в обработке запроса.

parallel_replicas_custom_key​

Beta feature. Learn more.

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

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

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

parallel_replicas_custom_key_range_lower​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Позволяет фильтру типа range равномерно распределить работу между репликами на основе пользовательского диапазона [parallel_replicas_custom_key_range_lower, INT_MAX].

При использовании совместно с parallel_replicas_custom_key_range_upper позволяет фильтру равномерно распределить работу между репликами для диапазона [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Примечание: Эта настройка не приведёт к фильтрации дополнительных данных во время обработки запроса, она просто изменяет точки, в которых диапазонный фильтр разбивает диапазон [0, INT_MAX] для параллельной обработки.

parallel_replicas_custom_key_range_upper​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Позволяет фильтру типа range равномерно распределить работу между репликами на основе пользовательского диапазона [0, parallel_replicas_custom_key_range_upper]. Значение 0 отключает верхнюю границу, устанавливая её на максимальное значение пользовательского ключевого выражения.

При использовании совместно с parallel_replicas_custom_key_range_lower позволяет фильтру равномерно распределить работу между репликами для диапазона [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Примечание: Эта настройка не приведёт к фильтрации дополнительных данных во время обработки запроса, она просто изменяет точки, в которых диапазонный фильтр разбивает диапазон [0, INT_MAX] для параллельной обработки.

parallel_replicas_for_cluster_engines​

ТипПо умолчанию
Bool1

Заменяет движки табличных функций их -Cluster аналогами.

parallel_replicas_for_non_replicated_merge_tree​

Beta feature. Learn more.
ТипПо умолчанию
Bool0

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

parallel_replicas_index_analysis_only_on_coordinator​

Beta feature. Learn more.
ТипПо умолчанию
Bool1

Анализ индекса выполняется только на реплике-координаторе и пропускается на других репликах. Эффективно только с включённым parallel_replicas_local_plan.

parallel_replicas_local_plan​

Beta feature. Learn more.
ТипПо умолчанию
Bool1

Строит локальный план для локальной реплики.

parallel_replicas_mark_segment_size​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Части виртуально делятся на сегменты, которые распределяются между репликами для параллельного чтения. Эта настройка контролирует размер этих сегментов. Не рекомендуется изменять, пока вы не уверены в том, что делаете. Значение должно находиться в диапазоне [128; 16384].

parallel_replicas_min_number_of_rows_per_replica​

Beta feature. Learn more.
ТипПо умолчанию
UInt640

Ограничивает количество реплик, используемых в запросе до (оценочное число строк для чтения / min_number_of_rows_per_replica). Максимум всё ещё ограничен 'max_parallel_replicas'.

parallel_replicas_mode​

Beta feature. Learn more.
ТипПо умолчанию
ParallelReplicasModeread_tasks

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

parallel_replicas_only_with_analyzer​

Beta feature. Learn more.
ТипПо умолчанию
Bool1

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

parallel_replicas_prefer_local_join​

Beta feature. Learn more.
ТипПо умолчанию
Bool1

Если true и JOIN может быть выполнен с алгоритмом параллельных реплик, и все хранилища правой части JOIN - это *MergeTree, будет использоваться локальный JOIN вместо ГЛОБАЛЬНОГО JOIN.

parallel_view_processing​

ТипПо умолчанию
Bool0

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

parallelize_output_from_storages​

ТипПо умолчанию
Bool1

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

parsedatetime_parse_without_leading_zeros​

ТипПо умолчанию
Bool1

Форматтеры '%c', '%l' и '%k' в функции 'parseDateTime' парсят месяцы и часы без ведущих нулей.

partial_merge_join_left_table_buffer_bytes​

ТипПо умолчанию
UInt640

Если не 0, группирует блоки левой таблицы в более крупные для левой таблицы в частичном слиянии. Использует до 2x указанной памяти на каждый поток соединения.

partial_merge_join_rows_in_right_blocks​

ТипПо умолчанию
UInt6465536

Ограничивает размеры данных в правом соединении в алгоритме частичного слияния для запросов JOIN.

Сервер ClickHouse:

  1. Делит данные правого соединения на блоки с максимумом указанного количества строк.
  2. Индексирует каждый блок его минимальными и максимальными значениями.
  3. Сбрасывает подготовленные блоки на диск, если это возможно.

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

  • Любое положительное целое число. Рекомендуемый диапазон значений: [1000, 100000].

partial_result_on_first_cancel​

ТипПо умолчанию
Bool0

Разрешает запросу вернуть частичный результат после отмены.

parts_to_delay_insert​

ТипПо умолчанию
UInt640

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

parts_to_throw_insert​

ТипПо умолчанию
UInt640

Если в единственной партиции целевой таблицы активных частей больше чем это число, выбрасывает исключение 'Слишком много частей ...'.

periodic_live_view_refresh​

ТипПо умолчанию
Seconds60

Интервал, после которого периодически обновляемое live представление будет принудительно обновлено.

poll_interval​

ТипПо умолчанию
UInt6410

Блокирует цикл ожидания запроса на сервере на указанное количество секунд.

postgresql_connection_attempt_timeout​

ТипПо умолчанию
UInt642

Тайм-аут подключения в секундах для одной попытки подключения к конечной точке PostgreSQL. Значение передаётся как параметр connect_timeout в URL подключения.

postgresql_connection_pool_auto_close_connection​

ТипПо умолчанию
Bool0

Закрывает соединение перед возвратом соединения в пул.

postgresql_connection_pool_retries​

ТипПо умолчанию
UInt642

Количество попыток push/pop в пуле соединений для движка таблицы PostgreSQL и движка базы данных.

postgresql_connection_pool_size​

ТипПо умолчанию
UInt6416

Размер пула соединений для движка таблицы PostgreSQL и движка базы данных.

postgresql_connection_pool_wait_timeout​

ТипПо умолчанию
UInt645000

Тайм-аут push/pop пула соединений при пустом пуле для движка таблицы PostgreSQL и движка базы данных. По умолчанию он будет блокировать при пустом пуле.

postgresql_fault_injection_probability​

ТипПо умолчанию
Float0

Приблизительная вероятность сбоя внутренних (для репликации) запросов PostgreSQL. Допустимое значение находится в интервале [0.0f, 1.0f].

prefer_column_name_to_alias​

ТипПо умолчанию
Bool0

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

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

  • 0 — Название колонки заменяется алиасом.
  • 1 — Название колонки не заменяется алиасом.

Пример

Разница между включённым и выключенным:

Запрос:

Результат:

Запрос:

Результат:

prefer_external_sort_block_bytes​

ТипПо умолчанию
UInt6416744704

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

prefer_global_in_and_join​

ТипПо умолчанию
Bool0

Включает замену операторов IN/JOIN на GLOBAL IN/GLOBAL JOIN.

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

  • 0 — Отключено. Операторы IN/JOIN не заменяются на GLOBAL IN/GLOBAL JOIN.
  • 1 — Включено. Операторы IN/JOIN заменяются на GLOBAL IN/GLOBAL JOIN.

Использование

Хотя SET distributed_product_mode=global может изменить поведение запросов для распределённых таблиц, он не подходит для локальных таблиц или таблиц из внешних ресурсов. Здесь и вступает в действие настройка prefer_global_in_and_join.

Например, у нас есть узлы обслуживания запросов, которые содержат локальные таблицы, не подходящие для распределения. Нам нужно рассеять их данные на лету во время распределённой обработки с помощью ключевого слова GLOBAL — GLOBAL IN/GLOBAL JOIN.

Другой случай использования prefer_global_in_and_join — доступ к таблицам, созданным внешними движками. Эта настройка помогает сократить количество вызовов к внешним источникам при объединении таких таблиц: только один вызов за запрос.

Смотрите также:

prefer_localhost_replica​

ТипПо умолчанию
Bool1

Включает/выключает предпочтительное использование локальной реплики при обработке распределённых запросов.

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

  • 1 — ClickHouse всегда отправляет запрос на локальную реплику, если она существует.
  • 0 — ClickHouse использует стратегию балансировки, указанную в настройке load_balancing.
примечание

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

prefer_warmed_unmerged_parts_seconds​

ClickHouse Cloud only
ТипПо умолчанию
Int640

Эта настройка имеет действие только в ClickHouse Cloud. Если объединённая часть моложе этого количества секунд и не разогрета, (см. cache_populated_by_fetch), но все её исходные части доступны и разогреты, SELECT запросы будут читать из этих частей. Только для Replicated-/SharedMergeTree. Обратите внимание, что это проверяет только то, обработал ли CacheWarmer часть; если часть была извлечена в кэш чем-то другим, она всё равно будет считаться холодной, пока CacheWarmer не дойдёт до неё; если она была разогрета, а затем выгнана из кэша, она всё равно будет считаться тёплой.

preferred_block_size_bytes​

ТипПо умолчанию
UInt641000000

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

preferred_max_column_in_block_size_bytes​

ТипПо умолчанию
UInt640

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

preferred_optimize_projection_name​

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

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

  • строка: название предпочтительной проекции

prefetch_buffer_size​

ТипПо умолчанию
UInt641048576

Максимальный размер буфера предзагрузки для чтения из файловой системы.

ТипПо умолчанию
Bool1

Позволяет выводить глубоко вложенные названия типов в красивом виде с отступами в запросе DESCRIBE и в функции toTypeName().

Пример:

priority​

ТипПо умолчанию
UInt640

Приоритет запроса. 1 - наивысший, более высокое значение - более низкий приоритет; 0 - не использовать приоритеты.

push_external_roles_in_interserver_queries​

ТипПо умолчанию
Bool1

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

query_cache_compress_entries​

ТипПо умолчанию
Bool1

Сжимать записи в кэше запросов. Уменьшает потребление памяти кэша запросов за счёт более медленного вставки / считывания из него.

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

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

query_cache_max_entries​

ТипПо умолчанию
UInt640

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

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

  • Положительное целое число >= 0.

query_cache_max_size_in_bytes​

ТипПо умолчанию
UInt640

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

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

  • Положительное целое число >= 0.

query_cache_min_query_duration​

ТипПо умолчанию
Milliseconds0

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

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

  • Положительное целое число >= 0.

query_cache_min_query_runs​

ТипПо умолчанию
UInt640

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

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

  • Положительное целое число >= 0.

query_cache_nondeterministic_function_handling​

ТипПо умолчанию
QueryResultCacheNondeterministicFunctionHandlingthrow

Управляет тем, как кэш запросов обрабатывает запросы SELECT с недетерминированными функциями, такими как rand() или now().

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

  • 'throw' - Генерировать исключение и не кэшировать результат запроса.
  • 'save' - Кэшировать результат запроса.
  • 'ignore' - Не кэшировать результат запроса и не генерировать исключение.

query_cache_share_between_users​

ТипПо умолчанию
Bool0

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

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

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

query_cache_squash_partial_results​

ТипПо умолчанию
Bool1

Сжимать частичные результатирующие блоки в блоки размера max_block_size. Уменьшает производительность вставок в кэш запросов, но улучшает сжимаемость записей кэша (см. query_cache_compress-entries).

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

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

query_cache_system_table_handling​

ТипПо умолчанию
QueryResultCacheSystemTableHandlingthrow

Управляет тем, как кэш запросов обрабатывает запросы SELECT к системным таблицам, т.е. к таблицам в базах данных system.* и information_schema.*.

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

  • 'throw' - Генерировать исключение и не кэшировать результат запроса.
  • 'save' - Кэшировать результат запроса.
  • 'ignore' - Не кэшировать результат запроса и не генерировать исключение.

query_cache_tag​

Строка, которая действует как метка для записей кэша запросов. Одни и те же запросы с разными метками рассматриваются кэшем запросов как разные.

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

  • Любая строка

query_cache_ttl​

ТипПо умолчанию
Seconds60

После этого времени в секундах записи в кэше запросов становятся устаревшими.

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

  • Положительное целое число >= 0.

query_metric_log_interval​

ТипПо умолчанию
Int64-1

Интервал в миллисекундах, с которым собирается query_metric_log для отдельных запросов.

Если установлено на любое отрицательное значение, будет использоваться значение collect_interval_milliseconds из настройки query_metric_log или по умолчанию 1000, если оно отсутствует.

Чтобы отключить сбор отдельного запроса, установите query_metric_log_interval в 0.

Значение по умолчанию: -1

query_plan_aggregation_in_order​

ТипПо умолчанию
Bool1

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

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_convert_join_to_in​

ТипПо умолчанию
Bool0

Разрешить преобразование JOIN в подзапрос с IN, если выходные колонки связаны только с левой таблицей.

query_plan_convert_outer_join_to_inner_join​

ТипПо умолчанию
Bool1

Разрешить преобразование OUTER JOIN в INNER JOIN, если фильтр после JOIN всегда фильтрует значения по умолчанию.

query_plan_enable_multithreading_after_window_functions​

ТипПо умолчанию
Bool1

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

query_plan_enable_optimizations​

ТипПо умолчанию
Bool1

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

примечание

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

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

  • 0 - Отключить все оптимизации на уровне плана запроса
  • 1 - Включить оптимизации на уровне плана запроса (но отдельные оптимизации могут быть отключены через их индивидуальные настройки)

query_plan_execute_functions_after_sorting​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая перемещает выражения после шагов сортировки. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_filter_push_down​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая перемещает фильтры вниз в плане выполнения. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_join_shard_by_pk_ranges​

ТипПо умолчанию
Bool0

Применить шардирование для JOIN, если ключи объединения содержат префикс PRIMARY KEY для обеих таблиц. Поддерживается для алгоритмов hash, parallel_hash и full_sorting_merge.

query_plan_join_swap_table​

ТипПо умолчанию
BoolAutoauto

Определить, какая сторона соединения должна быть таблицей построения (также называемой внутренней, той, которая вставляется в хеш-таблицу для хеш-объединения) в плане запроса. Эта настройка поддерживается только для ALL строгости объединения с клаузой JOIN ON. Возможные значения:

  • 'auto': Позволить планировщику решить, какую таблицу использовать в качестве таблицы построения.
  • 'false': Никогда не менять таблицы (правая таблица является таблицей построения).
  • 'true': Всегда менять таблицы (левая таблица является таблицей построения).

query_plan_lift_up_array_join​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая перемещает ARRAY JOIN вверх в плане выполнения. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_lift_up_union​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая перемещает более крупные поддеревья плана запроса в объединение, чтобы включить дальнейшие оптимизации. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_max_limit_for_lazy_materialization​

ТипПо умолчанию
UInt6410

Контролирует максимальное предельное значение, позволяющее использовать план запроса для оптимизации ленивого материализования. Если ноль, нет предела.

query_plan_max_optimizations_to_apply​

ТипПо умолчанию
UInt6410000

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

примечание

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

query_plan_merge_expressions​

ТипПо умолчанию
Bool1

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

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_merge_filters​

ТипПо умолчанию
Bool1

Разрешить слияние фильтров в плане запроса.

query_plan_optimize_lazy_materialization​

ТипПо умолчанию
Bool1

Использовать план запроса для оптимизации ленивого материализования.

query_plan_optimize_prewhere​

ТипПо умолчанию
Bool1

Разрешить перемещение фильтра в выражение PREWHERE для поддерживаемых хранилищ.

query_plan_push_down_limit​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая перемещает LIMIT вниз в плане выполнения. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_read_in_order​

ТипПо умолчанию
Bool1

Включает оптимизацию чтения в порядке на уровне плана запроса. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_remove_redundant_distinct​

ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая удаляет избыточные DISTINCT шаги. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_remove_redundant_sorting​

ТипПо умолчанию
Bool1

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

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_reuse_storage_ordering_for_window_functions​

ТипПо умолчанию
Bool1

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

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_split_filter​

ТипПо умолчанию
Bool1
примечание

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

Включает оптимизацию на уровне плана запроса, которая разбивает фильтры на выражения. Действует только если установка query_plan_enable_optimizations равна 1.

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

  • 0 - Отключить
  • 1 - Включить
ТипПо умолчанию
Bool1

Включает оптимизацию на уровне плана запроса, которая пытается использовать индекс векторного сходства. Действует только если установка query_plan_enable_optimizations равна 1.

примечание

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

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

  • 0 - Отключить
  • 1 - Включить

query_plan_use_new_logical_join_step​

ТипПо умолчанию
Bool1

Использовать новый логический шаг объединения в плане запроса.

query_profiler_cpu_time_period_ns​

ТипПо умолчанию
UInt641000000000

Устанавливает период для таймера процессора профилировщика запросов. Этот таймер считает только время CPU.

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

  • Положительное целое число в наносекундах.

    Рекомендуемые значения:

    • 10000000 (100 раз в секунду) наносекунд и больше для одиночных запросов.
    • 1000000000 (раз в секунду) для профилирования по всему кластеру.

  • 0 для отключения таймера.

Временно отключено в ClickHouse Cloud.

Смотрите также:

  • Системная таблица trace_log

query_profiler_real_time_period_ns​

ТипПо умолчанию
UInt641000000000

Устанавливает период для реального таймера профилировщика запросов. Реальный таймер считает время по часам.

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

  • Положительное целое число в наносекундах.

    Рекомендуемые значения:

    • 10000000 (100 раз в секунду) наносекунд и меньше для одиночных запросов.
    • 1000000000 (раз в секунду) для профилирования по всему кластеру.

  • 0 для отключения таймера.

Временно отключено в ClickHouse Cloud.

Смотрите также:

  • Системная таблица trace_log

queue_max_wait_ms​

ТипПо умолчанию
Milliseconds0

Время ожидания в очереди запросов, если количество параллельных запросов превышает максимальное.

rabbitmq_max_wait_ms​

ТипПо умолчанию
Milliseconds5000

Время ожидания для чтения из RabbitMQ перед повторной попыткой.

read_backoff_max_throughput​

ТипПо умолчанию
UInt641048576

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

read_backoff_min_concurrency​

ТипПо умолчанию
UInt641

Настройки, чтобы попытаться удерживать минимальное количество потоков в случае медленных чтений.

read_backoff_min_events​

ТипПо умолчанию
UInt642

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

read_backoff_min_interval_between_events_ms​

ТипПо умолчанию
Milliseconds1000

Настройки, чтобы уменьшить количество потоков в случае медленных чтений. Не учитывать событие, если предыдущее прошло менее определённого количества времени.

read_backoff_min_latency_ms​

ТипПо умолчанию
Milliseconds1000

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

read_from_filesystem_cache_if_exists_otherwise_bypass_cache​

ТипПо умолчанию
Bool0

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

read_from_page_cache_if_exists_otherwise_bypass_cache​

ТипПо умолчанию
Bool0

Использовать кэш страниц в пользовательском пространстве в пассивном режиме, аналогично read_from_filesystem_cache_if_exists_otherwise_bypass_cache.

read_in_order_two_level_merge_threshold​

ТипПо умолчанию
UInt64100

Минимальное количество частей для чтения, чтобы выполнить предварительный этап слияния во время многопоточной чтения в порядке первичного ключа.

read_in_order_use_buffering​

ТипПо умолчанию
Bool1

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

read_in_order_use_virtual_row​

ТипПо умолчанию
Bool0

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

read_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Что делать, когда предел превышен.

read_overflow_mode_leaf​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что происходит, когда объём читаемых данных превышает один из ограничений листа.

Возможные опции:

  • throw: выбросить исключение (по умолчанию).
  • break: прекратить выполнение запроса и вернуть частичный результат.

read_priority​

ТипПо умолчанию
Int640

Приоритет чтения данных из локальной файловой системы или удалённой файловой системы. Поддерживается только для метода 'pread_threadpool' для локальной файловой системы и для метода threadpool для удалённой файловой системы.

read_through_distributed_cache​

ClickHouse Cloud only
ТипПо умолчанию
Bool0

Эта настройка имеет действие только в ClickHouse Cloud. Позволяет чтение из распределённого кэша.

readonly​

ТипПо умолчанию
UInt640

0 - отсутствие ограничений на только чтение. 1 - только запросы на чтение, а также изменение явно разрешенных настроек. 2 - только запросы на чтение, а также изменение настроек, кроме настройки 'readonly'.

receive_data_timeout_ms​

ТипПо умолчанию
Milliseconds2000

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

receive_timeout​

ТипПо умолчанию
Seconds300

Таймаут для получения данных из сети, в секундах. Если в этом интервале не были получены байты, будет выброшено исключение. Если вы установите эту настройку на клиенте, тайм-аут 'send_timeout' для сокета также будет установлен на соответствующем конце подключения на сервере.

regexp_max_matches_per_row​

ТипПо умолчанию
UInt641000

Устанавливает максимальное количество совпадений для одного регулярного выражения на строку. Используйте это, чтобы защититься от перегрузки памяти при использовании жадного регулярного выражения в функции extractAllGroupsHorizontal.

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

  • Положительное целое число.

reject_expensive_hyperscan_regexps​

ТипПо умолчанию
Bool1

Отклонять шаблоны, которые, вероятно, будут дорогостоящими для оценки с помощью hyperscan (из-за взрыва состояния NFA).

remerge_sort_lowered_memory_bytes_ratio​

ТипПо умолчанию
Float2

Если использование памяти после повторного слияния не снижено на это соотношение, повторное слияние будет отключено.

remote_filesystem_read_method​

ТипПо умолчанию
Stringthreadpool

Метод чтения данных из удалённой файловой системы, один из: read, threadpool.

remote_filesystem_read_prefetch​

ТипПо умолчанию
Bool1

Следует использовать предварительную загрузку при чтении данных из удалённой файловой системы.

remote_fs_read_backoff_max_tries​

ТипПо умолчанию
UInt645

Максимальное количество попыток чтения с откатом.

remote_fs_read_max_backoff_ms​

ТипПо умолчанию
UInt6410000

Максимальное время ожидания при попытке чтения данных для удалённого диска.

remote_read_min_bytes_for_seek​

ТипПо умолчанию
UInt644194304

Минимальные байты, необходимые для удалённого чтения (url, s3) для выполнения поиска, вместо чтения с игнорированием.

rename_files_after_processing​

  • Тип: Строка

  • Значение по умолчанию: Пустая строка

Эта настройка позволяет задать шаблон переименования для файлов, обработанных функцией таблицы file. Когда опция установлена, все файлы, прочитанные функцией таблицы file, будут переименованы в соответствии с указанным шаблоном с заполнителями, только если обработка файлов была успешной.

Заполнители​

  • %a — Полное имя оригинального файла (например, "sample.csv").
  • %f — Имя оригинального файла без расширения (например, "sample").
  • %e — Оригинальное расширение файла с точкой (например, ".csv").
  • %t — Время (в микросекундах).
  • %% — Знак процента ("%").

Пример​

  • Опция: --rename_files_after_processing="processed_%f_%t%e"

  • Запрос: SELECT * FROM file('sample.csv')

Если чтение sample.csv прошло успешно, файл будет переименован в processed_sample_1683473210851438.csv.

replace_running_query​

ТипПо умолчанию
Bool0

При использовании HTTP интерфейса параметр 'query_id' может быть передан. Это любая строка, которая служит идентификатором запроса. Если в это время существует запрос от того же пользователя с тем же 'query_id', поведение зависит от параметра 'replace_running_query'.

0 (по умолчанию) – Генерирует исключение (не позволяет запросу выполняться, если запрос с тем же 'query_id' уже выполняется).

1 – Отменяет старый запрос и начинает выполнение нового.

Установите этот параметр в 1 для реализации предложений по условиям сегментации. После ввода следующего символа, если старый запрос еще не завершен, он должен быть отменен.

replace_running_query_max_wait_ms​

ТипПо умолчанию
Milliseconds5000

Время ожидания завершения выполнения запроса с тем же query_id, когда активен параметр replace_running_query.

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

  • Положительное целое число.
  • 0 — Генерирует исключение, которое не позволяет запустить новый запрос, если сервер уже выполняет запрос с тем же query_id.

replication_wait_for_inactive_replica_timeout​

ТипПо умолчанию
Int64120

Указывает, как долго (в секундах) ждать, пока не выполнится ALTER, OPTIMIZE или TRUNCATE запросы для неактивных реплик.

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

  • 0 — Не ждать.
  • Отрицательное целое число — Ждать неограниченное время.
  • Положительное целое число — Количество секунд ожидания.

restore_replace_external_dictionary_source_to_null​

ТипПо умолчанию
Bool0

Заменяет источники внешних словарей на Null при восстановлении. Полезно для тестирования.

restore_replace_external_engines_to_null​

ТипПо умолчанию
Bool0

Для тестирования. Заменяет все внешние движки на Null, чтобы не инициировать внешние соединения.

restore_replace_external_table_functions_to_null​

ТипПо умолчанию
Bool0

Для тестирования. Заменяет все внешние табличные функции на Null, чтобы не инициировать внешние соединения.

restore_replicated_merge_tree_to_shared_merge_tree​

ТипПо умолчанию
Bool0

Заменяет движок таблицы с ReplicatedMergeTree -> SharedMergeTree во время ВОССТАНОВЛЕНИЯ.

result_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Значение по умолчанию для облака: throw

Устанавливает, что делать, если объем результата превышает один из лимитов.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как будто исходные данные закончились.

Использование 'break' похоже на использование LIMIT. Break прерывает выполнение только на уровне блока. Это означает, что количество возвращаемых строк больше чем max_result_rows, кратное max_block_size и зависит от max_threads.

Пример

rewrite_count_distinct_if_with_count_distinct_implementation​

ТипПо умолчанию
Bool0

Позволяет переписывать countDistinctIf с настройкой count_distinct_implementation.

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

  • true — Разрешить.
  • false — Запретить.

s3_allow_multipart_copy​

ТипПо умолчанию
Bool1

Разрешить многосоставное копирование в S3.

s3_allow_parallel_part_upload​

ТипПо умолчанию
Bool1

Использовать несколько потоков для загрузки многосоставных частей в S3. Это может привести к немного большему использованию памяти.

s3_check_objects_after_upload​

ТипПо умолчанию
Bool0

Проверять каждый загруженный объект в S3 с запросом head, чтобы убедиться, что загрузка прошла успешно.

s3_connect_timeout_ms​

ТипПо умолчанию
UInt641000

Таймаут подключения к хостам с дисками S3.

s3_create_new_file_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает создание нового файла при каждой вставке в таблицы движка S3. Если включено, при каждой вставке будет создан новый объект S3 с ключом, аналогично следующему шаблону:

начальный: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz и т. д.

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

  • 0 — Запрос INSERT создает новый файл или завершается ошибкой, если файл существует и не установлен s3_truncate_on_insert.
  • 1 — Запрос INSERT создает новый файл при каждой вставке, используя суффикс (со второго) при условии, что s3_truncate_on_insert не установлен.

Смотрите более подробную информацию здесь.

s3_disable_checksum​

ТипПо умолчанию
Bool0

Не вычислять контрольную сумму при отправке файла в S3. Это ускоряет записи, избегая избыточных проходов по файлу. Это в основном безопасно, поскольку данные таблиц MergeTree все равно проверяются ClickHouse, а при доступе к S3 через HTTPS уровень TLS уже обеспечивает целостность при передаче по сети. В то время как дополнительные контрольные суммы в S3 обеспечивают дополнительную защиту.

s3_ignore_file_doesnt_exist​

ТипПо умолчанию
Bool0

Игнорировать отсутствие файла, если он не существует, при чтении определенных ключей.

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

  • 1 — Запрос SELECT возвращает пустой результат.
  • 0 — Запрос SELECT генерирует исключение.

s3_list_object_keys_size​

ТипПо умолчанию
UInt641000

Максимальное количество файлов, которые могут быть возвращены в пакете по запросу ListObject.

s3_max_connections​

ТипПо умолчанию
UInt641024

Максимальное количество подключений на сервер.

s3_max_get_burst​

ТипПо умолчанию
UInt640

Максимальное количество запросов, которые могут быть выданы одновременно до достижения лимита запросов в секунду. По умолчанию (0) равно s3_max_get_rps.

s3_max_get_rps​

ТипПо умолчанию
UInt640

Лимит на частоту GET-запросов S3 в секунду до снижения скорости. Ноль означает неограниченно.

s3_max_inflight_parts_for_one_file​

ТипПо умолчанию
UInt6420

Максимальное количество загружаемых одновременно частей в запросе многосоставной загрузки. 0 означает неограниченно.

s3_max_part_number​

ТипПо умолчанию
UInt6410000

Максимальный номер части для загрузки в S3.

s3_max_put_burst​

ТипПо умолчанию
UInt640

Максимальное количество запросов, которые могут быть выданы одновременно до достижения лимита запросов в секунду. По умолчанию (0) равно s3_max_put_rps.

s3_max_put_rps​

ТипПо умолчанию
UInt640

Лимит на частоту PUT-запросов S3 в секунду до снижения скорости. Ноль означает неограниченно.

s3_max_redirects​

ТипПо умолчанию
UInt6410

Максимальное количество перенаправлений S3.

s3_max_single_operation_copy_size​

ТипПо умолчанию
UInt6433554432

Максимальный размер для копирования в одной операции в S3. Эта настройка используется только если s3_allow_multipart_copy установлено на true.

s3_max_single_part_upload_size​

ТипПо умолчанию
UInt6433554432

Максимальный размер объекта для загрузки с использованием одночастной загрузки в S3.

s3_max_single_read_retries​

ТипПо умолчанию
UInt644

Максимальное количество попыток при одном чтении из S3.

s3_max_unexpected_write_error_retries​

ТипПо умолчанию
UInt644

Максимальное количество попыток в случае неожиданных ошибок при записи в S3.

s3_max_upload_part_size​

ТипПо умолчанию
UInt645368709120

Максимальный размер части для загрузки во время многосоставной загрузки в S3.

s3_min_upload_part_size​

ТипПо умолчанию
UInt6416777216

Минимальный размер части для загрузки во время многосоставной загрузки в S3.

s3_request_timeout_ms​

ТипПо умолчанию
UInt6430000

Таймаут бездействия для передачи и получения данных в S3. Ошибка, если одной TCP операции чтения или записи не удается выполнить в течение этого времени.

s3_retry_attempts​

ТипПо умолчанию
UInt64100

Настройка для Aws::Client::RetryStrategy, Aws::Client выполняет повторные попытки самостоятельно, 0 означает отсутствие повторных попыток.

s3_skip_empty_files​

ТипПо умолчанию
Bool1

Включает или отключает пропуск пустых файлов в таблицах движка S3.

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

  • 0 — Запрос SELECT генерирует исключение, если пустой файл несовместим с запрашиваемым форматом.
  • 1 — Запрос SELECT возвращает пустой результат для пустого файла.

s3_strict_upload_part_size​

ТипПо умолчанию
UInt640

Точный размер части для загрузки во время многосоставной загрузки в S3 (некоторые реализации не поддерживают части переменного размера).

s3_throw_on_zero_files_match​

ТипПо умолчанию
Bool0

Генерировать ошибку, когда запрос ListObjects не может найти ни одного файла.

s3_truncate_on_insert​

ТипПо умолчанию
Bool0

Включает или отключает обрезку перед вставками в таблицы движка S3. Если отключено, генерируется исключение при попытках вставки, если объект S3 уже существует.

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

  • 0 — Запрос INSERT создает новый файл или завершается ошибкой, если файл существует и s3_create_new_file_on_insert не установлен.
  • 1 — Запрос INSERT заменяет существующее содержимое файла новыми данными.

Смотрите более подробную информацию здесь.

s3_upload_part_size_multiply_factor​

ТипПо умолчанию
UInt642

Умножает s3_min_upload_part_size на этот коэффициент каждый раз, когда s3_multiply_parts_count_threshold частей загружается с одной записи в S3.

s3_upload_part_size_multiply_parts_count_threshold​

ТипПо умолчанию
UInt64500

Каждый раз, когда это количество частей загружается в S3, s3_min_upload_part_size умножается на s3_upload_part_size_multiply_factor.

s3_use_adaptive_timeouts​

ТипПо умолчанию
Bool1

Когда установлено значение true, для всех запросов S3 первые две попытки выполняются с низкими таймаутами отправки и получения. Когда установлено значение false, все попытки выполняются с идентичными таймаутами.

s3_validate_request_settings​

ТипПо умолчанию
Bool1

Включает валидацию настроек запросов S3.

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

  • 1 — валидировать настройки.
  • 0 — не валидировать настройки.

s3queue_default_zookeeper_path​

ТипПо умолчанию
String/clickhouse/s3queue/

Префикс пути по умолчанию для Zookeeper для движка S3Queue.

s3queue_enable_logging_to_s3queue_log​

ТипПо умолчанию
Bool0

Включает запись в system.s3queue_log. Значение может быть переопределено для каждой таблицы с помощью настроек таблицы.

s3queue_migrate_old_metadata_to_buckets​

ТипПо умолчанию
Bool0

Миграция старой структуры метаданных таблицы S3Queue на новую.

schema_inference_cache_require_modification_time_for_url​

ТипПо умолчанию
Bool1

Использовать схему из кэша для URL с проверкой времени последнего изменения (для URL с заголовком Last-Modified).

schema_inference_use_cache_for_azure​

ТипПо умолчанию
Bool1

Использовать кэш в выводе схемы при использовании табличной функции Azure.

schema_inference_use_cache_for_file​

ТипПо умолчанию
Bool1

Использовать кэш в выводе схемы при использовании табличной функции файла.

schema_inference_use_cache_for_hdfs​

ТипПо умолчанию
Bool1

Использовать кэш в выводе схемы при использовании табличной функции HDFS.

schema_inference_use_cache_for_s3​

ТипПо умолчанию
Bool1

Использовать кэш в выводе схемы при использовании табличной функции S3.

schema_inference_use_cache_for_url​

ТипПо умолчанию
Bool1

Использовать кэш в выводе схемы при использовании табличной функции URL.

select_sequential_consistency​

ТипПо умолчанию
UInt640
примечание

Эта настройка имеет различные поведения для SharedMergeTree и ReplicatedMergeTree. Посмотрите последовательность SharedMergeTree для получения дополнительной информации о поведении select_sequential_consistency в SharedMergeTree.

Включает или отключает последовательную согласованность для запросов SELECT. Требует, чтобы insert_quorum_parallel был отключен (включен по умолчанию).

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

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

Использование

Когда последовательная согласованность включена, ClickHouse позволяет клиенту выполнять запрос SELECT только для тех реплик, которые содержат данные от всех предыдущих запросов INSERT, выполненных с insert_quorum. Если клиент ссылается на частичную реплику, ClickHouse создаст исключение. Запрос SELECT не будет включать данные, которые еще не были записаны в кворум реплик.

Когда insert_quorum_parallel включен (по умолчанию), тогда select_sequential_consistency не работает. Это связано с тем, что параллельные запросы INSERT могут быть записаны в разные наборы кворумных реплик, поэтому нет гарантии, что одна реплика примет все записи.

Смотрите также:

send_logs_level​

ТипПо умолчанию
LogsLevelfatal

Отправляет текстовые логи сервера с указанным минимальным уровнем клиенту. Допустимые значения: 'trace', 'debug', 'information', 'warning', 'error', 'fatal', 'none'.

send_logs_source_regexp​

Отправляет текстовые логи сервера с указанным регулярным выражением для сопоставления имени источника лога. Пустое значение означает все источники.

send_progress_in_http_headers​

ТипПо умолчанию
Bool0

Включает или отключает заголовки HTTP-ответов X-ClickHouse-Progress в ответах clickhouse-server.

Для получения дополнительной информации читайте описание HTTP интерфейса.

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

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

send_timeout​

ТипПо умолчанию
Seconds300

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

session_timezone​

Beta feature. Learn more.

Устанавливает неявный часовой пояс текущей сессии или запроса. Неявный часовой пояс — это часовой пояс, который применяется к значениям типа DateTime/DateTime64, у которых явно не указан часовой пояс. Эта настройка имеет приоритет перед глобально настроенным (уровня сервера) неявным часовым поясом. Значение '' (пустая строка) означает, что неявный часовой пояс текущей сессии или запроса равен серверному часовому поясу.

Вы можете использовать функции timeZone() и serverTimeZone(), чтобы получить часовой пояс сессии и серверный часовой пояс.

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

  • Любое имя часового пояса из system.time_zones, например, Europe/Berlin, UTC или Zulu.

Примеры:

Назначение часового пояса сессии 'America/Denver' внутреннему DateTime без явно указанного часового пояса:

осторожно

Не все функции, которые разбирают DateTime/DateTime64, учитывают session_timezone. Это может привести к тонким ошибкам. Смотрите следующий пример и объяснение.

Это происходит из-за различных конвейеров разбора:

  • toDateTime() без явно указанного часового пояса, используемого в первом запросе SELECT, учитывает настройку session_timezone и глобальный часовой пояс.
  • Во втором запросе DateTime разбирается из строки и наследует тип и часовой пояс существующего столбца d. Таким образом, установка session_timezone и глобального часового пояса не учитывается.

Смотрите также

set_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что происходит, когда объем данных превышает один из лимитов.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как будто исходные данные закончились.

shared_merge_tree_sync_parts_on_partition_operations​

ТипПо умолчанию
Bool1

Автоматически синхронизирует набор частей данных после операций MOVE|REPLACE|ATTACH в таблицах SMT. Только в облаке.

short_circuit_function_evaluation​

ТипПо умолчанию
ShortCircuitFunctionEvaluationenable

Позволяет вычислять функции if, multiIf, and и or согласно схеме короткого замыкания. Это помогает оптимизировать выполнение сложных выражений в этих функциях и предотвращает возможные исключения (например, деление на ноль, когда это не ожидается).

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

  • enable — Включает оценку функций с коротким замыканием для функций, которые к этому подходят (могут выбросить исключение или являются вычислительно тяжелыми).
  • force_enable — Включает оценку функций с коротким замыканием для всех функций.
  • disable — Отключает оценку функций с коротким замыканием.

short_circuit_function_evaluation_for_nulls​

ТипПо умолчанию
Bool1

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

short_circuit_function_evaluation_for_nulls_threshold​

ТипПо умолчанию
Double1

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

show_table_uuid_in_table_create_query_if_not_nil​

ТипПо умолчанию
Bool0

Устанавливает отображение запроса SHOW TABLE.

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

  • 0 — Запрос будет отображаться без UUID таблицы.
  • 1 — Запрос будет отображаться с UUID таблицы.

single_join_prefer_left_table​

ТипПо умолчанию
Bool1

Для одиночного JOIN в случае неоднозначности идентификаторов предпочтение отдается левой таблице.

skip_redundant_aliases_in_udf​

ТипПо умолчанию
Bool0

Избыточные алиасы не используются (не заменяются) в пользовательских функциях для упрощения их использования.

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

  • 1 — Алиасы пропускаются (заменяются) в UDF.
  • 0 — Алиасы не пропускаются (заменяются) в UDF.

Пример

Разница между включенной и выключенной настройками:

Запрос:

Результат:

Запрос:

Результат:

skip_unavailable_shards​

ТипПо умолчанию
Bool0

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

Шард считается недоступным, если все его реплики недоступны. Реплика недоступна в следующих случаях:

  • ClickHouse не может подключиться к реплике по любой причине.

При подключении к реплике ClickHouse делает несколько попыток. Если все эти попытки терпят неудачу, реплика считается недоступной.

  • Реплику нельзя разрешить через DNS.

Еслиhostname реплики не может быть разрешено через DNS, это может указывать на следующие ситуации:

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

  • Ошибка конфигурации. В конфигурационном файле ClickHouse содержится неверное имя хоста.

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

  • 1 — включен пропуск.

Если шард недоступен, ClickHouse возвращает результат на основе частичных данных и не сообщает о проблемах с доступностью узла.

  • 0 — пропуск отключен.

Если шард недоступен, ClickHouse генерирует исключение.

sleep_after_receiving_query_ms​

ТипПо умолчанию
Milliseconds0

Время ожидания после получения запроса в TCPHandler.

sleep_in_send_data_ms​

ТипПо умолчанию
Milliseconds0

Время ожидания при отправке данных в TCPHandler.

sleep_in_send_tables_status_ms​

ТипПо умолчанию
Milliseconds0

Время ожидания при отправке статуса таблиц в ответе в TCPHandler.

sort_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что происходит, если количество строк, полученных перед сортировкой, превышает один из лимитов.

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

  • throw: выбросить исключение.
  • break: остановить выполнение запроса и вернуть частичный результат.

split_intersecting_parts_ranges_into_layers_final​

ТипПо умолчанию
Bool1

Разделение пересекающихся диапазонов частей на слои в процессе финальной оптимизации.

split_parts_ranges_into_intersecting_and_non_intersecting_final​

ТипПо умолчанию
Bool1

Разделение диапазонов частей на пересекающиеся и непересекающиеся во время финальной оптимизации.

splitby_max_substrings_includes_remaining_string​

ТипПо умолчанию
Bool0

Управляет тем, следует ли функции splitBy*() включать оставшуюся строку в последнем элементе результирующего массива, если аргумент max_substrings > 0.

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

  • 0 - Оставшаяся строка не будет включена в последний элемент результирующего массива.
  • 1 - Оставшаяся строка будет включена в последний элемент результирующего массива. Это поведение функции split() Spark и метода 'string.split()' Python.

stop_refreshable_materialized_views_on_startup​

Experimental feature. Learn more.
ТипПо умолчанию
Bool0

При запуске сервера отключает планирование обновляемых материализованных представлений, как при SYSTEM STOP VIEWS. Вы можете вручную запустить их позже с помощью команды SYSTEM START VIEWS или SYSTEM START VIEW <name>. Также это относится к вновь созданным представлениям. Не влияет на не обновляемые материализованные представления.

storage_file_read_method​

ТипПо умолчанию
LocalFSReadMethodpread

Метод чтения данных из файлов хранилища, один из: read, pread, mmap. Метод mmap не применяется к clickhouse-server (предназначен для clickhouse-local).

storage_system_stack_trace_pipe_read_timeout_ms​

ТипПо умолчанию
Milliseconds100

Максимальное время для чтения из трубы для получения информации от потоков при запросе таблицы system.stack_trace. Эта настройка используется для тестирования и не предназначена для изменения пользователями.

stream_flush_interval_ms​

ТипПо умолчанию
Milliseconds7500

Работает для таблиц с потоковой передачей в случае таймаута или когда поток генерирует max_insert_block_size строк.

Значение по умолчанию составляет 7500.

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

stream_like_engine_allow_direct_select​

ТипПо умолчанию
Bool0

Разрешить прямой запрос SELECT для движков Kafka, RabbitMQ, FileLog, Redis Streams и NATS. Если прикреплены материализованные представления, запрос SELECT не допускается, даже если эта настройка включена.

stream_like_engine_insert_queue​

Когда движок, подобный потоку, читает из нескольких очередей, пользователю нужно будет выбрать одну очередь для вставки при записи. Используется для Redis Streams и NATS.

stream_poll_timeout_ms​

ТипПо умолчанию
Milliseconds500

Таймаут для опроса данных из/в потоковые хранилища.

system_events_show_zero_values​

ТипПо умолчанию
Bool0

Позволяет выбирать события с нулевыми значениями из system.events.

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

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

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

Примеры

Запрос

Результат

Запрос

Результат

table_function_remote_max_addresses​

ТипПо умолчанию
UInt641000

Устанавливает максимальное количество адресов, генерируемых из шаблонов для функции remote.

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

  • Положительное целое число.

tcp_keep_alive_timeout​

ТипПо умолчанию
Seconds290

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

temporary_data_in_cache_reserve_space_wait_lock_timeout_milliseconds​

ТипПо умолчанию
UInt64600000

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

temporary_files_codec​

ТипПо умолчанию
StringLZ4

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

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

  • LZ4 — Применяется сжатие LZ4.
  • NONE — Сжатие не применяется.

throw_if_deduplication_in_dependent_materialized_views_enabled_with_async_insert​

ТипПо умолчанию
Bool1

Выбросить исключение при выполнении запроса INSERT, если настройка deduplicate_blocks_in_dependent_materialized_views включена вместе с async_insert. Это гарантирует корректность, поскольку эти функции не могут работать вместе.

throw_if_no_data_to_insert​

ТипПо умолчанию
Bool1

Разрешает или запрещает пустые INSERT, по умолчанию включено (вызывает ошибку при пустом вставке). Применяется только к INSERT, выполняемым с помощью clickhouse-client или используя gRPC интерфейс.

throw_on_error_from_cache_on_write_operations​

ТипПо умолчанию
Bool0

Игнорировать ошибку из кэша при кэшировании операций записи (INSERT, слияния).

throw_on_max_partitions_per_insert_block​

ТипПо умолчанию
Bool1

Позволяет контролировать поведение, когда достигнуто значение max_partitions_per_insert_block.

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

  • true - Когда блок вставки достигает max_partitions_per_insert_block, происходит выброс исключения.
  • false - Логирует предупреждение, когда достигается max_partitions_per_insert_block.
подсказка

Это может быть полезно, если вы пытаетесь понять влияние на пользователей при изменении max_partitions_per_insert_block.

throw_on_unsupported_query_inside_transaction​

Experimental feature. Learn more.
ТипПо умолчанию
Bool1

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

timeout_before_checking_execution_speed​

ТипПо умолчанию
Seconds10

Проверяет, что скорость выполнения не слишком мала (не менее min_execution_speed), после истечения указанного времени в секундах.

timeout_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что делать, если запрос выполняется дольше, чем max_execution_time или оцениваемое время выполнения больше, чем max_estimated_execution_time.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные закончились.

timeout_overflow_mode_leaf​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что происходит, когда запрос в узле-листье выполняется дольше, чем max_execution_time_leaf.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные закончились.

totals_auto_threshold​

ТипПо умолчанию
Float0.5

Порог для totals_mode = 'auto'. Смотрите раздел "Модификатор WITH TOTALS".

totals_mode​

ТипПо умолчанию
TotalsModeafter_having_exclusive

Как рассчитывать ИТОГИ, когда присутствует HAVING, а также когда присутствуют max_rows_to_group_by и group_by_overflow_mode = 'any'. Смотрите раздел "Модификатор WITH TOTALS".

trace_profile_events​

ТипПо умолчанию
Bool0

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

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

  • 1 — Включено трассирование событий профилирования.
  • 0 — Отключено трассирование событий профилирования.

transfer_overflow_mode​

ТипПо умолчанию
OverflowModethrow

Устанавливает, что происходит, когда объем данных превышает один из лимитов.

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

  • throw: выбросить исключение (по умолчанию).
  • break: остановить выполнение запроса и вернуть частичный результат, как если бы исходные данные закончились.

transform_null_in​

ТипПо умолчанию
Bool0

Включает равенство значений NULL для оператора IN.

По умолчанию, значения NULL не могут быть сравнены, потому что NULL означает неопределенное значение. Таким образом, сравнение expr = NULL должно всегда возвращать false. С этой настройкой NULL = NULL возвращает true для оператора IN.

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

  • 0 — Сравнение значений NULL в операторе IN возвращает false.
  • 1 — Сравнение значений NULL в операторе IN возвращает true.

Пример

Рассмотрим таблицу null_in:

Запрос:

Результат:

Запрос:

Результат:

Смотрите также

traverse_shadow_remote_data_paths​

ТипПо умолчанию
Bool0

Обходит замороженные данные (теневая директория) в дополнение к фактическим данным таблицы при выполнении запроса system.remote_data_paths.

union_default_mode​

Устанавливает режим для объединения результатов запросов SELECT. Настройка используется только в случае совместного использования с UNION, не указывая явно UNION ALL или UNION DISTINCT.

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

  • 'DISTINCT' — ClickHouse выводит строки в результате объединения запросов, убирая дублирующиеся строки.
  • 'ALL' — ClickHouse выводит все строки в результате объединения запросов, включая дублирующиеся строки.
  • '' — ClickHouse генерирует исключение при использовании с UNION.

Смотрите примеры в UNION.

unknown_packet_in_send_data​

ТипПо умолчанию
UInt640

Отправить неизвестный пакет вместо N-го пакета данных.

use_async_executor_for_materialized_views​

ТипПо умолчанию
Bool0

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

use_cache_for_count_from_files​

ТипПо умолчанию
Bool1

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

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

use_client_time_zone​

ТипПо умолчанию
Bool0

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

use_compact_format_in_distributed_parts_names​

ТипПо умолчанию
Bool1

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

ТипПо умолчанию
Bool1

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

use_hedged_requests​

ТипПо умолчанию
Bool1

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

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

Отключено по умолчанию в Cloud.

use_hive_partitioning​

ТипПо умолчанию
Bool1

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

use_iceberg_partition_pruning​

ТипПо умолчанию
Bool0

Использовать обрезку партиций Iceberg для таблиц Iceberg.

use_index_for_in_with_subqueries​

ТипПо умолчанию
Bool1

Попробуйте использовать индекс, если с правой стороны оператора IN находится подзапрос или табличное выражение.

use_index_for_in_with_subqueries_max_values​

ТипПо умолчанию
UInt640

Максимальный размер множества с правой стороны оператора IN для использования табличного индекса для фильтрации. Позволяет избежать снижения производительности и большего использования памяти из-за подготовки дополнительных структур данных для больших запросов. Ноль означает отсутствие предела.

use_json_alias_for_old_object_type​

ТипПо умолчанию
Bool0

При включении будет использоваться псевдоним типа JSON для создания старого типа Object('json') вместо нового типа JSON.

use_page_cache_for_disks_without_file_cache​

ТипПо умолчанию
Bool0

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

use_page_cache_with_distributed_cache​

ТипПо умолчанию
Bool0

Использовать кэш страниц пользовательского пространства, когда используется распределенный кэш.

use_query_cache​

ТипПо умолчанию
Bool0

Если включено, запросы SELECT могут использовать кэш запросов. Параметры enable_reads_from_query_cache и enable_writes_to_query_cache более подробно контролируют, как используется кэш.

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

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

use_query_condition_cache​

ТипПо умолчанию
Bool0

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

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

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

use_skip_indexes​

ТипПо умолчанию
Bool1

Использовать индексы пропуска данных во время выполнения запроса.

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

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

use_skip_indexes_if_final​

ТипПо умолчанию
Bool0

Контролирует, используются ли индексы пропуска при выполнении запроса с модификатором FINAL.

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

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

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

use_structure_from_insertion_table_in_table_functions​

ТипПо умолчанию
UInt642

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

use_uncompressed_cache​

ТипПо умолчанию
Bool0

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

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

use_variant_as_common_type​

ТипПо умолчанию
Bool0

Позволяет использовать тип Variant в качестве возвращаемого типа для функций if/multiIf/array/map, когда нет общего типа для аргументных типов.

Пример:

use_with_fill_by_sorting_prefix​

ТипПо умолчанию
Bool1

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

validate_enum_literals_in_operators​

ТипПо умолчанию
Bool0

Если включено, проверять литералы перечислений в операторах, таких как IN, NOT IN, ==, != на соответствие типу перечисления и выбрасывать исключение, если литерал не является допустимым значением перечисления.

validate_mutation_query​

ТипПо умолчанию
Bool1

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

Изменяйте эту настройку только в случае, если вы столкнетесь с ошибкой, несовместимой с обратной совместимостью.

validate_polygons​

ТипПо умолчанию
Bool1

Включает или отключает выброс исключения в функции pointInPolygon, если многоугольник самопересекается или самотангенциален.

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

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

wait_changes_become_visible_after_commit_mode​

Experimental feature. Learn more.
ТипПо умолчанию
TransactionsWaitCSNModewait_unknown

Ожидать, пока зафиксированные изменения фактически станут видимыми в последнем снимке.

wait_for_async_insert​

ТипПо умолчанию
Bool1

Если true, ждать завершения обработки асинхронной вставки.

wait_for_async_insert_timeout​

ТипПо умолчанию
Seconds120

Тайм-аут ожидания завершения обработки асинхронной вставки.

wait_for_window_view_fire_signal_timeout​

Experimental feature. Learn more.
ТипПо умолчанию
Seconds10

Тайм-аут ожидания сигнала срабатывания оконного представления при обработке событий времени.

window_view_clean_interval​

Experimental feature. Learn more.
ТипПо умолчанию
Seconds60

Интервал очистки оконного представления в секундах для освобождения устаревших данных.

window_view_heartbeat_interval​

Experimental feature. Learn more.
ТипПо умолчанию
Seconds15

Интервал heartbeat в секундах, чтобы указать, что наблюдаемый запрос активен.

workload​

ТипПо умолчанию
Stringdefault

Имя рабочей нагрузки, используемой для доступа к ресурсам.

write_through_distributed_cache​

ClickHouse Cloud only
ТипПо умолчанию
Bool0

Эта настройка действует только в ClickHouse Cloud. Разрешает запись в распределенный кэш (запись в s3 также будет выполнена через распределенный кэш).

zstd_window_log_max​

ТипПо умолчанию
Int640

Позволяет выбрать максимальный лог окна ZSTD (не будет использоваться для семейства MergeTree).