Все настройки, приведенные ниже, также доступны в таблице system.settings. Эти настройки автоматически генерируются из исходного кода.
Добавлять HTTP-заголовок CORS.
Дополнительное фильтрующее выражение, применяемое к результату запроса SELECT.
Этот параметр не применяется ни к одному подзапросу.
Пример
INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd');
SElECT * FROM table_1;
┌─x─┬─y────┐
│ 1 │ a │
│ 2 │ bb │
│ 3 │ ccc │
│ 4 │ dddd │
└───┴──────┘
SELECT *
FROM table_1
SETTINGS additional_result_filter = 'x != 2'
┌─x─┬─y────┐
│ 1 │ a │
│ 3 │ ccc │
│ 4 │ dddd │
└───┴──────┘
INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd');
SELECT * FROM table_1;
┌─x─┬─y────┐
│ 1 │ a │
│ 2 │ bb │
│ 3 │ ccc │
│ 4 │ dddd │
└───┴──────┘
SELECT *
FROM table_1
SETTINGS additional_table_filters = {'table_1': 'x != 2'}
┌─x─┬─y────┐
│ 1 │ a │
│ 3 │ ccc │
│ 4 │ dddd │
└───┴──────┘
state — Двоичная строка с сериализованным состоянием (по умолчанию). Это стандартное поведение, при котором значения AggregateFunction ожидаются в виде двоичных данных.value — Формат ожидает одно значение аргумента агрегатной функции или, в случае нескольких аргументов, их кортеж. Они будут десериализованы с использованием соответствующего IDataType или DataTypeTuple, а затем агрегированы для формирования состояния.array — Формат ожидает Array значений, как описано выше для варианта value. Все элементы массива будут агрегированы для формирования состояния.
Примеры
Для таблицы со следующей структурой:
CREATE TABLE example (
user_id UInt64,
avg_session_length AggregateFunction(avg, UInt32)
);
aggregate_function_input_format = 'value':
INSERT INTO example FORMAT CSV
123,456
aggregate_function_input_format = 'array':
INSERT INTO example FORMAT CSV
123,"[456,789,101]"
value и array работают медленнее, чем формат state по умолчанию, так как при вставке для них требуется создавать и агрегировать значения.
aggregate_functions_null_for_empty
- 0 — Отключено.
- 1 — Включено.
Пример
Рассмотрим следующий запрос с агрегатными функциями:
SELECT SUM(-1), MAX(0) FROM system.one WHERE 0;
aggregate_functions_null_for_empty = 0 результат будет таким:
┌─SUM(-1)─┬─MAX(0)─┐
│ 0 │ 0 │
└─────────┴────────┘
aggregate_functions_null_for_empty = 1 результат будет таким:
┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐
│ NULL │ NULL │
└───────────────┴──────────────┘
aggregation_in_order_max_block_bytes
aggregation_memory_efficient_merge_threads
ai_function_max_api_calls_per_query
ai_function_max_output_tokens_per_query
ai_function_retry_initial_delay_ms.
ai_function_request_timeout_sec
ai_function_max_retries.
ai_function_retry_initial_delay_ms
ai_function_throw_on_error
ai_function_throw_on_quota_exceeded
ai_function_max_input_tokens_per_query, ai_function_max_output_tokens_per_query или ai_function_max_api_calls_per_query) запрос прерывается с исключением. Если false, для оставшихся строк используется значение по умолчанию для типа столбца (пустая строка для String).
allow_aggregate_partitions_independently
allow_archive_path_syntax
<archive> :: <file>, если у архива корректное расширение.
allow_asynchronous_read_from_io_pool_for_merge_tree
allow_calculating_subcolumns_sizes_for_merge_tree_reading
allow_changing_replica_until_first_data_packet
receive_data_timeout); в противном случае смена реплики запрещается после первого появления прогресса.
allow_create_index_without_type
allow_custom_error_code_in_throwif
allow_deprecated_database_ordinary
allow_deprecated_error_prone_window_functions
allow_deprecated_snowflake_conversion_functions
snowflakeToDateTime, snowflakeToDateTime64, dateTimeToSnowflake и dateTime64ToSnowflake устарели и по умолчанию отключены.
Вместо них используйте функции snowflakeIDToDateTime, snowflakeIDToDateTime64, dateTimeToSnowflakeID и dateTime64ToSnowflakeID.
Чтобы снова включить устаревшие функции (например, в переходный период), установите для этой настройки значение true.
allow_deprecated_syntax_for_merge_tree
allow_dynamic_type_in_join_keys
allow_execute_multiif_columnar
allow_experimental_ai_functions
aiGenerateContent). Эти функции выполняют внешние HTTP-запросы к поставщикам ИИ.
allow_experimental_analyzer
enable_analyzer
Разрешает использование нового анализатора запросов.
allow_experimental_cleanup_old_data_files_compaction
allow_experimental_codecs
allow_experimental_database_glue_catalog
allow_database_glue_catalog
Разрешает использование экспериментального движка базы данных DataLakeCatalog с catalog_type = ‘glue’
Значение по умолчанию в Cloud: 1.
allow_experimental_database_hms_catalog
allow_experimental_database_iceberg
allow_database_iceberg
Разрешает использование экспериментального движка базы данных DataLakeCatalog с catalog_type = 'iceberg'
Значение по умолчанию в Cloud: 1.
allow_experimental_database_materialized_postgresql
allow_experimental_database_paimon_rest_catalog
allow_experimental_database_unity_catalog
allow_database_unity_catalog
Разрешить использование экспериментального движка базы данных DataLakeCatalog с catalog_type = ‘unity’
Значение по умолчанию в Cloud: 1.
allow_experimental_delta_kernel_rs
allow_experimental_delta_lake_writes
allow_experimental_expire_snapshots
ALTER TABLE ... EXECUTE expire_snapshots.
allow_experimental_funnel_functions
allow_experimental_geo_types_in_iceberg
geometry и geography в Iceberg как тип ClickHouse Geometry (Variant).
allow_experimental_hash_functions
allow_experimental_iceberg_compaction
allow_experimental_join_right_table_sorting
join_to_sort_minimum_perkey_rows и join_to_sort_maximum_table_rows, правая таблица переупорядочивается по ключу для повышения производительности при левом или внутреннем hash JOIN.
allow_experimental_json_lazy_type_hints
allow_experimental_kafka_offsets_storage_in_keeper
allow_experimental_kusto_dialect
allow_experimental_materialized_postgresql_table
allow_experimental_nlp_functions
allow_experimental_nullable_tuple_type
Nullable (например, из столбцов Dynamic, Variant, JSON или Tuple).
Используйте allow_nullable_tuple_in_extracted_subcolumns, чтобы управлять тем, могут ли извлечённые подстолбцы Tuple быть Nullable.
allow_experimental_object_storage_queue_hive_partitioning
allow_experimental_paimon_storage_engine
allow_experimental_parallel_reading_from_replicas
enable_parallel_replicas
Для выполнения SELECT-запросов использует до max_parallel_replicas реплик из каждого сегмента. Чтение распараллеливается и координируется динамически. 0 — отключено, 1 — включено, при сбое отключается без уведомления, 2 — включено, при сбое генерируется исключение
allow_experimental_polyglot_dialect
allow_experimental_prql_dialect
allow_experimental_query_deduplication
allow_experimental_time_series_aggregate_functions
allow_experimental_ts_to_grid_aggregate_function
Экспериментальные агрегатные функции timeSeries* для передискретизации временных рядов, а также вычисления rate и delta в стиле Prometheus.
allow_experimental_time_series_table
allow_experimental_unique_key
UNIQUE KEY на движках семейства MergeTree.
allow_experimental_window_view
allow_experimental_ytsaurus_dictionary_source
allow_experimental_ytsaurus_table_engine
allow_experimental_ytsaurus_table_function
allow_fuzz_query_functions
fuzzQuery, которая применяет случайные мутации AST к строке запроса.
allow_general_join_planning
getClientHTTPHeader, которая позволяет получать значение заголовка текущего HTTP-запроса. По соображениям безопасности этот параметр по умолчанию отключен, поскольку некоторые заголовки, например Cookie, могут содержать конфиденциальную информацию. Обратите внимание, что заголовки X-ClickHouse-* и Authentication всегда недоступны, и получить их с помощью этой функции нельзя.
Разрешает использование функций, работающих с библиотекой Hyperscan. Отключите этот параметр, чтобы избежать потенциально длительной компиляции и чрезмерного потребления ресурсов.
allow_iceberg_remove_orphan_files
allow_insert_into_iceberg
allow_experimental_insert_into_iceberg
Разрешает выполнять запросы insert в Iceberg.
allow_introspection_functions
- 1 — Функции интроспекции включены.
- 0 — Функции интроспекции отключены.
См. также
allow_key_condition_coalesce_rewrite
coalesce(a_1, ..., a_N) <op> const (а также эквивалентные выражения с ifNull или с константой слева) в дизъюнкцию (a_1 <op> const) OR (a_1 IS NULL AND a_2 <op> const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N <op> const) перед анализом индексов, чтобы можно было использовать первичный ключ по отдельным столбцам и индексы пропуска данных для каждого a_i. Поддерживаются и формы с частичными константами, такие как coalesce(a, 42, b) и coalesce(a, b, 42): список аргументов нормализуется так же, как в самом coalesce (литералы NULL отбрасываются, аргументы после первого не-Nullable отбрасываются), а завершающая не-NULL константа, если она есть, добавляется как последняя ветвь. Это преобразование используется только для дополнительного отсечения по индексам; фильтрация во время выполнения по-прежнему использует исходный предикат.
allow_materialized_view_with_bad_select
allow_named_collection_override_by_default
allow_nonconst_timezone_arguments
allow_nondeterministic_mutations
dictGet.
Поскольку, например, словари могут быть не синхронизированы между узлами, мутации, которые получают из них значения, по умолчанию запрещены для реплицируемых таблиц. Включение этой настройки разрешает такое поведение, и пользователь должен сам обеспечить синхронизацию используемых данных на всех узлах.
Пример
<profiles>
<default>
<allow_nondeterministic_mutations>1</allow_nondeterministic_mutations>
<!-- ... -->
</default>
<!-- ... -->
</profiles>
allow_nondeterministic_optimize_skip_unused_shards
rand или dictGet, поскольку у последней есть некоторые особенности, связанные с обновлениями) в ключе сегментирования.
Возможные значения:
- 0 — Запрещено.
- 1 — Разрешено.
allow_nullable_tuple_in_extracted_subcolumns
Tuple(...) иметь тип Nullable(Tuple(...)).
false: Возвращает Tuple(...) и использует значения кортежа по умолчанию для строк, в которых подстолбец отсутствует.true: Возвращает Nullable(Tuple(...)) и использует NULL для строк, в которых подстолбец отсутствует.
Эта настройка влияет только на поведение извлечённых подстолбцов.
Она не определяет, можно ли создавать в таблицах столбцы Nullable(Tuple(...)); это регулируется параметром allow_experimental_nullable_tuple_type.
ClickHouse использует значение этой настройки, загруженное при запуске сервера.
Изменения, внесённые с помощью SET или SETTINGS на уровне запроса, не меняют поведение извлечённых подстолбцов.
Чтобы изменить поведение извлечённых подстолбцов, обновите allow_nullable_tuple_in_extracted_subcolumns в конфигурации профиля запуска (например, в users.xml) и перезапустите сервер.
allow_prefetched_read_pool_for_local_filesystem
allow_prefetched_read_pool_for_remote_filesystem
allow_push_predicate_ast_for_distributed_subqueries
allow_push_predicate_when_subquery_contains_with
allow_rank_dense_rank_arguments
RANK и DENSE_RANK для обратной совместимости.
Согласно стандарту SQL, RANK и DENSE_RANK не принимают аргументов — они ранжируют строки только по
окну OVER (ORDER BY ...). В версиях ClickHouse до 26.5 запросы вида
RANK(x) OVER (...) молча принимались, а аргумент игнорировался, что вызывало путаницу у пользователей
(видимый аргумент создавал впечатление, что он влияет на ранжирование, хотя это не так).
Когда этот параметр имеет значение false (по умолчанию), RANK и DENSE_RANK отклоняют любые аргументы и
выдают ошибку NUMBER_OF_ARGUMENTS_DOESNT_MATCH. Если установить значение true, восстанавливается
прежнее более мягкое поведение — аргументы молча игнорируются, как и до версии 26.5.
allow_reorder_prewhere_conditions
SETTINGS после FORMAT в запросах INSERT. Использовать это не рекомендуется, поскольку часть SETTINGS может интерпретироваться как значения.
Пример:
INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');
allow_settings_after_format_in_insert:
SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;
- 0 — Запретить.
- 1 — Разрешить.
Используйте эту настройку только для обеспечения обратной совместимости, если ваши сценарии использования зависят от старого синтаксиса.
allow_experimental_statistics
Позволяет задавать для столбцов статистику и управлять статистикой.
allow_statistics_optimize
allow_statistic_optimize
Разрешает использовать статистику для оптимизации запросов
При значении true можно указывать бессмысленные кодеки сжатия.
allow_suspicious_fixed_string_types
allow_suspicious_low_cardinality_types
FixedString(8_bytes_or_less).
Для небольших значений фиксированного размера использование LowCardinality обычно неэффективно, поскольку ClickHouse хранит числовой индекс для каждой строки. В результате:
- Может увеличиться использование дискового пространства.
- Потребление оперативной памяти может возрасти в зависимости от размера словаря.
- Некоторые функции могут работать медленнее из-за дополнительных операций кодирования и декодирования.
В таблицах с движком MergeTree время слияния также может увеличиться по всем перечисленным выше причинам.
Возможные значения:
- 1 — Использование
LowCardinality не ограничено.
- 0 — Использование
LowCardinality ограничено.
allow_suspicious_primary_key
PRIMARY KEY/ORDER BY для MergeTree (например, SimpleAggregateFunction).
allow_suspicious_ttl_expressions
allow_suspicious_types_in_group_by
allow_suspicious_types_in_order_by
allow_suspicious_variant_types
allow_unrestricted_reads_from_keeper
alter_move_to_space_execute_async
alter_partition_verbose_result
- 0 — отключить подробный вывод.
- 1 — включить подробный вывод.
Пример
CREATE TABLE test(a Int64, d Date, s String) ENGINE = MergeTree PARTITION BY toYYYYMDECLARE(d) ORDER BY a;
INSERT INTO test VALUES(1, '2021-01-01', '');
INSERT INTO test VALUES(1, '2021-01-01', '');
ALTER TABLE test DETACH PARTITION ID '202101';
ALTER TABLE test ATTACH PARTITION ID '202101' SETTINGS alter_partition_verbose_result = 1;
┌─command_type─────┬─partition_id─┬─part_name────┬─old_part_name─┐
│ ATTACH PARTITION │ 202101 │ 202101_7_7_0 │ 202101_5_5_0 │
│ ATTACH PARTITION │ 202101 │ 202101_8_8_0 │ 202101_6_6_0 │
└──────────────────┴──────────────┴──────────────┴───────────────┘
ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1;
┌─command_type─┬─partition_id─┬─part_name────┬─backup_name─┬─backup_path───────────────────┬─part_backup_path────────────────────────────────────────────┐
│ FREEZE ALL │ 202101 │ 202101_7_7_0 │ 8 │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_7_7_0 │
│ FREEZE ALL │ 202101 │ 202101_8_8_0 │ 8 │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_8_8_0 │
└──────────────┴──────────────┴──────────────┴─────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────┘
replication_alter_partitions_sync
Позволяет указать, как ожидать выполнение действий на репликах для запросов ALTER, OPTIMIZE или TRUNCATE.
Возможные значения:
0 — Не ждать.1 — Ждать выполнения на текущей реплике.2 — Ждать выполнения на всех репликах.3 - Ждать только активные реплики.
Значение по умолчанию в Cloud: 0.
alter_sync применим только к таблицам Replicated и SharedMergeTree; для таблиц без Replicated или Shared при выполнении ALTER он ничего не делает.
ALTER с командой UPDATE.
Возможные значения:
heavy — выполнять обычную мутацию.lightweight — выполнять легковесное обновление, если это возможно; в противном случае выполнять обычную мутацию.lightweight_force — выполнять легковесное обновление, если это возможно; в противном случае сгенерировать исключение.
analyze_index_with_space_filling_curves
ORDER BY mortonEncode(x, y) или ORDER BY hilbertEncode(x, y), и запрос содержит условия по её аргументам, например x >= 10 AND x <= 20 AND y >= 20 AND y <= 30, используйте пространственно-заполняющую кривую для анализа индекса.
analyzer_compatibility_allow_compound_identifiers_in_unflatten_nested
SELECT a.b.c FROM table ARRAY JOIN a не работает, а SELECT a FROM table не включает столбец a.b.c в результат Nested a.
analyzer_compatibility_join_using_top_level_identifier
SELECT a + 1 AS b FROM t1 JOIN t2 USING (b) JOIN будет выполняться по условию t1.a + 1 = t2.b, а не t1.b = t2.b).
При включении анализатор разворачивает обычные (нематериализованные, непараметризованные) представления в их определяющие подзапросы, что делает возможными сквозные оптимизации, такие как pushdown предикатов и отсечение столбцов.
any_join_distinct_right_table_keys
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 — Устаревшее поведение включено.
См. также:
Включает отфильтровывание строк, удалённых с помощью легковесного DELETE. Если параметр отключён, запрос сможет читать эти строки. Это полезно для отладки и сценариев “восстановления удалённых данных”
Если установлено значение true, мутации (UPDATE и DELETE), которые не материализованы в части данных, будут применяться при выполнении SELECT.
Если значение равно true, патч-части (представляющие собой легковесные обновления) применяются при выполнении SELECT.
apply_patch_parts_join_cache_buckets
apply_prewhere_after_final
apply_row_policy_after_final
- 0 — Row policy и PREWHERE применяются до FINAL (по умолчанию).
- 1 — Row policy и PREWHERE применяются после FINAL.
apply_settings_from_server
ALTER USER), а не через клиент (аргументами командной строки клиента, запросом SET или в секции SETTINGS запроса SELECT). Через клиент её можно изменить на false, но нельзя изменить на true (потому что сервер не отправит настройки, если в профиле пользователя установлено apply_settings_from_server = false).
Обратите внимание, что изначально (24.12) существовала настройка сервера (send_settings_to_client), но позже её заменили этой клиентской настройкой для большего удобства.
archive_adaptive_buffer_max_size_bytes
arrow_flight_request_descriptor_type
- ‘path’ — Использовать FlightDescriptor::Path (по умолчанию; работает с большинством серверов Arrow Flight)
- ‘command’ — Использовать FlightDescriptor::Command с запросом SELECT (требуется для Dremio)
Если установлено значение false (по умолчанию), AST-фаззер на стороне сервера (управляется параметром ast_fuzzer_runs) выполняет фаззинг только запросов в режиме только для чтения (SELECT, EXPLAIN, SHOW, DESCRIBE, EXISTS). Если true, фаззингу подвергаются все типы запросов, включая DDL и INSERT.
Включает серверный AST-фаззер, который после каждого обычного запроса запускает случайно сгенерированные запросы, отбрасывая их результаты.
- 0: отключено (по умолчанию).
- Значение между 0 и 1 (не включая границы): вероятность запуска одного фаззинг-запроса.
- Значение >= 1: число фаззинг-запросов, запускаемых на каждый обычный запрос.
Фаззер накапливает AST-фрагменты из всех запросов во всех сеансах, со временем создавая всё более интересные мутации. Фаззинг-запросы, завершающиеся ошибкой, молча отбрасываются; результаты клиенту не возвращаются.
asterisk_include_alias_columns
SELECT *).
Возможные значения:
- 0 - отключено
- 1 - включено
asterisk_include_materialized_columns
SELECT *).
Возможные значения:
- 0 - отключено
- 1 - включено
asterisk_include_virtual_columns
SELECT *).
Возможные значения:
- 0 - отключено
- 1 - включено
Если значение равно true, данные из запроса INSERT сохраняются в очереди и позже в фоновом режиме записываются в таблицу. Если wait_for_async_insert имеет значение false, запрос INSERT обрабатывается почти мгновенно, в противном случае клиент будет ждать, пока данные не будут записаны в таблицу
async_insert_busy_timeout_decrease_rate
async_insert_busy_timeout_increase_rate
async_insert_busy_timeout_max_ms
async_insert_busy_timeout_ms
Максимальное время ожидания перед сбросом собранных данных по каждому запросу с момента поступления первых данных.
Значение по умолчанию в Cloud: 1000 (1s).
async_insert_busy_timeout_min_ms
async_insert_max_data_size
104857600 (100 MiB).
async_insert_max_query_number
async_insert_deduplicate равно 1.
async_insert_poll_timeout_ms
async_insert_use_adaptive_busy_timeout
async_query_sending_for_remote
automatic_parallel_replicas_min_bytes_per_replica
automatic_parallel_replicas_mode=1). 0 означает отсутствие порога.
Общее количество байт для чтения оценивается на основе собранной статистики.
automatic_parallel_replicas_mode
enable_analyzer = 1, enable_parallel_replicas != 0, parallel_replicas_local_plan = 1 и указания cluster_for_parallel_replicas.
0 — отключено, 1 — включено, 2 — включен только сбор статистики (переключение на выполнение с параллельными репликами отключено).
azure_allow_parallel_part_upload
azure_check_objects_after_upload
azure_create_new_file_on_insert
azure_ignore_file_doesnt_exist
- 1 —
SELECT возвращает пустой результат.
- 0 —
SELECT генерирует исключение.
azure_list_object_keys_size
azure_max_blocks_in_multipart_upload
azure_max_get_rps
Ограничение на число Azure GET-запросов в секунду до начала throttling. Ноль означает отсутствие ограничений.
azure_max_inflight_parts_for_one_file
azure_max_put_rps
Ограничение на количество Azure PUT-запросов в секунду до начала троттлинга. Ноль означает отсутствие ограничений.
Максимально допустимое количество перенаправлений Azure.
azure_max_single_part_copy_size
azure_max_single_part_upload_size
azure_max_single_read_retries
azure_max_unexpected_write_error_retries
azure_max_upload_part_size
azure_min_upload_part_size
azure_sdk_retry_initial_backoff_ms
azure_sdk_retry_max_backoff_ms
- 0 —
SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
- 1 —
SELECT возвращает пустой результат для пустого файла.
azure_strict_upload_part_size
azure_throw_on_zero_files_match
- 1 —
SELECT генерирует исключение.
- 0 —
SELECT возвращает пустой результат.
Включает или отключает выполнение TRUNCATE перед вставкой в таблицы движка Azure.
azure_upload_part_size_multiply_factor
azure_upload_part_size_multiply_parts_count_threshold
azure_use_adaptive_timeouts
true, то для всех запросов к Azure первые две попытки выполняются с меньшими тайм-аутами отправки и получения.
Если установлено значение false, то все попытки выполняются с одинаковыми тайм-аутами.
backup_restore_batch_size_for_keeper_multi
backup_restore_batch_size_for_keeper_multiread
backup_restore_failure_after_host_disconnected_for_seconds
backup_restore_finish_timeout_after_error_sec
backup_restore_keeper_fault_injection_probability
backup_restore_keeper_fault_injection_seed
backup_restore_keeper_max_retries
backup_restore_keeper_max_retries_while_handling_error
backup_restore_keeper_max_retries_while_initializing
backup_restore_keeper_retry_initial_backoff_ms
backup_restore_keeper_retry_max_backoff_ms
60000.
backup_restore_keeper_value_max_size
backup_restore_s3_retry_attempts
backup_restore_s3_retry_initial_backoff_ms
backup_restore_s3_retry_max_backoff_ms
backup_restore_s3_retry_jitter_factor
backup_restore_s3_retry_max_backoff_ms. Должен находиться в интервале [0.0, 1.0]
backup_restore_s3_retry_max_backoff_ms
backup_slow_all_threads_after_retryable_s3_error
true, все потоки, выполняющие запросы S3 к одной и той же конечной точке резервного копирования, замедляются
после того, как хотя бы один запрос S3 получает ошибку S3, допускающую повторную попытку, например ‘Slow Down’.
Если установлено значение false, каждый поток обрабатывает задержку запросов S3 независимо от остальных.
Действует только в ClickHouse Cloud. Количество фоновых потоков для упреждающей загрузки новых частей данных в файловый кэш при включенном cache_populated_by_fetch. Значение 0 отключает эту возможность.
calculate_text_stack_trace
cancel_http_readonly_queries_on_client_close
SELECT), если клиент закрывает соединение, не дождавшись ответа.
Значение по умолчанию в Cloud: 1.
cast_ipv4_ipv6_default_on_conversion_error
Nullable в операциях CAST.
Если настройка включена и аргумент функции CAST имеет тип Nullable, результат также преобразуется в тип Nullable. Если настройка отключена, результат всегда имеет в точности указанный тип пункта назначения.
Возможные значения:
- 0 — Результат
CAST имеет в точности указанный тип пункта назначения.
- 1 — Если аргумент имеет тип
Nullable, результат CAST преобразуется в Nullable(DestinationDataType).
Примеры
Следующий запрос возвращает результат с точно указанным типом пункта назначения:
SET cast_keep_nullable = 0;
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
│ 0 │ Int32 │
└───┴───────────────────────────────────────────────────┘
Nullable к целевому типу данных:
SET cast_keep_nullable = 1;
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
│ 0 │ Nullable(Int32) │
└───┴───────────────────────────────────────────────────┘
cast_string_to_date_time_mode
-
'best_effort' — Включает расширенный разбор.
ClickHouse может разбирать базовый формат YYYY-MM-DD HH:MM:SS и все форматы даты и времени ISO 8601. Например, '2018-06-08T01:02:03.000Z'.
-
'best_effort_us' — Аналогично best_effort (различия см. в parseDateTimeBestEffortUS
-
'basic' — Использует базовый парсер.
ClickHouse может разбирать только базовый формат YYYY-MM-DD HH:MM:SS или YYYY-MM-DD. Например, 2019-08-20 10:18:56 или 2019-08-20.
См. также:
cast_string_to_dynamic_use_inference
cast_string_to_variant_use_inference
check_named_collection_dependencies
check_query_single_value_result
MergeTree .
Возможные значения:
- 0 — запрос показывает статус проверки для каждой отдельной части данных таблицы.
- 1 — запрос показывает общий статус проверки таблицы.
check_referential_table_dependencies
1.
cloud_mode_database_engine
2.
Семейство движков, разрешённых в Cloud.
- 0 - разрешить всё
- 1 - переписывать DDL-запросы с использованием *ReplicatedMergeTree
- 2 - переписывать DDL-запросы с использованием SharedMergeTree
- 3 - переписывать DDL-запросы с использованием SharedMergeTree, кроме случаев, когда явно указан удалённый диск
- 4 - то же, что и 3, но дополнительно использовать Alias вместо Distributed (таблица Alias будет указывать на целевую таблицу таблицы Distributed, поэтому будет использоваться соответствующая локальная таблица)
UInt64 для минимизации публичной части
Значение по умолчанию в Cloud: 2.
cluster_for_parallel_replicas
default.
cluster_function_process_archive_on_multiple_nodes
true, повышает производительность обработки архивов в функциях cluster. Для совместимости и во избежание ошибок при обновлении до 25.7+ следует установить значение false, если вы используете функции cluster с архивами в версиях ниже 25.7.
cluster_table_function_buckets_batch_size
bucket. Система накапливает данные, пока не достигнет как минимум этого объёма. Фактический размер может быть немного больше для выравнивания по границам данных.
cluster_table_function_split_granularity
file — каждая задача обрабатывает файл целиком.bucket — задачи создаются для каждого внутреннего блока данных в файле (например, для групп строк в Parquet).
Выбор более мелкой гранулярности (например, bucket) может повысить параллелизм при работе с небольшим количеством крупных файлов.
Например, если файл Parquet содержит несколько групп строк, включение гранулярности bucket позволяет обрабатывать каждую группу независимо разными воркерами.
collect_hash_table_stats_during_aggregation
collect_hash_table_stats_during_joins
compatibility заставляет ClickHouse использовать настройки по умолчанию из предыдущей версии ClickHouse, номер которой задается в этом параметре.
Если для каких-либо настроек заданы значения, отличные от значений по умолчанию, они сохраняются (параметр compatibility влияет только на те настройки, которые не были изменены).
Этот параметр принимает номер версии ClickHouse в виде строки, например 22.3 или 22.8. Пустое значение означает, что параметр отключен.
По умолчанию отключен.
В ClickHouse Cloud значение параметра compatibility по умолчанию на уровне сервиса должна задавать служба поддержки ClickHouse Cloud. Чтобы его установили, создайте обращение.
Однако параметр compatibility можно переопределить на уровне пользователя, роли, profile, запроса или сеанса с помощью стандартных механизмов настройки ClickHouse, например SET compatibility = '22.3' в сеансе или SETTINGS compatibility = '22.3' в запросе. compatibility_ignore_auto_increment_in_create_table
compatibility_ignore_collation_in_create_table
compatibility_s3_presigned_url_query_in_path
compile_aggregate_expressions
- 0 — агрегация выполняется без JIT-компиляции.
- 1 — агрегация выполняется с использованием JIT-компиляции.
См. также
Компилирует некоторые скалярные функции и операторы в нативный код.
Компиляция описания сортировки в нативный код.
Тайм-аут соединения, если реплики отсутствуют.
connect_timeout_with_failover_ms
connect_timeout_with_failover_secure_ms
connection_pool_max_wait_ms
- Положительное целое число.
- 0 — бесконечный тайм-аут.
connections_with_failover_max_tries
true, запрос SELECT будет преобразован в конъюнктивную нормальную форму (CNF). В некоторых случаях преобразование запроса в CNF может выполняться быстрее (объяснение см. в этом Github issue).
Например, обратите внимание, что следующий запрос SELECT не изменяется (это поведение по умолчанию):
EXPLAIN SYNTAX
SELECT *
FROM
(
SELECT number AS x
FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = false;
┌─explain────────────────────────────────────────────────────────┐
│ SELECT x │
│ FROM │
│ ( │
│ SELECT number AS x │
│ FROM numbers(20) │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ ) AS a │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ SETTINGS convert_query_to_cnf = 0 │
└────────────────────────────────────────────────────────────────┘
convert_query_to_cnf значение true и посмотрим, что изменится:
EXPLAIN SYNTAX
SELECT *
FROM
(
SELECT number AS x
FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = true;
WHERE переписано в КНФ, но результирующий набор остался тем же — булева логика не изменилась:
┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SELECT x │
│ FROM │
│ ( │
│ SELECT number AS x │
│ FROM numbers(20) │
│ WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │
│ ) AS a │
│ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5)) │
│ SETTINGS convert_query_to_cnf = 1 │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
right, то есть декоррелированный план будет содержать RIGHT JOIN, где подзапрос находится в правой части.
Возможные значения:
left - В процессе декорреляции будут создаваться LEFT JOIN, и входная таблица будет находиться в левой части.right - В процессе декорреляции будут создаваться RIGHT JOIN, и входная таблица будет находиться в правой части.
Используйте выражения фильтрации, чтобы выявлять эквивалентные выражения и подставлять их вместо создания CROSS JOIN.
Использовать буфер в памяти для входных данных коррелированных подзапросов, чтобы избежать их повторного вычисления.
count_distinct_implementation
uniq* используется для выполнения конструкции COUNT(DISTINCT …).
Возможные значения:
count_distinct_optimization
count_matches_stop_at_empty_match
countMatches даёт совпадение нулевой длины.
По умолчанию включает IF NOT EXISTS в операторе CREATE. Если указан либо этот параметр, либо IF NOT EXISTS, и таблица с указанным именем уже существует, исключение не будет выброшено.
create_index_ignore_unique
create_replicated_merge_tree_fault_injection_probability
create_table_empty_primary_key_by_default
cross_join_min_bytes_to_compress
cross_join_min_rows_to_compress
cross_to_inner_join_rewrite
data_type_default_nullable
- 1 — Типы данных в определениях столбцов по умолчанию имеют тип
Nullable.
- 0 — Типы данных в определениях столбцов по умолчанию не имеют типа
Nullable.
database_atomic_wait_for_drop_and_detach_synchronously
SYNC ко всем запросам DROP и DETACH.
Возможные значения:
- 0 — запросы будут выполняться с задержкой.
- 1 — запросы будут выполняться без задержки.
Определяет, следует ли сгенерировать исключение, если нет прав на получение метаданных таблицы в движке базы данных DataLakeCatalog.
database_replicated_allow_explicit_uuid
database_replicated_allow_heavy_create
database_replicated_allow_only_replicated_engine
1.
database_replicated_allow_replicated_engine_arguments
database_replicated_always_detach_permanently
database_replicated_enforce_synchronous_settings
database_replicated_initial_query_timeout_sec
- Положительное целое число.
- 0 — без ограничений.
database_shared_drop_table_delay_seconds
UNDROP TABLE.
Проверять переполнение при арифметических операциях и операциях сравнения с Decimal
deduplicate_blocks_in_dependent_materialized_views
INSERT INTO (для таблиц Replicated*).
Эта настройка переопределяет параметры insert_deduplicate и async_insert_deduplicate.
У этой настройки есть три возможных значения:
- disable — Дедупликация для запроса
INSERT INTO отключена.
- enable — Дедупликация для запроса
INSERT INTO включена.
- backward_compatible_choice — Дедупликация включается, если
insert_deduplicate или async_insert_deduplicate включены для соответствующего типа вставки.
deduplicate_insert_select
INSERT SELECT (для таблиц Replicated*).
Этот параметр переопределяет insert_deduplicate и deduplicate_insert для запросов INSERT SELECT.
У этого параметра есть четыре возможных значения:
- disable — Дедупликация отключена для запроса
INSERT SELECT.
- force_enable — Дедупликация включена для запроса
INSERT SELECT. Если результат SELECT нестабилен, генерируется исключение.
- enable_when_possible — Дедупликация включается, если
insert_deduplicate включен и результат SELECT стабилен, в противном случае отключается.
- enable_even_for_bad_queries - Дедупликация включается, если
insert_deduplicate включен. Если результат SELECT нестабилен, в журнал записывается предупреждение, но запрос выполняется с дедупликацией. Этот вариант предназначен для обратной совместимости. Рекомендуется использовать другие варианты, так как он может приводить к неожиданным результатам.
default_materialized_view_sql_security
DEFINER.
default_max_bytes_in_join
max_bytes_in_join не задан.
default_normal_view_sql_security
SQL SECURITY по умолчанию при создании обычного представления. Подробнее о безопасности SQL.
Значение по умолчанию — INVOKER.
Движок таблицы, используемый по умолчанию, если ENGINE не задан в операторе CREATE.
Возможные значения:
- строка, представляющая любое допустимое имя движка таблицы
Значение по умолчанию в Cloud: SharedMergeTree.
Пример
Запрос:
SET default_table_engine = 'Log';
SELECT name, value, changed FROM system.settings WHERE name = 'default_table_engine';
┌─name─────────────────┬─value─┬─changed─┐
│ default_table_engine │ Log │ 1 │
└──────────────────────┴───────┴─────────┘
Engine, будет использоваться движок таблицы Log:
Запрос:
CREATE TABLE my_table (
x UInt32,
y UInt32
);
SHOW CREATE TABLE my_table;
┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.my_table
(
`x` UInt32,
`y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘
default_temporary_table_engine
Engine, будет использовать движок таблицы Log:
Запрос:
SET default_temporary_table_engine = 'Log';
CREATE TEMPORARY TABLE my_table (
x UInt32,
y UInt32
);
SHOW CREATE TEMPORARY TABLE my_table;
┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TEMPORARY TABLE default.my_table
(
`x` UInt32,
`y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘
DEFINER, используемый по умолчанию при создании представления. Подробнее о безопасности SQL.
Значение по умолчанию — CURRENT_USER.
defer_partition_pruning_after_final
FINAL к таблицам, у которых
столбцы ключа партиции не входят в ключ сортировки. Это безопасное с точки зрения корректности поведение,
введённое в 26.3: FINAL может потребоваться выполнить дедупликацию строк с одинаковым
первичным ключом, но находящихся в разных партициях, а отсечение партиций в таком случае незаметно исключило бы эти строки из
входных данных для дедупликации.
Когда настройка отключена, отсечение партиций применяется даже с FINAL, восстанавливая поведение
до 26.3. Это может быть значительно быстрее для запросов с условиями WHERE по
столбцу партиции, но корректно только в тех случаях, когда строки с одним и тем же первичным ключом не могут находиться
в разных партициях — например, в таблицах логов событий, где столбец партиции задаётся во время вставки
и больше никогда не изменяется.
Эта настройка влияет только на партиционированные таблицы, у которых столбцы ключа партиции не входят
в ключ сортировки; для остальных таблиц отсечение партиций применяется всегда.
Возможные значения:
- 0 — Применять отсечение партиций до
FINAL (поведение до 26.3, быстрее, но в общем случае небезопасно).
- 1 — Откладывать отсечение партиций до завершения
FINAL (по умолчанию, безопасно с точки зрения корректности).
delta_lake_enable_engine_predicate
delta_lake_enable_expression_visitor_logging
delta_lake_insert_max_bytes_in_data_file
delta_lake_insert_max_rows_in_data_file
delta_lake_reload_schema_for_consistency
delta_lake_snapshot_end_version
delta_lake_snapshot_start_version
delta_lake_snapshot_version
delta_lake_throw_on_engine_predicate_error
describe_include_subcolumns
- 0 — Подстолбцы не включаются в запросы
DESCRIBE.
- 1 — Подстолбцы включаются в запросы
DESCRIBE.
Пример
См. пример для оператора DESCRIBE.
describe_include_virtual_columns
dictionary_use_async_executor
dictionary_validate_primary_key_type
id для простых структур неявно преобразуется в UInt64.
Задаёт поведение в случае, если объём данных превышает одно из ограничений.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
источник данных исчерпался.
distributed_aggregation_memory_efficient
distributed_background_insert_batch
distributed_directory_monitor_batch_inserts
Включает или отключает отправку вставленных данных батчами.
Когда отправка батчами включена, движок таблицы Distributed пытается отправлять несколько файлов со вставленными данными за одну операцию, а не по отдельности. Отправка батчами повышает производительность кластера за счет более эффективного использования ресурсов сервера и сети.
Возможные значения:
- 1 — Включено.
- 0 — Отключено.
distributed_background_insert_max_sleep_time_ms
distributed_directory_monitor_max_sleep_time_ms
Максимальный интервал отправки данных для движка таблицы Distributed. Ограничивает экспоненциальный рост интервала, заданного настройкой distributed_background_insert_sleep_time_ms.
Возможные значения:
- Положительное целое число миллисекунд.
distributed_background_insert_sleep_time_ms
distributed_directory_monitor_sleep_time_ms
Базовый интервал, через который движок таблицы Distributed отправляет данные. При возникновении ошибок фактический интервал увеличивается экспоненциально.
Возможные значения:
- Положительное целое число миллисекунд.
distributed_background_insert_split_batch_on_failure
distributed_directory_monitor_split_batch_on_failure
Включает или отключает разбиение батчей при сбоях.
Иногда отправка определенного батча на удаленный сегмент может завершиться ошибкой из-за сложного конвейера на последующих этапах (например, MATERIALIZED VIEW с GROUP BY) — из-за Memory limit exceeded или схожих ошибок. В таком случае повторные попытки не помогут (и это приведет к зависанию распределенных отправок для таблицы), тогда как отправка файлов из этого батча по одному может позволить успешно выполнить INSERT.
Поэтому при установке этого параметра в 1 батчинг для таких батчей будет отключаться (то есть для неудачных батчей временно отключается distributed_background_insert_batch).
Возможные значения:
- 1 — Включено.
- 0 — Отключено.
Этот параметр также влияет на поврежденные батчи (которые могут появиться из-за аварийного завершения работы сервера (машины) и отсутствия fsync_after_insert/fsync_directories для движка таблицы Distributed). Не следует полагаться на автоматическое разбиение батчей, так как это может негативно сказаться на производительности.
distributed_background_insert_timeout
insert_distributed_timeout
Тайм-аут для запроса вставки в Distributed. Эта настройка используется только при включенном insert_distributed_sync. Нулевое значение означает отсутствие тайм-аута.
distributed_cache_alignment
distributed_cache_bypass_connection_pool
distributed_cache_connect_backoff_max_ms
distributed_cache_connect_backoff_min_ms
distributed_cache_connect_max_tries
distributed_cache_connect_timeout_ms
distributed_cache_credentials_refresh_period_seconds
distributed_cache_data_packet_ack_window
distributed_cache_discard_connection_if_unread_data
distributed_cache_fetch_metrics_only_from_current_az
distributed_cache_file_cache_name
distributed_cache_log_mode
distributed_cache_max_unacked_inflight_packets
distributed_cache_min_bytes_for_seek
distributed_cache_pool_behaviour_on_limit
distributed_cache_prefer_bigger_buffer_size
distributed_cache_read_only_from_current_az
distributed_cache_read_request_max_tries
distributed_cache_receive_response_wait_milliseconds
distributed_cache_receive_timeout_milliseconds
20000.
distributed_cache_receive_timeout_ms
distributed_cache_send_timeout_ms
distributed_cache_tcp_keep_alive_timeout_ms
distributed_cache_throw_on_error
distributed_cache_use_clients_cache_for_read
distributed_cache_use_clients_cache_for_write
distributed_cache_wait_connection_from_pool_milliseconds
distributed_cache_write_request_max_tries
distributed_connections_pool_size
distributed_ddl_entry_format_version
6.
distributed_ddl_output_mode
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, но не ждёт неактивные реплики базы данных Replicatedthrow_only_active — аналогично throw, но не ждёт неактивные реплики базы данных Replicated
Значение по умолчанию в Cloud: none_only_active.
distributed_ddl_task_timeout
- Положительное целое число.
- 0 — асинхронный режим.
- Отрицательное целое число — бесконечный тайм-аут.
distributed_foreground_insert
insert_distributed_sync
Включает или отключает синхронную вставку данных в таблицу Distributed.
По умолчанию при вставке данных в таблицу Distributed сервер ClickHouse отправляет данные на узлы кластера в фоновом режиме. Если distributed_foreground_insert=1, данные обрабатываются синхронно, и операция INSERT завершается успешно только после того, как все данные будут сохранены на всех сегментах (как минимум на одной реплике для каждого сегмента, если internal_replication имеет значение true).
Возможные значения:
0 — Данные вставляются в фоновом режиме.1 — Данные вставляются в синхронном режиме.
Значение по умолчанию в Cloud: 1.
См. также
distributed_group_by_no_merge
0 — Отключено (окончательная обработка запроса выполняется на узле-инициаторе).1 - Не объединять состояния агрегации с разных серверов при распределённой обработке запросов (запрос полностью обрабатывается на сегменте, узел-инициатор только проксирует данные); можно использовать, если точно известно, что на разных сегментах находятся разные ключи.2 - То же, что и 1, но ORDER BY и LIMIT применяются на инициаторе (это невозможно, если запрос полностью обрабатывается на удалённом узле, как при distributed_group_by_no_merge=1) (можно использовать для запросов с ORDER BY и/или LIMIT).
Пример
SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 1
FORMAT PrettyCompactMonoBlock
┌─dummy─┐
│ 0 │
│ 0 │
└───────┘
SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 2
FORMAT PrettyCompactMonoBlock
┌─dummy─┐
│ 0 │
└───────┘
distributed_index_analysis
distributed_index_analysis_for_non_shared_merge_tree
distributed_index_analysis_only_on_coordinator
IN (SELECT ...)),
поскольку в противном случае каждая реплика-follower независимо запускала бы собственный распределенный анализ индексов,
но делает распределенный анализ индексов менее эффективным, если в подзапросах используются большие таблицы.
distributed_insert_skip_read_only_replicas
- 0 — INSERT выполняется как обычно; если запрос попадет на реплику только для чтения, произойдет ошибка
- 1 — Инициатор будет пропускать реплики только для чтения перед отправкой данных в сегменты.
distributed_plan_default_reader_bucket_count
distributed_plan_default_shuffle_join_bucket_count
distributed_plan_execute_locally
distributed_plan_force_exchange_kind
- ” - не задавать принудительно какой-либо тип операторов Exchange, а предоставить выбор оптимизатору,
- ‘Persisted’ - использовать временные файлы в объектном хранилище,
- ‘Streaming’ - передавать данные Exchange по сети в потоковом режиме.
distributed_plan_force_shuffle_aggregation
distributed_plan_max_rows_to_broadcast
distributed_plan_optimize_exchanges
distributed_plan_prefer_replicas_over_workers
- Применяется только к подзапросам IN и JOIN.
- Только если в секции FROM используется distributed таблица, содержащая более одного сегмента.
- Если подзапрос относится к distributed таблице, содержащей более одного сегмента.
- Не используется для табличной функции remote.
Возможные значения:
deny — Значение по умолчанию. Запрещает использовать эти типы подзапросов (возвращает Исключение “Double-distributed in/JOIN subqueries is denied”).local — Заменяет базу данных и таблицу в подзапросе на локальные для сервера пункта назначения (сегмента), оставляя обычный IN/JOIN.global — Заменяет запрос IN/JOIN на GLOBAL IN/GLOBAL JOIN.allow — Разрешает использование этих типов подзапросов.
distributed_push_down_limit
- Передачи лишних строк по сети;
- Обработки на инициаторе строк, выходящих за пределы лимита.
Начиная с версии 21.9, получить неточные результаты больше нельзя, поскольку distributed_push_down_limit изменяет выполнение запроса только при выполнении хотя бы одного из следующих условий:
- distributed_group_by_no_merge > 0.
- Запрос не содержит
GROUP BY/DISTINCT/LIMIT BY, но содержит ORDER BY/LIMIT.
- Запрос содержит
GROUP BY/DISTINCT/LIMIT BY вместе с ORDER BY/LIMIT, и:
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
См. также:
distributed_replica_error_cap
- Тип: unsigned int
- Значение по умолчанию: 1000
Число ошибок для каждой реплики ограничено этим значением, чтобы одна реплика не могла накопить слишком много ошибок.
См. также:
distributed_replica_error_half_life
- Тип: секунды
- Значение по умолчанию: 60 секунд
Управляет скоростью обнуления ошибок в distributed таблицах. Если реплика некоторое время недоступна, накапливает 5 ошибок, а distributed_replica_error_half_life установлена в 1 секунду, то через 3 секунды после последней ошибки реплика снова считается нормальной.
См. также:
distributed_replica_max_ignored_errors
- Тип: беззнаковое целое число
- Значение по умолчанию: 0
Количество ошибок, которые игнорируются при выборе реплик (в соответствии с алгоритмом load_balancing).
См. также:
do_not_merge_across_partitions_select_final
dynamic_disk_allow_from_env
from_env в конфигурации динамического диска (то есть в аргументах функции disk()).
По умолчанию отключена, чтобы пользователи не могли читать произвольные переменные окружения при определении хранилища таблицы.
dynamic_disk_allow_from_zk
from_zk в конфигурации динамических дисков (то есть в аргументах функции disk()).
По умолчанию отключена.
dynamic_disk_allow_include
include в конфигурации динамического диска (то есть в аргументах функции disk()).
По умолчанию отключено.
dynamic_throw_on_type_mismatch
true (по умолчанию) — сгенерировать исключение.false — вместо этого вернуть NULL для таких строк.
empty_result_for_aggregation_by_constant_keys_on_empty_set
empty_result_for_aggregation_by_empty_set
enable_adaptive_memory_spill_scheduler
enable_add_distinct_to_in_subqueries
DISTINCT в подзапросах IN. Это компромиссная настройка: её включение может значительно уменьшить размер временных таблиц, передаваемых при распределённых подзапросах IN, и существенно ускорить передачу данных между сегментами, так как отправляться будут только уникальные значения.
Однако включение этой настройки создаёт дополнительную нагрузку на слияние на каждом узле, поскольку требуется выполнять дедупликацию (DISTINCT). Используйте эту настройку, когда узким местом является передача данных по сети, а дополнительные затраты на слияние допустимы.
enable_automatic_decision_for_merging_across_partitions_for_final
enable_blob_storage_log_for_read_operations
enable_blob_storage_log.
enable_early_constant_folding
enable_extended_results_for_datetime_functions
Date32 с расширенным диапазоном (по сравнению с типом Date)
или типа DateTime64 с расширенным диапазоном (по сравнению с типом DateTime).
Возможные значения:
0 — Функции возвращают Date или DateTime для аргументов любых типов.1 — Функции возвращают Date32 или DateTime64 для аргументов типа Date32 или DateTime64, а в остальных случаях — Date или DateTime.
В таблице ниже показано, как эта настройка влияет на поведение различных функций даты и времени.
| Function | enable_extended_results_for_datetime_functions = 0 | enable_extended_results_for_datetime_functions = 1 |
|---|
toStartOfYear | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toStartOfISOYear | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toStartOfQuarter | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений типа Date/DateTime
Возвращает Date32/DateTime64 для входных значений типа Date32/DateTime64 |
toStartOfMonth | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toStartOfWeek | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toLastDayOfWeek | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toLastDayOfMonth | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toMonday | Возвращает Date или DateTime | Возвращает Date/DateTime для входных значений Date/DateTime
Возвращает Date32/DateTime64 для входных значений Date32/DateTime64 |
toStartOfDay | Возвращает DateTime
Примечание: для значений вне диапазона 1970–2149 результаты могут быть некорректными | Возвращает DateTime для входных типов Date/DateTime
Возвращает DateTime64 для входных типов Date32/DateTime64 |
toStartOfHour | Возвращает DateTime
Примечание: для значений вне диапазона 1970–2149 результаты будут некорректными | Возвращает DateTime для входных типов Date/DateTime
Возвращает DateTime64 для входных типов Date32/DateTime64 |
toStartOfFifteenMinutes | Возвращает DateTime
Примечание: неверные результаты для значений за пределами диапазона 1970–2149 | Возвращает DateTime для входных значений Date/DateTime
Возвращает DateTime64 для входных значений Date32/DateTime64 |
toStartOfTenMinutes | Возвращает DateTime
Примечание: для значений вне диапазона 1970–2149 возможны некорректные результаты | Возвращает DateTime для входных значений Date/DateTime
Возвращает DateTime64 для входных значений Date32/DateTime64 |
toStartOfFiveMinutes | Возвращает DateTime
Примечание: некорректные результаты для значений вне диапазона 1970–2149 | Возвращает DateTime для входных значений Date/DateTime
Возвращает DateTime64 для входных значений Date32/DateTime64 |
toStartOfMinute | Возвращает DateTime
Примечание: для значений вне диапазона 1970–2149 результаты будут неверными | Возвращает DateTime для аргументов Date/DateTime
Возвращает DateTime64 для аргументов Date32/DateTime64 |
timeSlot | Возвращает DateTime
Примечание: некорректные результаты для значений вне диапазона 1970–2149 | Возвращает DateTime для значений типа Date/DateTime
Возвращает DateTime64 для значений типа Date32/DateTime64 |
enable_filesystem_cache_log
enable_filesystem_cache_on_write_operations
write-through). Если установлено значение false, кэш со сквозной записью отключается для операций записи. Если установлено значение true, кэш со сквозной записью включается, если параметр cache_on_write_operations включен в разделе конфигурации cache disk в config сервера.
Подробнее см. в разделе “Использование локального кэша”.
Значение по умолчанию в Cloud: 1.
enable_filesystem_read_prefetches_log
allow_experimental_full_text_index
Если установлено значение true, разрешается использование текстового индекса.
enable_global_with_statement
pread для файлов HDFS. По умолчанию используется hdfsPread. Если параметр отключён, для чтения файлов HDFS будут использоваться hdfsRead и hdfsSeek.
Включает или отключает сжатие данных в ответе на HTTP-запрос.
Подробнее см. описание HTTP-интерфейса.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Выводит трассировку стека создателя задачи, если при выполнении задачи возникает исключение. По умолчанию отключён, чтобы избежать снижения производительности.
enable_join_fixed_hash_table_conversion
enable_join_runtime_filters
enable_join_transitive_predicates
A.x = B.x и B.x = C.x, добавляется синтетический предикат A.x = C.x,
чтобы оптимизатор порядка JOIN мог учитывать прямые планы (A JOIN C).
enable_lazy_columns_replication
enable_lightweight_delete
allow_experimental_lightweight_delete
Включает поддержку легковесных DELETE-мутаций для таблиц MergeTree.
enable_lightweight_update
allow_experimental_lightweight_update
Позволяет использовать легковесные обновления.
Включает материализованные общие табличные выражения; этот параметр имеет приоритет над enable_global_with_statement
enable_memory_bound_merging_of_aggregation_results
enable_multiple_prewhere_read_steps
enable_named_columns_in_function_tuple
enable_optimize_predicate_expression
SELECT.
Pushdown предикатов может значительно сократить сетевой трафик при распределенных запросах.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Использование
Рассмотрим следующие запросы:
SELECT count() FROM test_table WHERE date = '2018-10-10'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
ORDER BY ALL, см. ORDER BY.
Возможные значения:
- 0 — Отключить
ORDER BY ALL.
- 1 — Включить
ORDER BY ALL.
Пример
Запрос:
CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();
INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);
SELECT * FROM TAB ORDER BY ALL; -- возвращает ошибку из-за неоднозначности ALL
SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;
┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │ 10 │
│ 30 │ 10 │ 20 │
│ 10 │ 20 │ 30 │
└────┴────┴─────┘
enable_parallel_blocks_marshalling
enable_parsing_to_custom_serialization
enable_positional_arguments
- 0 — Позиционные аргументы не поддерживаются.
- 1 — Позиционные аргументы поддерживаются: вместо имён столбцов можно использовать их номера.
Пример
Запрос:
CREATE TABLE positional_arguments(one Int, two Int, three Int) ENGINE=Memory();
INSERT INTO positional_arguments VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);
SELECT * FROM positional_arguments ORDER BY 2,3;
┌─one─┬─two─┬─three─┐
│ 30 │ 10 │ 20 │
│ 20 │ 20 │ 10 │
│ 10 │ 20 │ 30 │
└─────┴─────┴───────┘
enable_positional_arguments_for_projections
Это настройка экспертного уровня; не изменяйте её, если вы только начинаете работать с ClickHouse.
- 0 — Позиционные аргументы не поддерживаются.
- 1 — Позиционные аргументы поддерживаются: вместо имён столбцов можно использовать номера столбцов.
enable_producing_buckets_out_of_order_in_aggregation
distributed_aggregation_memory_efficient) формировать бакеты не по порядку.
Это может повысить производительность, если размеры бакетов агрегации распределены неравномерно: реплика сможет отправлять инициатору бакеты с более высокими идентификаторами, пока всё ещё обрабатывает некоторые ресурсоёмкие бакеты с более низкими идентификаторами.
Недостатком может быть потенциально более высокое использование памяти.
enable_reads_from_query_cache
SELECT считываются из кэша запросов.
Возможные значения:
- 0 - Отключено
- 1 - Включено
enable_s3_requests_logging
enable_scalar_subquery_optimization
enable_scopes_for_with_statement
enable_shared_storage_snapshot_in_query
SELECT
count()
FROM events
WHERE (_part, _part_offset) IN (
SELECT _part, _part_offset
FROM events
WHERE user_id = 42
)
Включение этого параметра отключает оптимизацию, которая удаляет из снимков ненужные части данных после завершения этапа планирования.
В результате долго выполняющиеся запросы могут удерживать устаревшие части в течение всего времени выполнения, что задерживает их очистку и увеличивает нагрузку на хранилище.В настоящее время этот параметр применяется только к таблицам семейства MergeTree.
- 0 - Отключено
- 1 - Включено
enable_sharing_sets_for_mutations
enable_software_prefetch_in_aggregation
enable_software_prefetch_in_join
allow_experimental_time_time64_type
Позволяет создавать типы данных Time и Time64.
enable_unaligned_array_join
enable_writes_to_query_cache
SELECT сохраняются в кэше запросов.
Возможные значения:
- 0 - Отключено
- 1 - Включено
Если настройка включена, разрешены только идентификаторы, содержащие буквы, цифры и символы подчеркивания.
engine_file_allow_create_multiple_files
JSON, ORC, Parquet и т. д.). Если параметр включен, при каждой вставке будет создаваться новый файл с именем по следующему шаблону:
data.Parquet -> data.1.Parquet -> data.2.Parquet и т. д.
Возможные значения:
- 0 — запрос
INSERT дописывает новые данные в конец файла.
- 1 — запрос
INSERT создает новый файл.
engine_file_empty_if_not_exists
- 0 —
SELECT генерирует исключение.
- 1 —
SELECT возвращает пустой результат.
engine_file_skip_empty_files
- 0 —
SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
- 1 —
SELECT возвращает пустой результат для пустого файла.
engine_file_truncate_on_insert
- 0 — запрос
INSERT дописывает новые данные в конец файла.
- 1 — запрос
INSERT заменяет существующее содержимое файла новыми данными.
engine_url_skip_empty_files
- 0 —
SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
- 1 —
SELECT возвращает пустой результат для пустого файла.
Если включено, ClickHouse будет возвращать точное значение статистики rows_before_limit_at_least, но для этого потребуется полностью прочитать данные до лимита
Устанавливает режим по умолчанию для запроса EXCEPT. Возможные значения: пустая строка, ‘ALL’, ‘DISTINCT’. Если указана пустая строка, запрос без режима сгенерирует исключение.
exclude_materialize_skip_indexes_on_insert
CREATE TABLE tab
(
a UInt64,
b UInt64,
INDEX idx_a a TYPE minmax,
INDEX idx_b b TYPE set(3)
)
ENGINE = MergeTree ORDER BY tuple();
SET exclude_materialize_skip_indexes_on_insert='idx_a'; -- idx_a не будет обновляться при вставке
--SET exclude_materialize_skip_indexes_on_insert='idx_a, idx_b'; -- ни один из индексов не будет обновляться при вставке
INSERT INTO tab SELECT number, number / 50 FROM numbers(100); -- обновляется только idx_b
-- поскольку это настройка сеанса, её можно задать на уровне отдельного запроса
INSERT INTO tab SELECT number, number / 50 FROM numbers(100, 100) SETTINGS exclude_materialize_skip_indexes_on_insert='idx_b';
ALTER TABLE tab MATERIALIZE INDEX idx_a; -- этот запрос позволяет явно материализовать индекс
SET exclude_materialize_skip_indexes_on_insert = DEFAULT; -- сброс настройки к значению по умолчанию
execute_exists_as_scalar_subquery
0.
external_storage_connect_timeout_sec
external_storage_max_read_bytes
external_storage_max_read_rows
external_storage_rw_timeout_sec
external_table_functions_use_nulls
- 0 — Табличная функция явно использует столбцы с типом Nullable.
- 1 — Табличная функция неявно использует столбцы с типом Nullable.
Использование
Если для настройки установлено значение 0, табличная функция не создаёт столбцы с типом Nullable и вставляет значения по умолчанию вместо NULL. Это также относится к значениям NULL внутри массивов.
external_table_strict_query
extract_kvp_max_pairs_per_row
Максимальное число пар, которое может возвращать функция extractKeyValuePairs. Используется для защиты от чрезмерного потребления памяти.
Определяет, следует ли учитывать экстремальные значения (минимумы и максимумы в столбцах результата запроса). Принимает значения 0 или 1. По умолчанию — 0 (отключено).
Дополнительные сведения см. в разделе «Экстремальные значения».
fallback_to_stale_replicas_for_distributed_queries
SELECT из distributed таблицы, указывающей на реплицируемые таблицы.
По умолчанию — 1 (включено).
filesystem_cache_allow_background_download
filesystem_cache_boundary_alignment
filesystem_cache_enable_background_download_during_fetch
filesystem_cache_max_download_size
filesystem_cache_prefer_bigger_buffer_size
filesystem_cache_reserve_space_wait_lock_timeout_milliseconds
filesystem_cache_segments_batch_size
filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit
skip_download_if_exceeds_query_cache
Пропускать загрузку из удалённой файловой системы, если размер загрузки превышает размер кэша запросов
filesystem_prefetch_max_memory_usage
filesystem_prefetch_step_bytes
auto — приблизительно оптимальный шаг предварительного чтения будет определён автоматически, но он может оказаться не на 100% оптимальным. Фактическое значение может отличаться из-за настройки filesystem_prefetch_min_bytes_for_single_read_task
filesystem_prefetch_step_marks
auto — приблизительно оптимальный шаг предварительного чтения будет определён автоматически, но он может оказаться не на 100% оптимальным. Фактическое значение может отличаться из-за настройки filesystem_prefetch_min_bytes_for_single_read_task
filesystem_prefetches_limit
filesystem_prefetches_max_memory_usage
Автоматически применяет модификатор FINAL ко всем таблицам в запросе, к которым применим FINAL, включая таблицы, участвующие в JOIN, таблицы в подзапросах и
distributed таблицы.
Возможные значения:
- 0 - отключено
- 1 - включено
Пример:
CREATE TABLE test
(
key Int64,
some String
)
ENGINE = ReplacingMergeTree
ORDER BY key;
INSERT INTO test FORMAT Values (1, 'first');
INSERT INTO test FORMAT Values (1, 'second');
SELECT * FROM test;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
┌─key─┬─some──┐
│ 1 │ first │
└─────┴───────┘
SELECT * FROM test SETTINGS final = 1;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
SET final = 1;
SELECT * FROM test;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
finalize_projection_parts_synchronously
- 1 — вложенный столбец разворачивается в отдельные массивы.
- 0 — вложенный столбец остаётся одним массивом кортежей.
Использование
Если для настройки установлено значение 0, можно использовать произвольный уровень вложенности.
Примеры
Запрос:
SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n.a` Array(UInt32),
`n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
SET flatten_nested = 0;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
force_aggregate_partitions_independently
force_aggregation_in_order
force_data_skipping_indices
CREATE TABLE data
(
key Int,
d1 Int,
d1_null Nullable(Int),
INDEX d1_idx d1 TYPE minmax GRANULARITY 1,
INDEX d1_null_idx assumeNotNull(d1_null) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;
SELECT * FROM data_01515;
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices=''; -- запрос вернёт ошибку CANNOT_PARSE_TEXT.
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices='d1_idx'; -- запрос вернёт ошибку INDEX_NOT_USED.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='d1_idx'; -- Ок.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`'; -- Ок (пример использования полнофункционального парсера).
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- запрос вернёт ошибку INDEX_NOT_USED, так как d1_null_idx не используется.
SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ок.
force_grouping_standard_compatibility
force_index_by_date=1, ClickHouse проверяет, есть ли в запросе условие по ключу даты, которое можно использовать для ограничения диапазонов данных. Если подходящего условия нет, генерируется исключение. Однако ClickHouse не проверяет, уменьшает ли это условие объём читаемых данных. Например, условие Date != ' 2000-01-01 ' допустимо, даже если ему соответствуют все данные в таблице (то есть для выполнения запроса потребуется полное сканирование). Дополнительные сведения о диапазонах данных в таблицах MergeTree см. в разделе MergeTree.
force_optimize_projection
SELECT, если включена оптимизация проекций (см. настройку optimize_use_projections).
Возможные значения:
- 0 — Использование оптимизации проекций не является обязательным.
- 1 — Использование оптимизации проекций является обязательным.
force_optimize_projection_name
- строка: имя проекции, используемой в запросе
force_optimize_skip_unused_shards
- 0 — Отключено. ClickHouse не генерирует исключение.
- 1 — Включено. Выполнение запроса отключается, только если у таблицы есть ключ сегментирования.
- 2 — Включено. Выполнение запроса отключается независимо от того, определен ли для таблицы ключ сегментирования.
force_optimize_skip_unused_shards_nesting
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 до второго уровня.
Отключает выполнение запроса, если использование индекса по первичному ключу невозможно.
Работает с таблицами семейства MergeTree.
Если force_primary_key=1, ClickHouse проверяет, есть ли в запросе условие по первичному ключу, которое можно использовать для ограничения диапазонов данных. Если подходящего условия нет, генерируется исключение. Однако не проверяется, уменьшает ли это условие объём данных, которые нужно прочитать. Дополнительные сведения о диапазонах данных в таблицах MergeTree см. в разделе MergeTree.
force_remove_data_recursively_on_drop
.sql. По умолчанию включено.
Отключать эту настройку имеет смысл, если на сервере есть миллионы маленьких таблиц, которые постоянно создаются и удаляются.
function_date_trunc_return_type_behavior
dateTrunc.
Возможные значения:
- 0 - Если второй аргумент —
DateTime64/Date32, возвращаемый тип будет DateTime64/Date32 независимо от единицы времени в первом аргументе.
- 1 - Для
Date32 результатом всегда будет Date. Для DateTime64 результатом будет DateTime для единиц времени second и больше.
Выберите реализацию функции для конкретной целевой платформы или варианта (экспериментально). Если значение не задано, будут включены все варианты.
function_json_value_return_type_allow_complex
SELECT JSON_VALUE('{"hello":{"world":"!"}}', '$.hello') settings function_json_value_return_type_allow_complex=true
┌─JSON_VALUE('{"hello":{"world":"!"}}', '$.hello')─┐
│ {"world":"!"} │
└──────────────────────────────────────────────────┘
1 row in set. Elapsed: 0.001 sec.
- true — Разрешить.
- false — Запретить.
function_json_value_return_type_allow_nullable
NULL, если для функции JSON_VALUE значение отсутствует.
SELECT JSON_VALUE('{"hello":"world"}', '$.b') settings function_json_value_return_type_allow_nullable=true;
┌─JSON_VALUE('{"hello":"world"}', '$.b')─┐
│ ᴺᵁᴸᴸ │
└────────────────────────────────────────┘
1 row in set. Elapsed: 0.001 sec.
- true — Разрешено.
- false — Запрещено.
function_locate_has_mysql_compatible_argument_order
- 0 — Функция
locate принимает аргументы (haystack, needle[, start_pos]).
- 1 — Функция
locate принимает аргументы (needle, haystack, [, start_pos]) (поведение, совместимое с MySQL)
function_range_max_elements_in_block
- Положительное целое число.
См. также
function_sleep_max_microseconds_per_block
sleep разрешено приостанавливать выполнение для каждого блока. Если пользователь вызовет её с бо́льшим значением, будет сгенерировано исключение. Это защитный порог.
function_visible_width_behavior
visibleWidth. 0 — учитывать только количество кодовых точек; 1 — корректно учитывать символы нулевой ширины и комбинируемые символы, считать полноширинные символы за два, оценивать ширину табуляции, учитывать символы удаления.
functions_h3_default_if_invalid
geo_distance_returns_float64_on_float64_arguments
geoDistance, greatCircleDistance и greatCircleAngle имеют тип Float64, возвращаемое значение также будет Float64, а для внутренних вычислений будет использоваться двойная точность. В предыдущих версиях ClickHouse эти функции всегда возвращали Float32.
Функция geoToH3 принимает (lon, lat), если установлено значение lon_lat, и (lat, lon), если установлено значение lat_lon.
glob_expansion_max_elements
grace_hash_join_initial_buckets
grace_hash_join_max_buckets
throw: сгенерировать исключениеbreak: остановить выполнение запроса и вернуть частичный результатany: продолжить агрегацию по ключам, которые попали в набор, но не добавлять в набор новые ключи.
Использование значения any позволяет выполнять приближённый GROUP BY. Качество
этого приближения зависит от статистической природы данных.
group_by_two_level_threshold
group_by_two_level_threshold_bytes
ROLLUP, CUBE или GROUPING SETS некоторые ключи агрегации могут не участвовать в формировании отдельных строк результата.
В соответствующих строках столбцы для этих ключей заполняются либо значением по умолчанию, либо NULL — в зависимости от этой настройки.
Возможные значения:
- 0 — Для подстановки отсутствующих значений используется значение по умолчанию для типа ключа агрегации.
- 1 — ClickHouse выполняет
GROUP BY так, как это определено стандартом SQL. Типы ключей агрегации преобразуются в Nullable. В строках, где соответствующие ключи агрегации не используются, их столбцы заполняются значением NULL.
См. также:
h3togeo_lon_lat_result_order
h3ToGeo возвращает (lon, lat), если значение равно true, в противном случае — (lat, lon).
Тайм-аут в миллисекундах на получение пакета Hello от реплик при рукопожатии.
hdfs_create_new_file_on_insert
data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz и т. д.
Возможные значения:
- 0 — запрос
INSERT дописывает новые данные в конец файла.
- 1 — запрос
INSERT создает новый файл.
hdfs_ignore_file_doesnt_exist
- 1 —
SELECT возвращает пустой результат.
- 0 —
SELECT генерирует исключение.
Фактическое количество реплик можно указать при создании файла в HDFS.
Включает или отключает пропуск пустых файлов в таблицах с движком HDFS.
Возможные значения:
- 0 —
SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
- 1 —
SELECT возвращает пустой результат для пустого файла.
hdfs_throw_on_zero_files_match
- 1 —
SELECT генерирует исключение.
- 0 —
SELECT возвращает пустой результат.
Включает или отключает усечение файла перед вставкой в таблицах движка HDFS. Если параметр отключен, при попытке вставки в уже существующий файл в HDFS будет сгенерировано исключение.
Возможные значения:
- 0 — запрос
INSERT добавляет новые данные в конец файла.
- 1 — запрос
INSERT заменяет существующее содержимое файла новыми данными.
hedged_connection_timeout_ms
highlight_max_matches_per_row
- Положительное целое число.
hnsw_candidate_list_size_for_search
- Любое положительное целое число.
- 0 — отключено (бесконечный тайм-аут).
Не отправляйте HTTP-заголовки X-ClickHouse-Progress чаще, чем через указанный интервал.
Максимальное время в секундах, отведенное на чтение всех заголовков HTTP-запроса. Это общий предельный срок для всего этапа разбора заголовков, а не тайм-аут отдельной операции чтения. Защищает от атак типа slowloris, при которых клиент медленно передает данные заголовков, чтобы удерживать соединения открытыми.
Настройка http_make_head_request позволяет выполнять запрос HEAD при чтении данных по HTTP, чтобы получить информацию о файле, например его размер. Поскольку она включена по умолчанию, в случаях, когда сервер не поддерживает запросы HEAD, может быть целесообразно отключить эту настройку.
Максимальная длина имени поля в HTTP-заголовке
http_max_field_value_size
http_max_request_param_data_size
- Положительное целое число.
http_native_compression_disable_checksumming_on_decompress
gzip или deflate).
Подробнее см. описание HTTP-интерфейса.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Тайм-аут получения данных по HTTP (в секундах).
Возможные значения:
- Любое положительное целое число.
- 0 — отключено (бесконечный тайм-аут).
http_response_buffer_size
SET http_response_headers = '{"Content-Type": "image/png"}'
http_retry_initial_backoff_ms
http_retry_max_backoff_ms
- Любое положительное целое число.
- 0 — отключено (бесконечный тайм-аут).
Применимо только к профилю по умолчанию. Чтобы изменения вступили в силу, требуется перезагрузка сервера.
http_skip_not_found_url_for_globs
http_zlib_compression_level
iceberg_compaction_data_cleanup
iceberg_compaction_delay_bias
iceberg_data_file_size_lower_threshold_compaction
iceberg_data_file_size_upper_threshold_compaction
iceberg_delete_data_on_drop
iceberg_expire_default_max_ref_age_ms
history.expire.max-ref-age-ms таблицы Iceberg, которое используется функцией expire_snapshots, если это свойство отсутствует.
iceberg_expire_default_max_snapshot_age_ms
history.expire.max-snapshot-age-ms, которое expire_snapshots использует, если это свойство отсутствует.
iceberg_expire_default_min_snapshots_to_keep
history.expire.min-snapshots-to-keep, которое использует expire_snapshots, если это свойство отсутствует.
iceberg_insert_max_bytes_in_data_file
iceberg_insert_max_partitions
iceberg_insert_max_rows_in_data_file
iceberg_max_number_datafiles_to_compact
.metadata.json.
Управляет уровнем журналирования метаданных для Iceberg-таблиц в таблицу system.iceberg_metadata_log.
Обычно эту настройку изменяют в целях отладки.
Возможные значения:
- none - Без журнала метаданных.
- metadata - Корневой файл metadata.json.
- manifest_list_metadata - Всё вышеперечисленное + метаданные из avro manifest list, соответствующего снимку.
- manifest_list_entry - Всё вышеперечисленное + записи avro manifest list.
- manifest_file_metadata - Всё вышеперечисленное + метаданные из просмотренных avro manifest files.
- manifest_file_entry - Всё вышеперечисленное + записи просмотренных avro manifest files.
Если значение не равно нулю, получение метаданных Iceberg из удалённого каталога пропускается, если существует кэшированный снимок метаданных новее заданного окна устаревания. Ноль означает, что последняя версия метаданных всегда запрашивается из удалённого каталога. Ненулевое значение этой настройки означает компромисс: допустимое устаревание в обмен на меньшую задержку операций чтения.
iceberg_orphan_files_older_than_seconds
remove_orphan_files() опущен аргумент older_than. Значение по умолчанию — 259200 (3 дня).
Выполняет запрос к таблице Iceberg с использованием указанного идентификатора снимка.
Выполняет запрос к таблице Iceberg, используя снимок, который был актуален на указанную временную метку.
Тайм-аут закрытия бездействующих TCP-соединений по истечении указанного количества секунд.
Возможные значения:
- Положительное целое число (0 — закрыть немедленно, через 0 секунд).
ignore_cold_parts_seconds
ignore_data_skipping_indices
CREATE TABLE data
(
key Int,
x Int,
y Int,
INDEX x_idx x TYPE minmax GRANULARITY 1,
INDEX y_idx y TYPE minmax GRANULARITY 1,
INDEX xy_idx (x,y) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;
INSERT INTO data VALUES (1, 2, 3);
SELECT * FROM data;
SELECT * FROM data SETTINGS ignore_data_skipping_indices=''; -- запрос вернёт ошибку CANNOT_PARSE_TEXT.
SELECT * FROM data SETTINGS ignore_data_skipping_indices='x_idx'; -- Ok.
SELECT * FROM data SETTINGS ignore_data_skipping_indices='na_idx'; -- Ok.
SELECT * FROM data WHERE x = 1 AND y = 1 SETTINGS ignore_data_skipping_indices='xy_idx',force_data_skipping_indices='xy_idx' ; -- запрос вернёт ошибку INDEX_NOT_USED, так как xy_idx явно игнорируется.
SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2;
Expression ((Projection + Before ORDER BY))
Filter (WHERE)
ReadFromMergeTree (default.data)
Indexes:
PrimaryKey
Condition: true
Parts: 1/1
Granules: 1/1
Skip
Name: x_idx
Description: minmax GRANULARITY 1
Parts: 0/1
Granules: 0/1
Skip
Name: y_idx
Description: minmax GRANULARITY 1
Parts: 0/0
Granules: 0/0
Skip
Name: xy_idx
Description: minmax GRANULARITY 1
Parts: 0/0
Granules: 0/0
xy_idx:
EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';
Expression ((Projection + Before ORDER BY))
Filter (WHERE)
ReadFromMergeTree (default.data)
Indexes:
PrimaryKey
Condition: true
Parts: 1/1
Granules: 1/1
Skip
Name: x_idx
Description: minmax GRANULARITY 1
Parts: 0/1
Granules: 0/1
Skip
Name: y_idx
Description: minmax GRANULARITY 1
Parts: 0/0
Granules: 0/0
ignore_drop_queries_probability
FORMAT Null будет игнорироваться в запросах EXPLAIN, и вместо него будет использоваться формат вывода по умолчанию.
Если отключено, запросы EXPLAIN с FORMAT Null не будут выводить результат (поведение для обратной совместимости).
ignore_materialized_views_with_dropped_target_table
ignore_on_cluster_for_replicated_access_entities_queries
ignore_on_cluster_for_replicated_database
ignore_on_cluster_for_replicated_named_collections_queries
ignore_on_cluster_for_replicated_udf_queries
1 + 2 становится допустимым запросом.
В clickhouse-local эта возможность включена по умолчанию, но её можно явно отключить.
implicit_table_at_top_level
inject_random_order_for_select_without_order_by
insert_allow_materialized_columns
INSERT (для таблиц Replicated*).
Возможные значения:
- 0 — отключено.
- 1 — включено.
По умолчанию блоки, вставляемые в реплицируемые таблицы оператором INSERT, подвергаются дедупликации (см. репликация данных).
Для реплицируемых таблиц по умолчанию дедуплицируются только 100 последних блоков для каждой партиции (см. replicated_deduplication_window, replicated_deduplication_window_seconds).
Для нереплицируемых таблиц см. non_replicated_deduplication_window.
insert_deduplication_token
insert_deduplication_token используется для дедупликации только если он не пуст.
Для реплицируемых таблиц по умолчанию дедуплицируются только 100 последних вставок для каждой партиции (см. replicated_deduplication_window, replicated_deduplication_window_seconds).
Для нереплицируемых таблиц см. non_replicated_deduplication_window.
insert_deduplication_token работает на уровне партиции (как и контрольная сумма insert_deduplication). Несколько партиций могут иметь одинаковый insert_deduplication_token.
CREATE TABLE test_table
( A Int64 )
ENGINE = MergeTree
ORDER BY A
SETTINGS non_replicated_deduplication_window = 100;
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (1);
-- следующая вставка не будет дедуплицирована, так как insert_deduplication_token отличается
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test1' VALUES (1);
-- следующая вставка будет дедуплицирована, так как insert_deduplication_token
-- совпадает с одним из предыдущих
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (2);
SELECT * FROM test_table
┌─A─┐
│ 1 │
└───┘
┌─A─┐
│ 1 │
└───┘
insert_keeper_fault_injection_probability
insert_keeper_fault_injection_seed
insert_keeper_max_retries
- Положительное целое число.
- 0 — повторные попытки отключены
Значение по умолчанию в Cloud: 20.
Повторные попытки запросов к Keeper выполняются после некоторой задержки. Эта задержка регулируется следующими параметрами: insert_keeper_retry_initial_backoff_ms, insert_keeper_retry_max_backoff_ms.
Первая повторная попытка выполняется после задержки insert_keeper_retry_initial_backoff_ms. Последующие задержки вычисляются следующим образом:
timeout = min(insert_keeper_retry_max_backoff_ms, latest_timeout * 2)
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
- Положительное целое число.
- 0 — без задержки
insert_keeper_retry_max_backoff_ms
- Положительное целое число.
- 0 — максимальный тайм-аут не ограничен
Включает или отключает вставку значений по умолчанию вместо NULL в столбцы с типом данных, не являющимся Nullable.
Если тип столбца не Nullable и эта настройка отключена, вставка NULL вызывает исключение. Если тип столбца Nullable, значения NULL вставляются как есть независимо от этой настройки.
Эта настройка применима к запросам INSERT … SELECT. Обратите внимание, что подзапросы SELECT могут быть объединены оператором UNION ALL.
Возможные значения:
- 0 — Вставка
NULL в столбец, не являющийся Nullable, вызывает исключение.
- 1 — Вместо
NULL вставляется значение столбца по умолчанию.
Включает запись с кворумом.
- Если
insert_quorum < 2, запись с кворумом отключена.
- Если
insert_quorum >= 2, запись с кворумом включена.
- Если
insert_quorum = 'auto', в качестве размера кворума используется большинство (number_of_replicas / 2 + 1).
Запись с кворумом
INSERT считается успешным, только если ClickHouse удается корректно записать данные на insert_quorum реплик в течение insert_quorum_timeout. Если по какой-либо причине число реплик с успешной записью не достигает insert_quorum, запись считается неуспешной, и ClickHouse удалит вставленный блок со всех реплик, на которые данные уже были записаны.
Когда insert_quorum_parallel отключен, все реплики в кворуме согласованы, то есть содержат данные из всех предыдущих запросов INSERT (последовательность INSERT линеаризована). При чтении данных, записанных с использованием insert_quorum, если insert_quorum_parallel отключен, можно включить последовательную согласованность для запросов SELECT с помощью select_sequential_consistency.
ClickHouse генерирует исключение:
- Если число доступных реплик на момент выполнения запроса меньше
insert_quorum.
- Когда
insert_quorum_parallel отключен и предпринимается попытка записать данные, хотя предыдущий блок еще не был вставлен на insert_quorum реплик. Такая ситуация может возникнуть, если пользователь пытается выполнить еще один запрос INSERT в ту же таблицу до завершения предыдущего запроса с insert_quorum.
См. также:
Включает или отключает параллельное выполнение запросов INSERT с quorum. Если параметр включен, дополнительные запросы INSERT можно отправлять, пока предыдущие еще не завершились. Если параметр отключен, дополнительные записи в ту же таблицу будут отклонены.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
См. также:
Тайм-аут записи в кворум в миллисекундах. Если тайм-аут истёк и запись ещё не была выполнена, ClickHouse сгенерирует исключение, и клиент должен повторить запрос, чтобы записать тот же блок в ту же или любую другую реплику.
См. также:
Если значение не равно 0, задаёт сегмент таблицы Distributed, в который данные будут вставляться синхронно.
Если значение insert_shard_id некорректно, сервер сгенерирует исключение.
Чтобы узнать количество сегментов в requested_cluster, проверьте конфигурацию сервера или используйте этот запрос:
SELECT uniq(shard_num) FROM system.clusters WHERE cluster = 'requested_cluster';
- 0 — отключено.
- Любое число от
1 до shards_num для соответствующей таблицы Distributed.
Пример
Запрос:
CREATE TABLE x AS system.numbers ENGINE = MergeTree ORDER BY number;
CREATE TABLE x_dist AS x ENGINE = Distributed('test_cluster_two_shards_localhost', currentDatabase(), x);
INSERT INTO x_dist SELECT * FROM numbers(5) SETTINGS insert_shard_id = 1;
SELECT * FROM x_dist ORDER BY number ASC;
┌─number─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
│ 2 │
│ 3 │
│ 3 │
│ 4 │
│ 4 │
└────────┘
jemalloc_collect_profile_samples_in_trace_log
jemalloc_profile_text_collapsed_use_count
collapsed для профиля кучи jemalloc агрегация выполняется по числу выделений, а не по байтам. Если false (по умолчанию), каждый стек взвешивается по объёму используемых байтов; если true — по числу используемых выделений.
jemalloc_profile_text_output_format
jemalloc_profile_text_symbolize_with_inline
grace_hash_join_initial_buckets). Это делается так, чтобы каждый бакет можно было обрабатывать независимо. Строки из первого бакета добавляются в хеш-таблицу в оперативной памяти, а остальные сохраняются на диск. Если хеш-таблица превышает лимит памяти (например, заданный в max_bytes_in_join), количество бакетов увеличивается, и для каждой строки заново определяется назначенный бакет. Все строки, которые не относятся к текущему бакету, сбрасываются на диск и перераспределяются.
Поддерживает INNER/LEFT/RIGHT/FULL ALL/ANY JOIN.
Используется алгоритм hash join. Это наиболее универсальная реализация, которая поддерживает все комбинации kind и strictness, а также несколько ключей JOIN, объединённых с помощью OR в секции JOIN ON.
При использовании алгоритма hash правая часть JOIN загружается в оперативную память.
Вариант hash join, который разбивает данные на бакеты и параллельно строит несколько хеш-таблиц вместо одной, чтобы ускорить этот процесс.
При использовании алгоритма parallel_hash правая часть JOIN загружается в оперативную память.
Вариант алгоритма sort-merge, в котором полностью сортируется только правая таблица.
RIGHT JOIN и FULL JOIN поддерживаются только со strictness ALL (SEMI, ANTI, ANY и ASOF не поддерживаются).
При использовании алгоритма partial_merge ClickHouse сортирует данные и выгружает их на диск. Алгоритм partial_merge в ClickHouse немного отличается от классической реализации. Сначала ClickHouse сортирует правую таблицу по ключам JOIN блоками и создаёт min-max индекс для отсортированных блоков. Затем он сортирует части левой таблицы по join key и выполняет JOIN с правой таблицей. Min-max индекс также используется для пропуска ненужных блоков правой таблицы.
Алгоритм direct (также известный как nested loop) выполняет lookup в правой таблице, используя строки из левой таблицы в качестве ключей.
Он поддерживается специальными хранилищами, такими как Dictionary, EmbeddedRocksDB и таблицы MergeTree.
Для таблиц MergeTree алгоритм передаёт фильтры по ключу JOIN напрямую на уровень хранения. Это может быть эффективнее, если по ключу можно выполнять lookup с использованием индекса primary key таблицы; в противном случае для каждого блока левой таблицы выполняется полное сканирование правой таблицы.
Поддерживает INNER и LEFT JOIN, а также только одно-столбцовые ключи join по равенству без дополнительных условий.
Если установлено значение auto, сначала используется hash join, а затем алгоритм на лету переключается на другой, если превышается лимит памяти.
Алгоритм sort-merge с полной сортировкой соединяемых таблиц перед выполнением JOIN.
ClickHouse всегда пытается использовать partial_merge join, если это возможно; в противном случае используется hash. Устарело, то же самое, что partial_merge,hash.
Устаревшее значение, больше не используйте его.
То же самое, что direct,hash, то есть сначала выполняется попытка использовать direct join, затем hash join (в таком порядке).
Изменяет поведение операций JOIN со строгостью ANY.
Этот параметр применяется только к операциям JOIN с таблицами, использующими движок Join.
- 0 — Если в правой таблице есть несколько совпадающих строк, JOIN выполняется только с первой найденной.
- 1 — Если в правой таблице есть несколько совпадающих строк, JOIN выполняется только с последней найденной.
См. также:
Устанавливает строгость по умолчанию для секций JOIN.
Возможные значения:
ALL — Если в правой таблице есть несколько совпадающих строк, ClickHouse создаёт декартово произведение из совпадающих строк. Это стандартное поведение JOIN в SQL.ANY — Если в правой таблице есть несколько совпадающих строк, присоединяется только первая найденная. Если в правой таблице есть только одна совпадающая строка, результаты ANY и ALL совпадают.ASOF — Для соединения последовательностей при неточном совпадении.Пустая строка — Если в запросе не указаны ALL или ANY, ClickHouse генерирует исключение.
join_on_disk_max_files_to_merge
- Любое положительное целое число, начиная с 2.
join_output_by_rowlist_perkey_rows_threshold
THROW — ClickHouse генерирует исключение и прерывает выполнение.BREAK — ClickHouse прерывает выполнение и не генерирует исключение.
Значение по умолчанию: THROW.
См. также
join_runtime_bloom_filter_bytes
join_runtime_bloom_filter_hash_functions
join_runtime_bloom_filter_max_ratio_of_set_bits
join_runtime_filter_blocks_to_skip_before_reenabling
join_runtime_filter_exact_values_limit
join_runtime_filter_pass_ratio_threshold_for_disabling
join_runtime_filter_blocks_to_skip_before_reenabling блоков, чтобы уменьшить накладные расходы.
join_to_sort_maximum_table_rows
join_to_sort_minimum_perkey_rows
- 0 — Пустые ячейки заполняются значением по умолчанию для типа соответствующего поля.
- 1 —
JOIN ведёт себя так же, как в стандартном SQL. Тип соответствующего поля преобразуется в Nullable, а пустые ячейки заполняются NULL.
joined_block_split_single_row
max_joined_block_size_rows != 0.
Параметр max_joined_block_size_bytes в сочетании с этой настройкой помогает избежать чрезмерного использования памяти в случае перекошенных данных, когда некоторые большие строки имеют множество совпадений в правой таблице.
joined_subquery_requires_alias
kafka_disable_num_consumers_limit
kafka_num_consumers, зависящее от количества доступных ядер CPU.
Время ожидания в миллисекундах при чтении сообщений из Kafka до повторной попытки.
Возможные значения:
- Положительное целое число.
- 0 — бесконечный тайм-аут.
См. также:
Включает дополнительные проверки при операциях с KeeperMap. Например, позволяет сгенерировать исключение при вставке ключа, который уже существует
Максимальное количество повторных попыток для обычных операций Keeper
keeper_retry_initial_backoff_ms
keeper_retry_max_backoff_ms
least_greatest_legacy_null_behavior
legacy_column_name_of_tuple_literal
alter_update - выполнить запрос ALTER UPDATE, который создаёт тяжёлую мутацию.lightweight_update - выполнить легковесное обновление, если это возможно; в противном случае выполнить ALTER UPDATE.lightweight_update_force - выполнить легковесное обновление, если это возможно; в противном случае сгенерировать исключение.
То же, что и mutations_sync, но управляет только выполнением легковесных удалений.
Возможные значения:
| Value | Description |
|---|
0 | Мутации выполняются асинхронно. |
1 | Запрос ожидает завершения легковесных удалений на текущем сервере. |
2 | Запрос ожидает завершения легковесных удалений на всех репликах (если они есть). |
3 | Запрос ожидает завершения легковесных удалений только на активных репликах. Поддерживается только для SharedMergeTree. Для ReplicatedMergeTree ведет себя так же, как mutations_sync = 2. |
1.
Устанавливает максимальное количество строк в результате запроса. Это значение корректирует ограничение, заданное оператором LIMIT, так что ограничение, указанное в запросе, не может превышать ограничение, заданное этой настройкой.
Возможные значения:
- 0 — количество строк не ограничено.
- Положительное целое число.
Задаёт алгоритм выбора реплик, используемый при распределённой обработке запросов.
ClickHouse поддерживает следующие алгоритмы выбора реплик:
См. также:
Количество ошибок подсчитывается для каждой реплики. Запрос отправляется на реплику с наименьшим числом ошибок, а если таких реплик несколько — на любую из них.
Недостатки: близость сервера не учитывается; если у реплик разные данные, вы также получите разные данные.
load_balancing = nearest_hostname
Расстояние Левенштейна по имени хоста
load_balancing = hostname_levenshtein_distance
nearest_hostname, но сравнивает имена хостов по расстоянию Левенштейна. Например:
example-clickhouse-0-0 ample-clickhouse-0-0
1
example-clickhouse-0-0 example-clickhouse-1-10
2
example-clickhouse-0-0 example-clickhouse-12-0
3
load_balancing = in_order
load_balancing = first_or_random
first_or_random решает проблему алгоритма in_order. При использовании in_order, если одна реплика выходит из строя, следующая получает двойную нагрузку, тогда как остальные реплики обрабатывают обычный объём трафика. При использовании алгоритма first_or_random нагрузка равномерно распределяется между репликами, которые всё ещё доступны.
Можно явно указать, какая реплика считается первой, с помощью настройки load_balancing_first_offset. Это позволяет точнее перебалансировать нагрузку запросов между репликами.
load_balancing = round_robin
round_robin).
load_balancing_first_offset
load_marks_asynchronously
1.
local_filesystem_read_method
local_filesystem_read_prefetch
DEADLOCK_AVOIDED.
Возможные значения:
- Положительное целое число (в секундах).
- 0 — без тайм-аута блокировки.
Задаёт значение для поля log_comment таблицы system.query_log и текст комментария для серверного журнала.
Используется для повышения читаемости серверных журналов. Кроме того, помогает выбирать из system.query_log запросы, относящиеся к тесту, после запуска clickhouse-test.
Возможные значения:
- Любая строка длиной не более max_query_size. Если значение max_query_size превышено, сервер генерирует исключение.
Пример
Запрос:
SET log_comment = 'log_comment test', log_queries = 1;
SELECT 1;
SYSTEM FLUSH LOGS;
SELECT type, query FROM system.query_log WHERE log_comment = 'log_comment test' AND event_date >= yesterday() ORDER BY event_time DESC LIMIT 2;
┌─type────────┬─query─────┐
│ QueryStart │ SELECT 1; │
│ QueryFinish │ SELECT 1; │
└─────────────┴───────────┘
formatted_query в system.query_log).
Возможные значения:
- 0 — Отформатированные запросы не записываются в системную таблицу.
- 1 — Отформатированные запросы записываются в системную таблицу.
Записывает в таблицу system.processors_profile_log время, которое процессор потратил на выполнение и ожидание данных.
См. также:
Записывает статистику производительности выполнения запросов в query_log, query_thread_log и query_views_log.
Настройка логирования запросов.
Запросы, отправленные в ClickHouse при включении этой настройки, записываются в соответствии с правилами параметра конфигурации сервера query_log.
Пример:
log_queries_cut_to_length
log_queries_min_query_duration_ms
long_query_time для MySQL Slow Query Log); по сути это означает, что вы не найдете их в следующих таблицах:
system.query_logsystem.query_thread_log
В журнал будут попадать только запросы следующих типов:
-
QUERY_FINISH
-
EXCEPTION_WHILE_PROCESSING
-
Тип: миллисекунды
-
Значение по умолчанию: 0 (любой запрос)
Минимальный тип записи в query_log.
Возможные значения:
QUERY_START (=1)QUERY_FINISH (=2)EXCEPTION_BEFORE_START (=3)EXCEPTION_WHILE_PROCESSING (=4)
Можно использовать, чтобы ограничить, какие сущности будут попадать в query_log; например, если вас интересуют только ошибки, можно использовать EXCEPTION_WHILE_PROCESSING:
log_queries_min_type='EXCEPTION_WHILE_PROCESSING'
- 0 — Запросы не записываются в системные таблицы.
- Положительное число с плавающей точкой в диапазоне [0..1]. Например, если значение настройки равно
0.5, в системные таблицы записывается примерно половина запросов.
- 1 — Все запросы записываются в системные таблицы.
Записывать настройки запроса в query_log и журнал спанов OpenTelemetry.
Включает логирование потоков запросов.
Потоки запросов записываются в таблицу system.query_thread_log. Этот параметр действует только в том случае, если log_queries имеет значение true. Потоки запросов, выполняемых ClickHouse при включенной этой настройке, записываются в соответствии с правилами параметра конфигурации сервера query_thread_log.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Пример
Включает журналирование представлений запросов.
Если у запроса, выполняемого ClickHouse при включенной этой настройке, есть связанные представления (materialized views или live views), сведения о них записываются в лог, заданный параметром конфигурации сервера query_views_log.
Пример:
Разрешает или ограничивает использование типа данных LowCardinality в формате Native.
Если использование LowCardinality ограничено, сервер ClickHouse преобразует столбцы LowCardinality в обычные для запросов SELECT, а обычные столбцы — в столбцы LowCardinality для запросов INSERT.
Эта настройка в основном нужна для сторонних клиентов, которые не поддерживают тип данных LowCardinality.
Возможные значения:
- 1 — использование
LowCardinality не ограничено.
- 0 — использование
LowCardinality ограничено.
low_cardinality_max_dictionary_size
- Любое положительное целое число.
low_cardinality_use_single_dictionary_for_part
low_cardinality_use_single_dictionary_for_part = 1.
Возможные значения:
- 1 — Создание нескольких словарей для части данных запрещено.
- 0 — Создание нескольких словарей для части данных не запрещено.
low_priority_query_wait_time_ms
priority), низкоприоритетные запросы ждут завершения запросов с более высоким приоритетом. Эта настройка определяет время ожидания.
Строить распределённый план запроса.
materialize_skip_indexes_on_insert
materialize_statistics_on_insert
materialize_ttl_after_modify
materialized_views_ignore_errors
materialized_views_squash_parallel_inserts
parallel_view_processing, запрос INSERT будет создавать в целевой таблице по одной части для каждого max_insert_thread.
Максимальное число анализов, выполняемых интерпретатором.
Максимальная глубина вложенности синтаксического дерева запроса. При превышении этого значения генерируется исключение.
В настоящий момент это не проверяется при синтаксическом разборе, а только после разбора запроса.
Это означает, что при синтаксическом разборе может быть создано слишком глубокое синтаксическое дерево,
но запрос завершится ошибкой.
В настоящее время это не проверяется во время разбора, а только после разбора запроса.
Это означает, что во время разбора может быть создано слишком глубокое синтаксическое дерево,
но запрос завершится с ошибкой.
generateSerialID.
Поскольку каждая серия представляет собой узел в Keeper, рекомендуется не создавать более нескольких миллионов таких серий.
Максимальная скорость чтения для конкретной резервной копии на сервере, в байтах в секунду. Ноль означает отсутствие ограничений.
В ClickHouse данные обрабатываются блоками, которые представляют собой наборы частей столбцов. Внутренние циклы обработки отдельного блока эффективны, но обработка каждого блока связана с заметными накладными расходами.
Настройка max_block_size задаёт рекомендуемое максимальное число строк в одном блоке при загрузке данных из таблиц. Блоки размером max_block_size не всегда загружаются из таблицы: если ClickHouse определяет, что нужно извлечь меньше данных, обрабатывается блок меньшего размера.
Размер блока не должен быть слишком маленьким, чтобы избежать заметных накладных расходов при обработке каждого блока. В то же время он не должен быть слишком большим, чтобы запросы с оператором LIMIT выполнялись быстро после обработки первого блока. При настройке max_block_size следует стремиться к тому, чтобы не расходовать слишком много памяти при извлечении большого числа столбцов в нескольких потоках и сохранять хотя бы некоторую локальность кэша.
max_bytes_before_external_group_by
GROUP BY с использованием внешней памяти.
(См. GROUP BY с использованием внешней памяти)
Возможные значения:
- Максимальный объем оперативной памяти (в байтах), который может использовать одна операция GROUP BY.
0 — GROUP BY с использованием внешней памяти отключен.
Если при выполнении операций GROUP BY использование памяти превышает этот порог,
включается режим «внешняя агрегация» (сброс данных на диск).Рекомендуемое значение — половина доступной системной памяти.
max_bytes_before_external_join
join_algorithm имеет значение hash, parallel_hash, default или auto, hash JOIN будет автоматически преобразован в grace hash join, чтобы включить выгрузку на диск, когда объём данных с правой стороны превысит указанное количество байт. Если задано значение 0 (по умолчанию), этот абсолютный порог в байтах отключён, но автоматическая выгрузка всё равно может происходить через max_bytes_ratio_before_external_join (по умолчанию 0.5); задайте для обоих значение 0, чтобы полностью отключить автоматическую выгрузку. Это предотвращает оптимизацию чтения in order через JOIN.
max_bytes_before_external_sort
ORDER BY с использованием внешней памяти. См. Подробности реализации ORDER BY
Если во время операции ORDER BY использование памяти превышает этот порог в байтах, включается режим «внешней сортировки» (сброс данных на диск).
Возможные значения:
- Максимальный объем оперативной памяти (в байтах), который может использовать одна операция ORDER BY.
Рекомендуемое значение — половина доступной системной памяти
0 — ORDER BY с использованием внешней памяти отключен.
max_bytes_before_remerge_sort
- Положительное целое число.
- 0 — контроль памяти отключён.
Максимальное количество байтов (несжатых данных), используемых набором в выражении IN,
созданном из подзапроса.
max_bytes_ratio_before_external_group_by
GROUP BY. После достижения
этого значения для агрегации будет использоваться внешняя память.
Например, если задано значение 0.6, GROUP BY позволит использовать 60% доступной памяти
(для server/user/merges) в начале выполнения, после чего
начнёт использовать внешнюю агрегацию.
max_bytes_ratio_before_external_join
JOIN. При достижении этого значения hash join будет преобразован в grace hash join, чтобы выгружать данные с правой стороны на диск.
Например, если задано 0.6, JOIN позволит использовать 60% доступной памяти (для server/user/merges) для хеш-таблицы правой стороны в начале выполнения; после этого начнется выгрузка на диск.
Если заданы и max_bytes_before_external_join, и max_bytes_ratio_before_external_join, используется меньший из получившихся порогов. Если доля равна 0, применяется только абсолютная настройка.
Действует только в случае, если join_algorithm имеет значение hash, parallel_hash, default или auto и настроен путь для временных данных.
max_bytes_ratio_before_external_sort
ORDER BY. После достижения этого порога применяется внешняя сортировка.
Например, если установлено значение 0.6, ORDER BY позволит использовать 60% доступной памяти (для server/user/merges) в начале выполнения, после чего начнёт использовать внешнюю сортировку.
Обратите внимание: значение max_bytes_before_external_sort по-прежнему учитывается; сброс на диск выполняется только в том случае, если блок сортировки больше max_bytes_before_external_sort.
Максимальное количество байтов (несжатых данных), которое можно прочитать из таблицы при выполнении запроса.
Ограничение проверяется для каждого обрабатываемого фрагмента данных, применяется только к
самому глубокому табличному выражению и при чтении с удалённого сервера проверяется только на
удалённом сервере.
Максимальное количество байтов (несжатых данных), которое можно прочитать из локальной
таблицы на листовом узле при выполнении распределённого запроса. Хотя распределённые запросы
могут отправлять по несколько подзапросов на каждый сегмент (листовой узел), это ограничение
проверяется только на этапе чтения на листовых узлах и игнорируется на этапе
слияния результатов на корневом узле.
Например, кластер состоит из 2 сегментов, и каждый сегмент содержит таблицу со
100 байтами данных. Распределённый запрос, который должен прочитать все данные
из обеих таблиц с настройкой max_bytes_to_read=150, завершится ошибкой, поскольку
общий объём составит 200 байт. Запрос с max_bytes_to_read_leaf=150 выполнится успешно,
поскольку листовые узлы прочитают не более 100 байт.
Ограничение проверяется для каждого обрабатываемого фрагмента данных.
Этот параметр работает нестабильно при prefer_localhost_replica=1.
sort_overflow_mode, который по умолчанию имеет значение throw.
Максимальное количество байтов (несжатых данных), которое можно передать на удалённый
сервер или сохранить во временной таблице при выполнении секции GLOBAL IN/JOIN.
Максимальное количество столбцов, которое можно прочитать из таблицы в рамках одного запроса.
Если для выполнения запроса требуется прочитать больше столбцов, чем указано, генерируется исключение.
Эта настройка помогает предотвратить чрезмерно сложные запросы.
0 означает отсутствие ограничений.
Максимальный размер блоков несжатых данных перед их сжатием для записи в таблицу. По умолчанию — 1 048 576 (1 MiB). Указание меньшего размера блока обычно приводит к небольшому снижению коэффициента сжатия; при этом скорость сжатия и распаковки немного возрастает благодаря локальности кэша, а потребление памяти уменьшается.
Это настройка экспертного уровня, и вам не следует её изменять, если вы только начинаете работать с ClickHouse.
max_concurrent_queries_for_all_users
max_concurrent_queries_for_all_users можно установить в значение 99 для всех пользователей, а администратор базы данных может установить для себя значение 100, чтобы выполнять запросы для расследования даже при перегрузке сервера.
Изменение этой настройки для одного запроса или пользователя не влияет на другие запросы.
Возможные значения:
- Положительное целое число.
- 0 — Без ограничений.
Пример
<max_concurrent_queries_for_all_users>99</max_concurrent_queries_for_all_users>
1000.
max_concurrent_queries_for_user
- Положительное целое число.
- 0 — без ограничений.
Пример
<max_concurrent_queries_for_user>5</max_concurrent_queries_for_user>
max_distributed_connections
- Положительное целое число.
- 0 — неограниченная глубина.
Максимальный размер буфера для параллельной загрузки (например, для движка URL) на каждый поток.
Максимальное количество потоков для загрузки данных (например, для URL engine).
max_estimated_execution_time
timeout_before_checking_execution_speed.
Максимальное количество строк, обрабатываемых в секунду. Проверяется на каждом блоке данных, когда
timeout_before_checking_execution_speed
истекает. Если скорость выполнения слишком высокая, она будет снижена.
max_execution_speed_bytes
timeout_before_checking_execution_speed.
Если скорость выполнения слишком высока, она будет снижена.
Максимальное время выполнения запроса в секундах.
Параметр 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, но
применяется только на листовых узлах для распределённых или удалённых запросов.
Например, если мы хотим ограничить время выполнения на листовом узле до 10s, но
не устанавливать ограничение на инициирующем узле, то вместо использования max_execution_time в
настройках вложенного подзапроса:
SELECT count()
FROM cluster(cluster, view(SELECT * FROM t SETTINGS max_execution_time = 10));
max_execution_time_leaf в качестве настройки запроса:
SELECT count()
FROM cluster(cluster, view(SELECT * FROM t)) SETTINGS max_execution_time_leaf = 10;
max_expanded_ast_elements
max_fetch_partition_retries_count
SELECT с модификатором FINAL.
Возможные значения:
- Положительное целое число.
- 0 или 1 — отключено. Запросы
SELECT выполняются в одном потоке.
Максимально допустимое количество переходов при перенаправлениях HTTP GET. Обеспечивает дополнительные меры безопасности, предотвращая перенаправление ваших запросов вредоносным сервером к неожиданным сервисам.\n\nЭто может произойти, когда внешний сервер перенаправляет на другой адрес, но этот адрес оказывается внутренним для инфраструктуры компании. В таком случае, отправив HTTP-запрос на внутренний сервер, вы можете обратиться к внутреннему API из внутренней сети, обойдя аутентификацию, или даже выполнять запросы к другим сервисам, таким как Redis или Memcached. Если у вас нет внутренней инфраструктуры (включая что-либо, работающее на вашем localhost) или вы доверяете серверу, перенаправления можно безопасно разрешить. Однако имейте в виду: если URL использует HTTP вместо HTTPS, вам придется доверять не только удаленному серверу, но и своему интернет-провайдеру, а также всем сетям между вами и сервером.
Значение по умолчанию в Cloud: 10.
max_hyperscan_regexp_length
- Положительное целое число.
- 0 — длина не ограничена.
Пример
Запрос:
SELECT multiMatchAny('abcd', ['ab','bcd','c','d']) SETTINGS max_hyperscan_regexp_length = 3;
┌─multiMatchAny('abcd', ['ab', 'bcd', 'c', 'd'])─┐
│ 1 │
└────────────────────────────────────────────────┘
SELECT multiMatchAny('abcd', ['ab','bcd','c','d']) SETTINGS max_hyperscan_regexp_length = 2;
Exception: Regexp length too large.
max_hyperscan_regexp_total_length
- Положительное целое число.
- 0 — длина не ограничена.
Пример
Запрос:
SELECT multiMatchAny('abcd', ['a','b','c','d']) SETTINGS max_hyperscan_regexp_total_length = 5;
┌─multiMatchAny('abcd', ['a', 'b', 'c', 'd'])─┐
│ 1 │
└─────────────────────────────────────────────┘
SELECT multiMatchAny('abcd', ['ab','bc','c','d']) SETTINGS max_hyperscan_regexp_total_length = 5;
Exception: Total regexp lengths too large.
max_insert_block_size_rows
Максимальный размер блоков (по числу строк), формируемых для вставки в таблицу.
Этот параметр управляет формированием блоков в двух контекстах:
-
Разбор форматов: когда сервер разбирает построчные входные форматы (CSV, TSV, JSONEachRow и т. д.) через любой интерфейс (HTTP, clickhouse-client со встроенными данными, gRPC, по протоколу PostgreSQL), блоки формируются, когда:
- достигнуты оба порога: min_insert_block_size_rows И min_insert_block_size_bytes, ИЛИ
- достигнут любой из максимальных порогов: max_insert_block_size_rows ИЛИ max_insert_block_size_bytes
Примечание: при использовании clickhouse-client или clickhouse-local для чтения из файла данные разбирает сам клиент, и этот параметр применяется на стороне клиента.
-
Операции INSERT: во время запросов INSERT и при прохождении данных через materialized views поведение этого параметра зависит от
use_strict_insert_block_limits:
-
Если включен: блоки формируются, когда:
- Минимальные пороги (И): достигнуты оба порога min_insert_block_size_rows И min_insert_block_size_bytes
- Максимальные пороги (ИЛИ): достигнут любой из порогов max_insert_block_size_rows ИЛИ max_insert_block_size_bytes
-
Если отключен: блоки формируются, когда достигнут min_insert_block_size_rows ИЛИ min_insert_block_size_bytes. Параметры max_insert_block_size не применяются.
Возможные значения:
- Положительное целое число.
max_insert_block_size_bytes
- Положительное целое число.
- 0 — настройка не участвует в формировании блоков.
max_insert_delayed_streams_for_parallel_write
50.
Максимальное количество потоков для выполнения запроса INSERT SELECT.
Возможные значения:
- 0 (или 1) — для
INSERT SELECT параллельное выполнение не используется.
- Положительное целое число больше 1.
Значение по умолчанию в Cloud:
1 для узлов с 8 GiB памяти2 для узлов с 16 GiB памяти4 для более крупных узлов
Параллельное выполнение INSERT SELECT имеет эффект только в том случае, если часть SELECT также выполняется параллельно, см. настройку max_threads.
Более высокие значения приводят к большему использованию памяти.
max_insert_threads_min_free_memory_per_thread
max_threads_min_free_memory_per_thread, но применяется к max_insert_threads, а не к max_threads. Значение по умолчанию выше, поскольку конвейеры вставки обычно используют более крупные буферы на поток (части MergeTree, блоки сжатия), чем конвейеры чтения.
Если объем свободной памяти меньше значения max_insert_threads, умноженного на это значение, max_insert_threads уменьшается до допустимого уровня, но не ниже 1.
Установите 0, чтобы отключить это ограничение.
max_joined_block_size_bytes
max_joined_block_size_rows
max_limit_for_vector_search_queries
max_local_write_bandwidth
0 означает отсутствие ограничений.
Этот параметр не учитывает объем доступной памяти или общий объем
памяти на машине. Ограничение применяется к одному запросу на
одном сервере.
Вы можете использовать SHOW PROCESSLIST, чтобы увидеть текущее потребление памяти для каждого запроса.
Пиковое потребление памяти отслеживается для каждого запроса и записывается в лог.
Использование памяти отслеживается не полностью для состояний следующих агрегатных функций
с аргументами String и Array:
minmaxanyanyLastargMinargMax
Потребление памяти также ограничивается параметрами max_memory_usage_for_user
и max_server_memory_usage.
max_memory_usage_for_user
max_memory_usage_for_user = 0).
Также см. описание max_memory_usage.
Например, если вы хотите установить для пользователя с именем clickhouse_read значение max_memory_usage_for_user, равное 1000 байт, можно использовать оператор
ALTER USER clickhouse_read SETTINGS max_memory_usage_for_user = 1000;
getSetting:
SELECT getSetting('max_memory_usage_for_user');
- Положительное целое число.
- 0 — ограничение пропускной способности отключено.
max_network_bandwidth_for_all_users
- Положительное целое число.
- 0 — ограничение скорости передачи данных отключено.
max_network_bandwidth_for_user
- Положительное целое число.
- 0 — ограничение скорости передачи данных отключено.
Ограничивает объём данных (в байтах), получаемых или передаваемых по сети при выполнении запроса. Этот параметр применяется к каждому отдельному запросу.
Возможные значения:
- Положительное целое число.
- 0 — ограничение объёма данных отключено.
max_number_of_partitions_for_independent_aggregation
max_os_cpu_wait_time_ratio_to_throw
- Положительное целое число.
Дополнительная информация
Этот параметр может давать разные результаты в зависимости от используемых настроек.
Параллельная обработка с использованием ключа SAMPLE
- Положение ключа выборки в ключе партиционирования не позволяет эффективно выполнять диапазонное сканирование.
- Добавление ключа выборки в таблицу снижает эффективность фильтрации по другим столбцам.
- Ключ выборки представляет собой выражение, вычисление которого требует значительных затрат.
- Распределение задержек в кластере имеет длинный хвост, поэтому выполнение запроса на большем числе серверов увеличивает его общую задержку.
Эта настройка полезна для любой реплицируемой таблицы.
Максимальное количество возвратов парсера (сколько раз он пробует разные альтернативы в процессе рекурсивного нисходящего разбора).
Ограничивает максимальную глубину рекурсии в рекурсивном нисходящем анализаторе. Позволяет управлять размером стека.
Возможные значения:
- Положительное целое число.
- 0 — глубина рекурсии не ограничена.
Максимальное количество потоков для разбора данных во входных форматах, поддерживающих параллельный разбор. По умолчанию определяется автоматически.
max_partition_size_to_drop
0 означает, что партиции можно удалять без каких-либо ограничений.
Значение по умолчанию в Cloud: 1 TB.
max_partitions_per_insert_block
- Положительное целое число.
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 и т. д.).”
Эта настройка является защитным порогом, поскольку использование большого количества партиций — распространенное заблуждение.
- Положительное целое число
-1 — без ограничений (по умолчанию)
Ограничивает число частей, которые можно переместить за один запрос. Ноль означает отсутствие ограничений.
max_projection_rows_to_use_projection_index
max_query_size нельзя задать внутри SQL-запроса (например, SELECT now() SETTINGS max_query_size=10000), поскольку ClickHouse должен выделить буфер для разбора запроса, а размер этого буфера определяется настройкой max_query_size, которая должна быть задана до выполнения запроса.
max_rand_distribution_parameter
randChiSquared, randStudentT и randFisherF. Это предотвращает чрезмерно долгое время вычислений при экстремальных значениях параметров.
max_rand_distribution_trials
randBinomial и randNegativeBinomial. Это предотвращает чрезмерно долгие вычисления при большом числе испытаний.
Максимальный размер буфера для чтения из файловой системы.
max_read_buffer_size_local_fs
max_read_buffer_size_remote_fs
max_recursive_cte_evaluation_depth
max_remote_read_network_bandwidth
max_remote_write_network_bandwidth
max_replica_delay_for_distributed_queries
- Положительное целое число.
- 0 — отставание реплик не проверяется.
Чтобы исключить использование любой реплики с ненулевым отставанием, установите этот параметр в 1.
Используется при выполнении SELECT из distributed таблицы, которая указывает на реплицированные таблицы.
Ограничивает размер результата в байтах (в несжатом виде). Запрос остановится после обработки блока данных, если порог достигнут,
но последний блок результата обрезан не будет, поэтому размер результата может превысить порог.
Ограничения
Для этого порога учитывается размер результата в памяти.
Даже если сам результат небольшой, он может ссылаться на более крупные структуры данных в памяти,
такие как словари для столбцов LowCardinality и Arena для столбцов AggregateFunction,
поэтому порог может быть превышен, несмотря на небольшой размер результата.
Этот параметр является довольно низкоуровневым и должен использоваться с осторожностью
0.
Ограничивает количество строк в результате. Проверяется также для подзапросов и на удалённых серверах при выполнении частей распределённого запроса.
Если значение равно 0, ограничение не применяется.
Запрос остановится после обработки блока данных, если порог достигнут, но
последний блок результата обрезан не будет, поэтому размер результата может
превышать порог.
max_reverse_dictionary_lookup_cache_size_bytes
dictGetKeys. Кэш хранит сериализованные кортежи ключей для каждого значения атрибута, чтобы избежать повторного сканирования словаря в рамках одного и того же запроса. При достижении лимита записи кэша вытесняются по алгоритму LRU. Установите 0, чтобы отключить кэширование.
Максимальное количество строк в наборе для ленивой оптимизации FINAL. При превышении этого значения используется обычный FINAL.
Максимальное количество различных строк при использовании DISTINCT.
Ограничивает количество строк в хеш-таблице, используемой при объединении таблиц.
Этот параметр применяется к операциям SELECT … JOIN
и движку таблицы Join.
Если запрос содержит несколько JOIN, ClickHouse проверяет этот параметр для каждого промежуточного результата.
При достижении лимита ClickHouse может выполнять разные действия. Используйте
параметр join_overflow_mode, чтобы выбрать нужное действие.
Возможные значения:
- Положительное целое число.
0 — Неограниченное количество строк.
Максимальное количество строк в наборе данных для оператора IN, созданного из подзапроса.
max_rows_in_set_to_optimize_join
- 0 — Отключить.
- Любое положительное целое число.
Максимальное количество уникальных ключей, полученных при агрегации. Этот параметр позволяет
ограничить потребление памяти при агрегации.
Если во время GROUP BY агрегация создаёт больше строк
(уникальных ключей GROUP BY), чем указано, поведение будет определяться
параметром ‘group_by_overflow_mode’, который по умолчанию имеет значение throw, но его также можно переключить
в приблизительный режим GROUP BY.
Максимальное количество строк, которое можно прочитать из таблицы при выполнении запроса.
Ограничение проверяется для каждого обрабатываемого фрагмента данных, применяется только к
наиболее глубокому табличному выражению, а при чтении с удалённого сервера проверяется только на
удалённом сервере.
Максимальное количество строк, которое можно прочитать из локальной таблицы на листовом узле при
выполнении распределённого запроса. Хотя распределённые запросы могут отправлять несколько подзапросов
к каждому сегменту (листовому узлу), это ограничение проверяется только на этапе чтения на
листовых узлах и игнорируется на этапе слияния результатов на корневом узле.
Например, кластер состоит из 2 сегментов, и каждый сегмент содержит таблицу со
100 строками. Распределённый запрос, который должен прочитать все данные из обеих
таблиц с настройкой max_rows_to_read=150, завершится ошибкой, так как всего будет
200 строк. Запрос с max_rows_to_read_leaf=150 выполнится успешно, поскольку листовые узлы
прочитают не более 100 строк.
Ограничение проверяется для каждого обрабатываемого фрагмента данных.
Эта настройка работает нестабильно при prefer_localhost_replica=1.
sort_overflow_mode, который по умолчанию имеет значение throw.
Максимальное количество строк, которое может быть передано на удалённый сервер или сохранено
во временной таблице при выполнении секции GLOBAL IN/JOIN.
Максимальное количество одновременных сеансов для каждого аутентифицированного пользователя ClickHouse server.
Пример:
<profiles>
<single_session_profile>
<max_sessions_for_user>1</max_sessions_for_user>
</single_session_profile>
<two_sessions_profile>
<max_sessions_for_user>2</max_sessions_for_user>
</two_sessions_profile>
<unlimited_sessions_profile>
<max_sessions_for_user>0</max_sessions_for_user>
</unlimited_sessions_profile>
</profiles>
<users>
<!-- Пользователь Alice может подключаться к серверу ClickHouse не более одного раза одновременно. -->
<Alice>
<profile>single_session_user</profile>
</Alice>
<!-- Пользователь Bob может использовать 2 одновременных сеанса. -->
<Bob>
<profile>two_sessions_profile</profile>
</Bob>
<!-- Пользователь Charles может использовать неограниченное количество одновременных сеансов. -->
<Charles>
<profile>unlimited_sessions_profile</profile>
</Charles>
</users>
- Положительное целое число
0 — неограниченное число одновременных сеансов (по умолчанию)
max_size_to_preallocate_for_aggregation
max_size_to_preallocate_for_joins
max_skip_unavailable_shards_num
skip_unavailable_shards включен, ограничивает максимальное количество сегментов, которые можно пропустить без ошибки.
Если количество недоступных сегментов превышает это значение, вместо пропуска без ошибки генерируется исключение.
Значение 0 означает отсутствие ограничения (поведение по умолчанию — можно пропустить все недоступные сегменты).
max_skip_unavailable_shards_ratio
skip_unavailable_shards включен, ограничивает максимальную долю (от 0 до 1) сегментов, которые можно пропустить без уведомления.
Если доля недоступных сегментов от общего числа сегментов превышает это значение, вместо пропуска без уведомления будет сгенерировано исключение.
Значение 0 означает отсутствие ограничения (поведение по умолчанию — можно пропустить все недоступные сегменты).
max_streams_for_files_processing_in_cluster_functions
max_streams_for_merge_tree_reading
max_streams_for_union_step
UNION (применяется как к UNION ALL, так и к UNION DISTINCT, поскольку UNION DISTINCT реализуется как шаг UNION ALL, за которым следует шаг DISTINCT). Когда запрос UNION содержит много подзапросов, все они одновременно открывают свои буферы чтения, из-за чего использование памяти становится пропорциональным количеству подзапросов. Эта настройка добавляет процессоры Concat, чтобы сузить конвейер и гарантировать, что одновременно активно не более указанного числа потоков, что значительно снижает пиковое потребление памяти. Фактическое ограничение — минимум из этого значения и max_threads * max_streams_for_union_step_to_max_threads_ratio (если любое из них равно 0, оно не учитывается). Если оба значения равны 0, сужение не применяется.
max_streams_for_union_step_to_max_threads_ratio
max_threads, задаёт ограничение на число одновременно активных потоков на шаге UNION (применяется как к UNION ALL, так и к UNION DISTINCT). Фактическое ограничение — минимум из этого вычисленного значения и max_streams_for_union_step (если любое из них равно 0, оно игнорируется). Например, при max_threads = 8 и значении этого соотношения 1 одновременно будет активно не более 8 потоков. Установите 0, чтобы отключить это ограничение, зависящее от соотношения.
max_streams_multiplier_for_merge_tables
max_streams_to_max_threads_ratio
Это позволяет выполнять проверку на адекватность, чтобы защитить пользователей вашего
кластера от написания чрезмерно сложных запросов.
0 означает, что можно удалять любые таблицы без ограничений.
Значение по умолчанию в Cloud: 1 TB.
Максимальное количество временных столбцов, которые должны одновременно
храниться в оперативной памяти при выполнении запроса, включая константные столбцы. Если в результате промежуточных
вычислений запрос создаёт в памяти больше указанного количества временных столбцов,
то генерируется исключение.
Эта настройка полезна для предотвращения чрезмерно сложных запросов.
0 означает отсутствие ограничений.
max_temporary_data_on_disk_size_for_query
- Положительное целое число.
0 — без ограничений (по умолчанию)
max_temporary_data_on_disk_size_for_user
- Положительное целое число.
0 — не ограничено (по умолчанию)
max_temporary_non_const_columns
max_temporary_columns, это максимальное количество временных столбцов, которые должны
одновременно храниться в оперативной памяти при выполнении запроса, без учета константных
столбцов.
Константные столбцы довольно часто формируются при выполнении запроса, но практически не требуют
вычислительных ресурсов.
WHERE и предварительную агрегацию для GROUP BY можно выполнять параллельно как минимум в количестве ‘max_threads’ потоков, то будут использоваться ‘max_threads’.
Для запросов, которые быстро завершаются из-за LIMIT, можно задать меньшее значение ‘max_threads’.
Например, если нужное число записей находится в каждом block и max_threads = 8, то будут считаны 8 blocks, хотя достаточно было бы прочитать только один.
Чем меньше значение max_threads, тем меньше расход памяти.
По умолчанию значение настройки max_threads соответствует числу аппаратных потоков (числу ядер CPU), доступных ClickHouse.
В особом случае для процессоров x86 с менее чем 32 ядрами CPU и SMT (например, Intel HyperThreading) ClickHouse по умолчанию использует число логических ядер (= 2 x число физических ядер).
Без SMT (например, Intel HyperThreading) это соответствует числу ядер CPU.
Для пользователей ClickHouse Cloud значение по умолчанию отображается как auto(N), где N соответствует размеру vCPU вашего сервиса, например 2vCPU/8GiB, 4vCPU/16GiB и т. д.
Список всех размеров сервисов см. на вкладке Settings в консоли Cloud.
Максимальное количество потоков для обработки индексов.
max_threads_min_free_memory_per_thread
max_threads, когда сервер испытывает нехватку памяти, чтобы не запускать сильно распараллеленные запросы, которые с высокой вероятностью упрутся в лимит памяти.
Свободная память вычисляется как max_server_memory_usage сервера минус память, которая в данный момент учитывается глобальным трекер памяти. Если этой свободной памяти меньше, чем max_threads, умноженное на это значение, max_threads уменьшается до наибольшего N, для которого N * value <= free_memory, при минимальном значении 1.
Установите 0, чтобы отключить это ограничение.
Например, при значении по умолчанию 1 GiB и 32 GiB свободной памяти max_threads ограничивается значением 32; при 1 GiB свободной памяти оно снижается до 1.
Эта настройка применяется к параллелизму на стороне чтения (SELECT, UNION, INTERSECT/EXCEPT и часть SELECT в INSERT ... SELECT). Для стороны записи см. max_insert_threads_min_free_memory_per_thread.
Небольшие выделения и освобождения памяти суммируются в локальной переменной потока и отслеживаются или профилируются только тогда, когда их объём (по модулю) превышает указанное значение. Если это значение больше, чем memory_profiler_step, оно фактически будет уменьшено до memory_profiler_step.
max_wkb_geometry_elements
readWKB и связанными с ней функциями. Это защищает от чрезмерного выделения памяти из-за некорректных данных WKB. Установите 0, чтобы использовать жёстко заданный предел (100 миллионов).
memory_overcommit_ratio_denominator
memory_overcommit_ratio_denominator_for_user
memory_profiler_sample_max_allocation_size
memory_profiler_sample_probability. 0 означает, что параметр отключён. Возможно, стоит установить ‘max_untracked_memory’ в 0, чтобы этот порог работал ожидаемым образом.
memory_profiler_sample_min_allocation_size
memory_profiler_sample_probability. 0 означает, что параметр отключен. Чтобы этот порог работал как ожидается, может потребоваться установить max_untracked_memory в 0.
memory_profiler_sample_probability
memory_profiler_sample_min_allocation_size и memory_profiler_sample_max_allocation_size). Обратите внимание, что сэмплирование происходит только тогда, когда объём неотслеживаемой памяти превышает ‘max_untracked_memory’. Для более детализированного сэмплирования можно установить ‘max_untracked_memory’ в 0.
Задаёт шаг профилировщика памяти. Каждый раз, когда использование памяти запросом превышает следующий порог, заданный в байтах, профилировщик памяти собирает трассировку стека выделения памяти и записывает её в trace_log.
Возможные значения:
-
Положительное целое число байт.
-
0 — чтобы отключить профилировщик памяти.
memory_tracker_fault_probability
exception safety — с указанной вероятностью генерировать исключение при каждом выделении памяти.
memory_usage_overcommit_max_wait_microseconds
merge_table_max_tables_to_look_for_schema_inference
Merge без явной схемы или при использовании табличной функции merge схема выводится как объединение не более чем указанного числа соответствующих таблиц.
Если таблиц больше, схема будет выведена по первым таблицам в пределах указанного количества.
merge_tree_coarse_index_granularity
merge_tree_coarse_index_granularity поддиапазонов и рекурсивно ищет ключи в них.
Возможные значения:
- Любое положительное чётное целое число.
merge_tree_compact_parts_min_granules_to_multibuffer_read
merge_tree_determine_task_size_by_prewhere_columns
merge_tree_max_bytes_to_use_cache
merge_tree_max_bytes_to_use_cache байт, кеш несжатых блоков не используется.
Кеш несжатых блоков хранит данные, извлечённые при выполнении запросов. ClickHouse использует этот кеш, чтобы ускорить обработку повторяющихся небольших запросов. Эта настройка защищает кеш от вытеснения запросами, которые считывают большой объём данных. Размер кеша несжатых блоков задаёт настройка сервера uncompressed_cache_size.
Возможные значения:
- Любое положительное целое число.
merge_tree_max_rows_to_use_cache
merge_tree_max_rows_to_use_cache строк, кэш несжатых блоков не используется.
Кэш несжатых блоков хранит данные, извлечённые для запросов. ClickHouse использует этот кэш, чтобы ускорить обработку повторяющихся небольших запросов. Эта настройка защищает кэш от вытеснения запросами, читающими большие объёмы данных. Размер кэша несжатых блоков задаётся настройкой сервера uncompressed_cache_size.
Возможные значения:
- Любое положительное целое число.
merge_tree_min_bytes_for_concurrent_read
merge_tree_min_bytes_for_concurrent_read, ClickHouse пытается читать этот файл параллельно в нескольких потоках.
Возможное значение:
- Положительное целое число.
merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem
- Положительное целое число.
merge_tree_min_bytes_for_seek
merge_tree_min_bytes_for_seek байт, то ClickHouse последовательно считывает диапазон файла, содержащий оба блока, избегая тем самым дополнительной операции seek.
Возможные значения:
- Любое положительное целое число.
merge_tree_min_bytes_per_task_for_remote_reading
filesystem_prefetch_min_bytes_for_single_read_task
Минимальное количество байт для чтения на одну задачу.
merge_tree_min_read_task_size
merge_tree_min_rows_for_concurrent_read
merge_tree_min_rows_for_concurrent_read, ClickHouse пытается читать этот файл параллельно в нескольких потоках.
Возможные значения:
- Положительное целое число.
merge_tree_min_rows_for_concurrent_read_for_remote_filesystem
- Положительное целое число.
merge_tree_min_rows_for_seek
merge_tree_min_rows_for_seek строк, то ClickHouse не выполняет seek по файлу, а читает данные последовательно.
Возможные значения:
- Любое положительное целое число.
merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability
PartsSplitter — разделять диапазоны чтения на пересекающиеся и непересекающиеся каждый раз при чтении из MergeTree с указанной вероятностью.
merge_tree_storage_snapshot_sleep_ms
- 0 - Без задержки (по умолчанию)
- N - Задержка в миллисекундах
merge_tree_use_const_size_tasks_for_remote_reading
merge_tree_use_deserialization_prefixes_cache
merge_tree_use_prefixes_deserialization_thread_pool
max_prefixes_deserialization_thread_pool_size.
merge_tree_use_v1_object_and_dynamic_serialization
metrics_perf_events_enabled
min_bytes_to_use_direct_io
min_bytes_to_use_direct_io байт, ClickHouse читает данные с диска хранилища с опцией O_DIRECT.
Возможные значения:
- 0 — прямой ввод-вывод отключён.
- Положительное целое число.
Это экспериментальная настройка. Устанавливает минимальный размер для чтения больших файлов без копирования данных из ядра в пространство пользователя. Рекомендуемый порог — около 64 МБ, поскольку mmap/munmap работают медленно. Имеет смысл только для больших файлов и помогает только если данные находятся в кэше страниц.
Возможные значения:
- Положительное целое число.
- 0 — большие файлы читаются только с копированием данных из ядра в пространство пользователя.
min_chunk_bytes_for_parallel_parsing
- Тип: unsigned int
- Значение по умолчанию: 1 MiB
Минимальный размер фрагмента в байтах, разбираемого каждым потоком параллельно.
Для таблиц 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
- Положительное целое число.
- 0 — одинаковые агрегатные выражения всегда JIT-компилируются.
min_count_to_compile_expression
min_count_to_compile_sort_description
timeout_before_checking_execution_speed.
Если скорость выполнения ниже, генерируется исключение.
min_execution_speed_bytes
timeout_before_checking_execution_speed.
Если скорость выполнения ниже, генерируется исключение.
min_external_table_block_size_bytes
min_external_table_block_size_rows
min_filtered_ratio_for_lazy_final
min_free_disk_space_for_temporary_data
min_hit_rate_to_use_consecutive_keys_optimization
min_insert_block_size_bytes
min_insert_block_size_rows и управляет формированием блоков в тех же контекстах (при разборе формата и в операциях INSERT). Подробную информацию о том, когда и как применяются эти параметры, см. в описании min_insert_block_size_rows.
Возможные значения:
- Положительное целое число.
- 0 — параметр не участвует в формировании блоков.
min_insert_block_size_bytes_for_materialized_views
INSERT. Блоки меньшего размера объединяются в более крупные. Эта настройка применяется только к block, вставляемым в materialized view. Настраивая этот параметр, вы управляете объединением block при отправке в materialized view и избегаете чрезмерного использования памяти.
Возможные значения:
- Любое положительное целое число.
- 0 — объединение отключено.
См. также
min_insert_block_size_rows
-
Разбор форматов: Когда сервер разбирает построчные форматы ввода (CSV, TSV, JSONEachRow и т. д.) через любой интерфейс (HTTP, clickhouse-client со встроенными данными, gRPC, PostgreSQL wire protocol), блоки формируются, когда:
- Достигнуты оба значения min_insert_block_size_rows AND min_insert_block_size_bytes, OR
- Достигнуто либо значение max_insert_block_size_rows OR max_insert_block_size_bytes
Примечание: При использовании clickhouse-client или clickhouse-local для чтения из файла клиент сам разбирает данные, и этот параметр применяется на стороне клиента.
-
Операции INSERT: Во время запросов INSERT и когда данные проходят через materialized view, поведение этого параметра зависит от
use_strict_insert_block_limits:
-
Когда включен: Блоки формируются, когда:
- Минимальные пороги (AND): достигнуты оба значения min_insert_block_size_rows AND min_insert_block_size_bytes
- Максимальные пороги (OR): достигнуто либо значение max_insert_block_size_rows OR max_insert_block_size_bytes
-
Когда отключен (по умолчанию): Блоки формируются, когда достигнуто min_insert_block_size_rows OR min_insert_block_size_bytes. Параметры max_insert_block_size не применяются.
Возможные значения:
- Положительное целое число.
- 0 — параметр не участвует в формировании блоков.
min_insert_block_size_rows_for_materialized_views
INSERT. Блоки меньшего размера объединяются в более крупные. Эта настройка применяется только к блокам, вставляемым в materialized view. Изменяя эту настройку, вы управляете объединением блоков при записи в materialized view и избегаете чрезмерного использования памяти.
Возможные значения:
- Любое положительное целое число.
- 0 — объединение отключено.
См. также
min_joined_block_size_bytes
min_joined_block_size_rows
min_os_cpu_wait_time_ratio_to_throw
min_outstreams_per_resize_after_split
Resize или StrictResize после выполнения разделения при генерации конвейера. Если итоговое количество потоков меньше этого значения, операция разделения не выполняется.
Узел Resize — это процессор в конвейере запроса, который изменяет количество потоков данных, проходящих через конвейер. Он может как увеличивать, так и уменьшать число потоков, чтобы сбалансировать рабочую нагрузку между несколькими потоками выполнения или процессорами. Например, если запросу требуется больший параллелизм, узел Resize может разделить один поток на несколько. И наоборот, он может объединить несколько потоков в меньшее число, чтобы укрупнить обработку данных.
Узел Resize обеспечивает равномерное распределение данных между потоками, сохраняя структуру блоков данных. Это помогает оптимизировать использование ресурсов и повысить производительность запроса.
Почему узел Resize нужно разделить
ExecutingGraph::Node::status_mutex центрального узла Resize возникает высокая конкуренция, особенно в средах с большим числом ядер. Это приводит к следующему:
- Растёт задержка при выполнении ExecutingGraph::updateNode, что напрямую влияет на производительность запросов.
- Избыточные такты CPU тратятся на конкуренцию за spin-lock (
native_queued_spin_lock_slowpath), что снижает эффективность.
- Снижается загрузка CPU, что ограничивает параллелизм и пропускную способность.
Как разделяется узел Resize
- Проверяется количество выходных потоков, чтобы убедиться, что разделение возможно: число выходных потоков у каждого процессора после разделения соответствует пороговому значению
min_outstreams_per_resize_after_split или превышает его.
- Узел
Resize делится на более мелкие узлы Resize с одинаковым количеством портов, каждый из которых обрабатывает часть входных и выходных потоков.
- Каждая группа обрабатывается независимо, что уменьшает конкуренцию за блокировку.
В некоторых случаях, когда количество входов/выходов не кратно числу узлов Resize, на которые выполняется разбиение, часть входов подключается к NullSource, а часть выходов — к NullSink. Это позволяет выполнить разбиение без влияния на общий поток данных.
Настройка min_outstreams_per_resize_after_split гарантирует, что разделение узлов Resize будет оправданным и не приведет к созданию слишком малого числа потоков, что может снизить эффективность параллельной обработки. Задавая минимальное количество выходных потоков, эта настройка помогает поддерживать баланс между параллелизмом и накладными расходами, оптимизируя выполнение запроса в сценариях, где используются разделение и слияние потоков.
Чтобы отключить разделение узлов Resize, установите для этой настройки значение 0. Это предотвратит разделение узлов Resize при генерации конвейера, позволяя им сохранять исходную структуру без деления на более мелкие узлы.
min_table_rows_to_use_projection_index
mongodb_throw_on_unsupported_query
move_all_conditions_to_prewhere
move_primary_key_columns_to_end_of_prewhere
multiple_joins_try_to_keep_original_names
mutations_execute_nondeterministic_on_initiator
true, константные недетерминированные функции (например, now()) выполняются на инициаторе и заменяются литералами в запросах UPDATE и DELETE. Это помогает сохранять синхронизацию данных между репликами при выполнении мутаций с константными недетерминированными функциями. Значение по умолчанию: false.
mutations_execute_subqueries_on_initiator
true, скалярные подзапросы выполняются на узле-инициаторе и заменяются литеральными значениями в запросах UPDATE и DELETE. Значение по умолчанию: false.
mutations_max_literal_size_to_replace
UPDATE и DELETE. Действует только при включении хотя бы одной из двух настроек выше. Значение по умолчанию: 16384 (16 KiB).
Позволяет выполнять запросы ALTER TABLE ... UPDATE|DELETE|MATERIALIZE INDEX|MATERIALIZE PROJECTION|MATERIALIZE COLUMN|MATERIALIZE STATISTICS (мутации) синхронно.
Возможные значения:
| Значение | Описание |
|---|
0 | Мутации выполняются асинхронно. |
1 | Запрос ожидает завершения всех мутаций на текущем сервере. |
2 | Запрос ожидает завершения всех мутаций на всех репликах (если они есть). |
3 | Запрос ожидает завершения мутаций только на активных репликах. Поддерживается только для SharedMergeTree. Для ReplicatedMergeTree ведет себя так же, как mutations_sync = 2. |
mysql_datatypes_support_level
decimal, datetime64, date2Date32 или date2String. Все современные сопоставления (decimal, datetime64, date2Date32) включены по умолчанию.
decimal: преобразовывать типы NUMERIC и DECIMAL в Decimal, если это позволяет precision.datetime64: преобразовывать типы DATETIME и TIMESTAMP в DateTime64 вместо DateTime, если precision не равна 0.date2Date32: преобразовывать DATE в Date32 вместо Date. Имеет приоритет над date2String.date2String: преобразовывать DATE в String вместо Date. Переопределяется параметром datetime64.
mysql_map_fixed_string_to_text_in_show_columns
TEXT в команде SHOW COLUMNS.
Действует только при подключении через протокол MySQL.
- 0 - Использовать
BLOB.
- 1 - Использовать
TEXT.
mysql_map_string_to_text_in_show_columns
TEXT в SHOW COLUMNS.
Действует только при подключении через протокол MySQL.
- 0 - Использовать
BLOB.
- 1 - Использовать
TEXT.
Максимальное количество строк при батчевой вставке в MySQL для движка MySQL
network_compression_method
NONE — без сжатия.LZ4 — использовать кодек LZ4.LZ4HC — использовать кодек LZ4HC.ZSTD — использовать кодек ZSTD.
См. также
network_zstd_compression_level
ZSTD.
Возможные значения:
- Положительное целое число от 1 до 15.
Нормализует имена функций к их каноническому виду
number_of_mutations_to_delay
number_of_mutations_to_throw
odbc_bridge_connection_pool_size
odbc_bridge_use_connection_pooling
- 0 — строки не пропускаются.
- Положительное целое число.
Пример
Входная таблица:
CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);
SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;
┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘
opentelemetry_start_keeper_trace_probability
- ‘auto’ - Эквивалентно настройке opentelemetry_start_trace_probability
- 0 — Трассировка отключена
- от 0 до 1 — Вероятность (например, 1.0 = всегда включена)
opentelemetry_start_trace_probability
- 0 — трассировка для всех выполняемых запросов отключена (если не передан родительский контекст трассировки).
- Положительное число с плавающей точкой в диапазоне [0..1]. Например, если значение настройки равно
0,5, ClickHouse в среднем может начать трассировку для половины запросов.
- 1 — трассировка для всех выполняемых запросов включена.
opentelemetry_trace_cpu_scheduling
opentelemetry_trace_processors
optimize_aggregation_in_order
- 0 — оптимизация
GROUP BY отключена.
- 1 — оптимизация
GROUP BY включена.
См. также
optimize_aggregators_of_group_by_keys
optimize_and_compare_chain
<, <=, >, >=, = и их сочетания. Например, (a < b) AND (b < c) AND (c < 5) будет преобразовано в (a < b) AND (b < c) AND (c < 5) AND (b < 5) AND (a < 5).
Используйте ограничения, чтобы добавить условие индекса. Значение по умолчанию — false.
Возможные значения:
optimize_arithmetic_operations_in_aggregate_functions
- положительное целое число — максимальная длина имени,
- 0 — всегда,
- отрицательное целое число — никогда.
optimize_count_from_files
file/s3/url/hdfs/azureBlobStorage.
Возможные значения:
- 0 — Оптимизация отключена.
- 1 — Оптимизация включена.
optimize_dictget_tuple_element
tupleElement(dictGet('dict', ('a', 'b', 'c'), key), 2) в dictGet('dict', 'b', key), чтобы избежать извлечения ненужных атрибутов словаря. Поддерживает позиционный (.1, .2, …) и именованный (.b) доступ, а также применяется к dictGetOrDefault, когда аргумент значения по умолчанию представляет собой константный кортеж или tuple(...) из констант.
optimize_distinct_in_order
optimize_distributed_group_by_sharding_key
GROUP BY sharding_key, избегая затратной агрегации на сервере-инициаторе (что снижает использование памяти запросом на сервере-инициаторе).
Поддерживаются следующие типы запросов (а также любые их комбинации):
SELECT DISTINCT [..., ]sharding_key[, ...] FROM distSELECT ... FROM dist GROUP BY sharding_key[, ...]SELECT ... FROM dist GROUP BY sharding_key[, ...] ORDER BY xSELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1 BY x
Следующие типы запросов не поддерживаются (поддержка некоторых из них может быть добавлена позже):
SELECT ... GROUP BY sharding_key[, ...] WITH TOTALSSELECT ... GROUP BY sharding_key[, ...] WITH ROLLUPSELECT ... GROUP BY sharding_key[, ...] WITH CUBESELECT ... GROUP BY sharding_key[, ...] SETTINGS extremes=1
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
См. также:
Сейчас для этого требуется optimize_skip_unused_shards (это связано с тем, что в будущем данная настройка может быть включена по умолчанию, и она будет корректно работать, только если данные были вставлены через distributed таблицу, то есть распределены в соответствии с sharding_key).
optimize_dry_run_check_part
OPTIMIZE ... DRY RUN проверяет итоговую слитую часть с помощью checkDataPart. Если проверка не проходит, генерируется исключение.
optimize_empty_string_comparisons
(A AND B) OR (A AND C) можно переписать как A AND (B OR C), что может помочь задействовать:
- индексы в простых выражениях фильтрации
- оптимизацию преобразования CROSS JOIN в INNER JOIN
optimize_functions_to_subcolumns
- 0 — Оптимизация отключена.
- 1 — Оптимизация включена.
optimize_group_by_constant_keys
optimize_group_by_function_keys
optimize_if_chain_to_multiif
optimize_injective_functions_in_group_by
optimize_injective_functions_inside_uniq
optimize_inverse_dictionary_lookup
optimize_min_equality_disjunction_chain_length
expr = x1 OR ... expr = xN для оптимизаци
optimize_min_inequality_conjunction_chain_length
expr <> x1 AND ... expr <> xN для оптимизаци
optimize_move_to_prewhere
- 0 — автоматическая оптимизация
PREWHERE отключена.
- 1 — автоматическая оптимизация
PREWHERE включена.
optimize_move_to_prewhere_if_final
- 0 — Автоматическая оптимизация
PREWHERE в запросах SELECT с модификатором FINAL отключена.
- 1 — Автоматическая оптимизация
PREWHERE в запросах SELECT с модификатором FINAL включена.
См. также
Заменяет ‘multiIf’ с одним условием на ‘if’.
optimize_normalize_count_variants
- 0 — Отключено.
- 1 — Включено.
Пример
Разница между включенным и отключенным режимами:
Запрос:
SET optimize_on_insert = 1;
CREATE TABLE test1 (`FirstTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY FirstTable;
INSERT INTO test1 SELECT number % 2 FROM numbers(5);
SELECT * FROM test1;
SET optimize_on_insert = 0;
CREATE TABLE test2 (`SecondTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY SecondTable;
INSERT INTO test2 SELECT number % 2 FROM numbers(5);
SELECT * FROM test2;
┌─FirstTable─┐
│ 0 │
│ 1 │
└────────────┘
┌─SecondTable─┐
│ 0 │
│ 0 │
│ 0 │
│ 1 │
│ 1 │
└─────────────┘
optimize_qbit_distance_function_reads
QBit на эквивалентные, которые считывают из хранилища только столбцы, необходимые для вычисления.
Включает оптимизацию ORDER BY в запросах SELECT при чтении данных из таблиц MergeTree.
Возможные значения:
- 0 — оптимизация
ORDER BY отключена.
- 1 — оптимизация
ORDER BY включена.
См. также
optimize_redundant_functions_in_order_by
optimize_rewrite_aggregate_function_with_if
if, если они логически эквивалентны.
Например, avg(if(cond, col, null)) можно переписать как avgOrNullIf(cond, col). Это может повысить производительность.
Поддерживается только при использовании анализатора (enable_analyzer = 1).
optimize_rewrite_array_exists_to_has
optimize_rewrite_like_perfect_affix
col LIKE 'ClickHouse%') в вызовы функций startsWith или endsWith (например, startsWith(col, 'ClickHouse')).
optimize_rewrite_regexp_functions
optimize_rewrite_sum_if_to_count_if
optimize_skip_merged_partitions
level > 0 и срок TTL для неё не истёк.
OPTIMIZE TABLE ... FINAL SETTINGS optimize_skip_merged_partitions=1
По умолчанию запрос OPTIMIZE TABLE ... FINAL переписывает эту часть, даже если она единственная.
Возможные значения:
- 1 - Включить оптимизацию.
- 0 - Отключить оптимизацию.
optimize_skip_unused_shards
WHERE/PREWHERE, а также активирует связанные оптимизации для распределённых запросов (например, агрегацию по ключу сегментирования).
Предполагается, что данные распределены по ключу сегментирования, иначе запрос вернёт некорректный результат.
- 0 — Отключено.
- 1 — Включено.
optimize_skip_unused_shards_limit
optimize_skip_unused_shards отключается.
Слишком большое количество значений может потребовать значительных ресурсов на обработку, при этом польза от этого сомнительна, поскольку, если в IN (...) у вас очень много значений, то, скорее всего, запрос всё равно будет отправлен во все сегменты.
optimize_skip_unused_shards_nesting
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
IN в запросе для удалённых сегментов, чтобы исключить значения, которые не относятся к сегменту (требуется optimize_skip_unused_shards).
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Оптимизирует сортировку с учетом свойств сортировки входного потока
optimize_substitute_columns
false.
Возможные значения:
optimize_syntax_fuse_functions
- 0 — Функции с одинаковым аргументом не объединяются.
- 1 — Функции с одинаковым аргументом объединяются.
Пример
Запрос:
CREATE TABLE fuse_tbl(a Int8, b Int8) Engine = Log;
SET optimize_syntax_fuse_functions = 1;
EXPLAIN SYNTAX run_query_tree_passes = 1 SELECT sum(a), sum(b), count(b), avg(b) from fuse_tbl FORMAT TSV;
SELECT
sum(__table1.a) AS `sum(a)`,
tupleElement(sumCount(__table1.b), 1) AS `sum(b)`,
tupleElement(sumCount(__table1.b), 2) AS `count(b)`,
divide(tupleElement(sumCount(__table1.b), 1), toFloat64(tupleElement(sumCount(__table1.b), 2))) AS `avg(b)`
FROM default.fuse_tbl AS __table1
OPTIMIZE успешно завершается, даже если фактически ничего не сделал. Этот параметр позволяет различать такие ситуации и получать причину в сообщении об исключении.
Возможные значения:
- 1 — генерация исключения включена.
- 0 — генерация исключения отключена.
optimize_time_filter_with_preimage
toYear(col) = 2023 -> col >= '2023-01-01' AND col <= '2023-12-31')
optimize_trivial_approximate_count_query
- 0 — Оптимизация отключена.
- 1 — Оптимизация включена.
optimize_trivial_count_query
SELECT count() FROM table с использованием метаданных MergeTree. Если вам требуется безопасность на уровне строк, отключите эту настройку.
Возможные значения:
- 0 — оптимизация отключена.
- 1 — оптимизация включена.
См. также:
optimize_trivial_group_by_limit_query
SELECT key_expr FROM table GROUP BY key_expr LIMIT n (без агрегатных функций в списке SELECT, без секций HAVING/ORDER BY/LIMIT BY/window и без модификаторов GROUP BY) за счет установки max_rows_to_group_by = n + offset и group_by_overflow_mode = 'any'. Агрегация останавливается, как только будет получено n + offset различных ключей.
Оптимизация не применяется, если пользователь явно установил для group_by_overflow_mode значение, отличное от any (чтобы сохранить явно заданную семантику throw/break), а также если пользователь уже задал более жесткое значение max_rows_to_group_by (в этом случае оптимизация ничего не меняет).
Возможные значения:
- 0 — Оптимизация отключена.
- 1 — Оптимизация включена.
optimize_trivial_insert_select
optimize_truncate_order_by_after_group_by_keys
uniq и его варианты (кроме uniqUpTo) в count, если подзапрос содержит DISTINCT или секцию GROUP BY.
optimize_use_implicit_projections
optimize_use_projection_filtering
allow_experimental_projection_optimization
Включает или отключает оптимизацию проекций при выполнении запросов SELECT.
Возможные значения:
- 0 — оптимизация проекций отключена.
- 1 — оптимизация проекций включена.
optimize_using_constraints
false.
Возможные значения:
os_threads_nice_value_materialized_view
os_threads_nice_value_query
os_thread_priority
Значение nice в Linux для потоков обработки запросов. Чем меньше значение, тем выше приоритет CPU.
Требуется capability CAP_SYS_NICE, иначе настройка не имеет эффекта.
Возможные значения: от -20 до 19.
Размер блоков файла, сохраняемых в кэше страниц в пространстве пользователя, в байтах. Все чтения, проходящие через кэш, округляются вверх до значения, кратного этому размеру.
Этот параметр можно настраивать на уровне отдельного запроса, но записи в кэше с разными размерами блоков нельзя использовать повторно. Изменение этого параметра фактически делает существующие записи в кэше недействительными.
Большее значение, например 1 MiB, хорошо подходит для запросов с высокой пропускной способностью, а меньшее, например 64 KiB, — для точечных запросов с низкой задержкой.
page_cache_inject_eviction
page_cache_lookahead_blocks
page_cache_max_coalesced_bytes
readBigAt заполняет кэш страниц в пространстве пользователя, последовательные промахи кэша объединяются в одно чтение из нижележащего хранилища. Эта настройка ограничивает размер одного такого объединённого чтения в байтах; более длинные последовательности промахов разбиваются на несколько чтений. Она ограничивает пиковое кратковременное использование памяти временным буфером при параллельных холодных чтениях.
Большее значение уменьшает число HTTP-запросов при холодном сканировании Объектного хранилища; меньшее — снижает пиковое кратковременное использование памяти.
paimon_target_snapshot_id
parallel_distributed_insert_select
INSERT ... SELECT.
Если выполняется запрос INSERT INTO distributed_table_a SELECT ... FROM distributed_table_b, обе таблицы используют один и тот же кластер, и обе таблицы либо реплицируемые, либо нереплицируемые, то такой запрос обрабатывается локально на каждом сегменте.
Возможные значения:
0 — Отключено.1 — SELECT будет выполняться на каждом сегменте из базовой таблицы движка Distributed.2 — SELECT и INSERT будут выполняться на каждом сегменте из/в базовую таблицу движка Distributed.
Начиная с v25.4, INSERT ... SELECT из источника ReplicatedMergeTree или SharedMergeTree также можно распараллелить между репликами. Чтобы включить это:
parallel_distributed_insert_select = 2enable_parallel_replicas = 1
parallel_hash_join_threshold
hash и parallel_hash (только если доступна оценка размера правой таблицы).
Первый используется, когда известно, что размер правой таблицы меньше порога.
parallel_non_joined_rows_processing
parallel_hash с большими таблицами.
Если настройка отключена, такие строки обрабатываются одним потоком.
Это внутренний параметр, который не следует использовать напрямую: он отражает детали реализации режима «параллельных реплик». Этот параметр автоматически устанавливается сервером-инициатором для распределённых запросов и содержит индекс реплики, участвующей в обработке запроса среди параллельных реплик.
parallel_replicas_allow_in_with_subquery
parallel_replicas_allow_materialized_views
parallel_replicas_allow_view_over_mergetree
MergeTree (вместо внутреннего запроса представления), что улучшает распараллеливание между узлами. Также применяется к представлениям UNION ALL, все ветви которых читают из разных таблиц MergeTree.
parallel_replicas_connect_timeout_ms
parallel_replicas_custom_key
SAMPLE: будут использоваться несколько реплик каждого сегмента.
parallel_replicas_custom_key_range_lower
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
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_filter_pushdown
parallel_replicas_for_cluster_engines
parallel_replicas_for_non_replicated_merge_tree
parallel_replicas_index_analysis_only_on_coordinator
parallel_replicas_insert_select_local_pipeline
parallel_replicas_local_plan
parallel_replicas_mark_segment_size
parallel_replicas_min_number_of_rows_per_replica
parallel_replicas_only_with_analyzer
parallel_replicas_prefer_local_join
parallel_replicas_prefer_local_replica
max_parallel_replicas = 1 на другой хост, что может улучшить локальность кэша, когда множество коротких запросов распределено по кластеру.
parallel_replicas_support_projection
parallelize_output_from_storages
parsedatetime_e_requires_space_padding
parsedatetime_parse_without_leading_zeros
%c, %l и %k в функции parseDateTime позволяют разбирать месяцы и часы без ведущих нулей.
partial_merge_join_left_table_buffer_bytes
partial_merge_join_rows_in_right_blocks
- Разбивает данные правой части JOIN на блоки, содержащие не более указанного числа строк.
- Индексирует каждый блок по минимальному и максимальному значениям.
- Выгружает подготовленные блоки на диск, если это возможно.
Возможные значения:
- Любое положительное целое число. Рекомендуемый диапазон значений: [1000, 100000].
partial_result_on_first_cancel
postgresql_connection_attempt_timeout
connect_timeout в URL подключения.
postgresql_connection_pool_auto_close_connection
postgresql_connection_pool_retries
postgresql_connection_pool_size
postgresql_connection_pool_wait_timeout
postgresql_fault_injection_probability
predicate_statistics_sample_rate
system.predicate_statistics_log. Если задано значение N > 0, в выборку попадает примерно 1/N запросов (по Query id). Значение 0 отключает сбор.
prefer_column_name_to_alias
- 0 — Имя столбца заменяется псевдонимом.
- 1 — Имя столбца не заменяется псевдонимом.
Пример
Разница при включённом и выключенном параметре:
Запрос:
SET prefer_column_name_to_alias = 0;
SELECT avg(number) AS number, max(number) FROM numbers(10);
Received exception from server (version 21.5.1):
Code: 184. DB::Exception: Received from localhost:9000. DB::Exception: Aggregate function avg(number) is found inside another aggregate function in query: While processing avg(number) AS number.
SET prefer_column_name_to_alias = 1;
SELECT avg(number) AS number, max(number) FROM numbers(10);
┌─number─┬─max(number)─┐
│ 4.5 │ 9 │
└────────┴─────────────┘
prefer_external_sort_block_bytes
prefer_global_in_and_join
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 может изменить поведение запросов для distributed таблиц, он не подходит для локальных таблиц или таблиц из внешних источников. Именно для таких случаев предназначена настройка prefer_global_in_and_join.
Например, есть узлы, обслуживающие запросы и содержащие локальные таблицы, которые не подходят для распределения. В этом случае их данные нужно распределять на лету в рамках распределённой обработки с помощью ключевого слова GLOBAL — GLOBAL IN/GLOBAL JOIN.
Ещё один сценарий использования prefer_global_in_and_join — доступ к таблицам, созданным внешними движками. Эта настройка помогает сократить количество обращений к внешним источникам при JOIN таких таблиц: только один вызов на запрос.
См. также:
Включает или отключает предпочтительное использование реплики localhost при обработке распределённых запросов.
Возможные значения:
- 1 — ClickHouse всегда отправляет запрос на реплику localhost, если она существует.
- 0 — ClickHouse использует стратегию балансировки, заданную настройкой load_balancing.
Отключите эту настройку, если используете max_parallel_replicas без parallel_replicas_custom_key.
Если задан parallel_replicas_custom_key, отключайте эту настройку только в том случае, если она используется в кластере с несколькими сегментами, содержащими несколько реплик.
Если она используется в кластере с одним сегментом и несколькими репликами, отключение этой настройки приведёт к негативным последствиям. prefer_warmed_unmerged_parts_seconds
preferred_block_size_bytes
max_block_size. Если столбцы большие и при max_block_size строк размер блока, скорее всего, превысит указанное количество байт, размер блока будет уменьшен для лучшей локальности кэша процессора.
preferred_max_column_in_block_size_bytes
preferred_optimize_projection_name
- string: имя предпочтительной проекции
Максимальный размер буфера предзагрузки при чтении из файловой системы.
Позволяет выводить имена глубоко вложенных типов в удобочитаемом виде с отступами в запросе DESCRIBE и функции toTypeName().
Пример:
CREATE TABLE test (a Tuple(b String, c Tuple(d Nullable(UInt64), e Array(UInt32), f Array(Tuple(g String, h Map(String, Array(Tuple(i String, j UInt64))))), k Date), l Nullable(String))) ENGINE=Memory;
DESCRIBE TABLE test FORMAT TSVRaw SETTINGS print_pretty_type_names=1;
a Tuple(
b String,
c Tuple(
d Nullable(UInt64),
e Array(UInt32),
f Array(Tuple(
g String,
h Map(
String,
Array(Tuple(
i String,
j UInt64
))
)
)),
k Date
),
l Nullable(String)
)
evaluation_time
Задаёт время оценки для диалекта promql. auto означает текущее время.
Указывает имя таблицы TimeSeries, используемой в диалекте ‘promql’.
push_external_roles_in_interserver_queries
query_cache_compress_entries
- 0 - Отключено
- 1 - Включено
query_cache_for_subqueries
use_query_cache на все подзапросы.
Возможные значения:
- 0 - Отключено
- 1 - Включено
Максимальное количество результатов запросов, которое текущий пользователь может хранить в кэше запросов. 0 означает отсутствие ограничений.
Возможные значения:
query_cache_max_size_in_bytes
query_cache_min_query_duration
- Положительное целое число >= 0.
query_cache_min_query_runs
SELECT-запроса, после которого его результат сохраняется в кэше запросов.
Возможные значения:
query_cache_nondeterministic_function_handling
SELECT с недетерминированными функциями, такими как rand() или now().
Возможные значения:
'throw' — сгенерировать исключение и не кэшировать результат запроса.'save' — кэшировать результат запроса.'ignore' — не кэшировать результат запроса и не генерировать исключение.
query_cache_share_between_users
SELECT-запросов, кэшированные в query cache.
Не рекомендуется включать этот параметр из соображений безопасности.
Возможные значения:
- 0 - Отключено
- 1 - Включено
query_cache_squash_partial_results
- 0 - Отключено
- 1 - Включено
query_cache_system_table_handling
SELECT к системным таблицам, то есть к таблицам в базах данных system.* и information_schema.*.
Возможные значения:
'throw' - сгенерировать исключение и не кэшировать результат запроса.'save' - кэшировать результат запроса.'ignore' - не кэшировать результат запроса и не генерировать исключение.
Строка, которая служит меткой для записей query cache.
Одинаковые запросы с разными метками считаются в query cache разными.
Возможные значения:
По истечении этого времени, заданного в секундах, записи в кэше запросов считаются устаревшими.
Возможные значения:
- Положительное целое число >= 0.
query_metric_log_interval
collect_interval_milliseconds из настройки query_metric_log, а если оно отсутствует, по умолчанию используется 1000.
Чтобы отключить сбор метрик для отдельного запроса, установите query_metric_log_interval в 0.
Значение по умолчанию: -1
query_plan_aggregation_in_order
query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем настройка может измениться обратно несовместимым образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_convert_any_join_to_semi_or_anti_join
query_plan_convert_join_to_in
JOIN в подзапрос с IN, если выходные столбцы относятся только к левой таблице. Может приводить к неверным результатам для JOIN, отличных от ANY (например, ALL JOIN, который используется по умолчанию).
query_plan_convert_outer_join_to_inner_join
OUTER JOIN в INNER JOIN, если фильтр после JOIN всегда исключает значения по умолчанию
query_plan_direct_read_from_text_index
query_plan_display_internal_aliases
query_plan_enable_multithreading_after_window_functions
query_plan_enable_optimizations
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться обратно несовместимым образом или быть удалена.
- 0 - Отключить все оптимизации на уровне плана запроса
- 1 - Включить оптимизации на уровне плана запроса (при этом отдельные оптимизации всё равно могут быть отключены через их собственные настройки)
query_plan_execute_functions_after_sorting
query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться с нарушением обратной совместимости или быть удалена.
- 0 - Отключено
- 1 - Включено
query_plan_filter_push_down
Это экспертная настройка, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_join_shard_by_pk_ranges
query_plan_join_swap_table
ALL с условием JOIN ON. Возможные значения:
- ‘auto’: Позволяет planner определить, какую таблицу использовать в качестве build-таблицы.
- ‘false’: Никогда не менять таблицы местами (build-таблица — правая таблица).
- ‘true’: Всегда менять таблицы местами (build-таблица — левая таблица).
query_plan_lift_up_array_join
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
Включает или отключает оптимизацию на уровне плана запроса, которая переносит более крупные поддеревья плана запроса в union, чтобы открыть возможности для дальнейших оптимизаций.
Действует только в том случае, если значение настройки query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться обратно несовместимым образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_max_limit_for_lazy_materialization
query_plan_max_limit_for_top_k_optimization
query_plan_max_optimizations_to_apply
Это настройка экспертного уровня, и использовать её для отладки следует только разработчикам. В будущем настройка может измениться несовместимым с предыдущими версиями образом или быть удалена.
query_plan_max_step_description_length
query_plan_merge_expressions
Это экспертная настройка, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_merge_filter_into_join_condition
JOIN и преобразовывать CROSS JOIN в INNER.
Разрешает объединять фильтры в плане запроса.
query_plan_optimize_join_order_algorithm
- ‘greedy’ — базовый жадный алгоритм: работает быстро, но может не обеспечить наилучший порядок JOIN
- ‘dpsize’ — реализует алгоритм DPsize, в настоящее время только для Inner JOIN, — перебирает все возможные порядки JOIN и находит оптимальный, но может работать медленно для запросов с большим количеством таблиц и предикатов JOIN.
Можно указать несколько алгоритмов, например ‘dpsize,greedy’.
query_plan_optimize_join_order_limit
query_plan_optimize_join_order_randomize
query_plan_optimize_lazy_final
query_plan_optimize_lazy_materialization
query_plan_optimize_prewhere
query_plan_push_down_limit
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем настройка может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
Включает или отключает оптимизацию чтения в порядке сортировки на уровне плана запроса.
Действует только если значение настройки query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_read_in_order_through_join
query_plan_remove_redundant_distinct
query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться обратно несовместимым образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_remove_redundant_sorting
query_plan_enable_optimizations равно 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_remove_unused_columns
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем эта настройка может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_plan_reuse_storage_ordering_for_window_functions
optimize_read_in_window_order
Включает или отключает оптимизацию на уровне плана запроса, которая использует порядок сортировки в хранилище при сортировке для оконных функций.
Имеет эффект только при значении 1 для настройки query_plan_enable_optimizations.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем эта настройка может измениться обратно несовместимым образом или быть удалена.
- 0 - Отключено
- 1 - Включено
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключено
- 1 - Включено
query_plan_text_index_add_hint
query_plan_top_k_through_join
ORDER BY ... LIMIT n через JOIN, если ключ сортировки ссылается только на столбцы сохраняемой стороны JOIN (LEFT/RIGHT). Ограничивает количество строк, которое должен вернуть вход сохраняемой стороны до выполнения JOIN.
Действует только при значении 1 для настройки query_plan_enable_optimizations.
Возможные значения:
- 0 - Отключить
- 1 - Включить
query_plan_try_use_vector_search
query_plan_enable_optimizations установлено значение 1.
Это настройка экспертного уровня, которую разработчикам следует использовать только для отладки. В будущем она может измениться несовместимым с предыдущими версиями образом или быть удалена.
- 0 - Отключить
- 1 - Включить
query_profiler_cpu_time_period_ns
-
Положительное целое число наносекунд.
Рекомендуемые значения:
- 10000000 (100 раз в секунду) наносекунд и более для отдельных запросов.
- 1000000000 (один раз в секунду) для профилирования в масштабе всего cluster.
-
0, чтобы отключить таймер.
См. также:
query_profiler_real_time_period_ns
-
Положительное целое число в наносекундах.
Рекомендуемые значения:
- 10000000 (100 раз в секунду) наносекунд и меньше для отдельных запросов.
- 1000000000 (один раз в секунду) для профилирования всего кластера.
-
0 для отключения таймера.
См. также:
Значение по умолчанию в Cloud: 3000000000.
Время ожидания в очереди запросов, если число одновременных запросов превышает максимально допустимое.
Время ожидания при чтении из RabbitMQ перед повторной попыткой.
read_backoff_max_throughput
read_backoff_min_concurrency
read_backoff_min_interval_between_events_ms
read_backoff_min_latency_ms
read_from_distributed_cache_if_exists_otherwise_bypass_cache
read_from_filesystem_cache_if_exists_otherwise_bypass_cache
read_from_page_cache_if_exists_otherwise_bypass_cache
read_in_order_two_level_merge_threshold
read_in_order_use_buffering
read_in_order_use_virtual_row
read_in_order_use_virtual_row_per_block
read_in_order_use_virtual_row, после чтения каждого блока выдается виртуальная строка (а не только в начале каждой части).
Это позволяет MergingSortedTransform чаще переприоритизировать источники, что полезно, когда последующие фильтры отбрасывают много строк, а данные распределены по частям неравномерно.
Обратите внимание, что при этом отключается оптимизация read_in_order_use_buffering и предварительное слияние (read_in_order_two_level_merge_threshold) при чтении.
Что делать, если лимит превышен.
Задаёт, что происходит, когда объём прочитанных данных превышает одно из leaf-ограничений.
Возможные варианты:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат.
Приоритет чтения данных из локальной или удалённой файловой системы. Поддерживается только для метода ‘pread_threadpool’ при работе с локальной файловой системой и для метода threadpool — с удалённой файловой системой.
read_through_distributed_cache
send_timeout.
recursive_cte_max_steps_in_type_inference
getLeastSupertype к нерекурсивной и рекурсивной частям UNION ALL до достижения сходимости. Установите значение 0, чтобы отключить расширение типов и использовать только типы из нерекурсивной части.
regexp_dict_allow_hyperscan
regexp_dict_flag_case_insensitive
regexp_max_matches_per_row
- Положительное целое число.
reject_expensive_hyperscan_regexps
remerge_sort_lowered_memory_bytes_ratio
remote_filesystem_read_method
remote_filesystem_read_prefetch
remote_fs_read_backoff_max_tries
remote_fs_read_max_backoff_ms
remote_read_min_bytes_for_seek
rename_files_after_processing
-
Тип: String
-
Значение по умолчанию: Пустая строка
Этот параметр позволяет указать шаблон переименования для файлов, обработанных табличной функцией 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
При использовании HTTP interface можно передать параметр ‘query_id’. Это может быть любая строка, служащая идентификатором запроса.
Если в этот момент уже существует запрос от того же пользователя с тем же ‘query_id’, поведение зависит от параметра ‘replace_running_query’.
0 (по умолчанию) – сгенерировать исключение (не разрешать выполнение запроса, если запрос с тем же ‘query_id’ уже выполняется).
1 – отменить старый запрос и запустить новый.
Установите значение этого параметра равным 1, чтобы реализовать подсказки для условий сегментации. После ввода следующего символа, если старый запрос ещё не завершился, его следует отменить.
replace_running_query_max_wait_ms
query_id, когда активна настройка replace_running_query.
Возможные значения:
- Положительное целое число.
- 0 — генерировать исключение и не запускать новый запрос, если сервер уже выполняет запрос с тем же
query_id.
replication_wait_for_inactive_replica_timeout
ALTER, OPTIMIZE или TRUNCATE.
Возможные значения:
0 — Не ждать.- Отрицательное целое число — Ждать неограниченно долго.
- Положительное целое число — Количество секунд ожидания.
restore_replace_external_dictionary_source_to_null
restore_replace_external_engines_to_null
restore_replace_external_table_functions_to_null
restore_replicated_merge_tree_to_shared_merge_tree
1.
Значение по умолчанию в Cloud: throw
Определяет, что делать, если объём результата превышает одно из ограничений.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные закончились.
Использование ‘break’ похоже на использование LIMIT. Break прерывает выполнение только на
уровне блока. Это означает, что количество возвращаемых строк будет больше, чем
max_result_rows, будет кратно max_block_size
и будет зависеть от max_threads.
Пример
SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';
SELECT *
FROM numbers_mt(100000)
FORMAT Null;
rewrite_count_distinct_if_with_count_distinct_implementation
countDistcintIf в соответствии с настройкой count_distinct_implementation.
Возможные значения:
- true — Разрешить.
- false — Запретить.
Переписывает выражения вида ‘x IN subquery’ в JOIN. Это может быть полезно для оптимизации всего запроса за счёт переупорядочивания JOIN.
Если включено, ClickHouse будет предоставлять точное значение статистики rows_before_aggregation, которая показывает количество строк, прочитанных до агрегаци
Разрешает многочастное копирование в S3.
s3_allow_parallel_part_upload
s3_check_objects_after_upload
s3_create_new_file_on_insert
data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz и т. д.
Возможные значения:
- 0 — запрос
INSERT создаёт новый файл или завершается ошибкой, если файл уже существует и s3_truncate_on_insert не задан.
- 1 — запрос
INSERT создаёт новый файл при каждой вставке, используя суффикс (начиная со второй вставки), если s3_truncate_on_insert не задан.
Подробнее см. здесь.
Не вычислять контрольную сумму при отправке файла в S3. Это ускоряет запись, поскольку позволяет избежать лишних проходов обработки файла. В большинстве случаев это безопасно, поскольку данные таблиц MergeTree в любом случае защищены контрольными суммами на стороне ClickHouse, а при доступе к S3 по HTTPS уровень TLS уже обеспечивает целостность данных при передаче по сети. При этом дополнительные контрольные суммы в S3 обеспечивают многоуровневую защиту.
s3_ignore_file_doesnt_exist
- 1 —
SELECT возвращает пустой результат.
- 0 —
SELECT генерирует исключение.
Максимальное количество файлов, которое может быть возвращено одним батчем по запросу ListObject
Максимальное количество соединений на сервер.
Максимальное число запросов, которые можно отправить одновременно до достижения лимита запросов в секунду. По умолчанию (0) равно s3_max_get_rps
Ограничение на частоту S3 GET-запросов в секунду до применения ограничения скорости. Ноль означает отсутствие ограничений.
s3_max_inflight_parts_for_one_file
s3_max_put_rps
Ограничение на число S3 PUT-запросов в секунду до начала throttling. Ноль означает отсутствие ограничений.
s3_max_single_operation_copy_size
s3_max_single_part_upload_size
s3_max_single_read_retries
s3_max_unexpected_write_error_retries
_path, которые можно извлечь из фильтров запроса и использовать для перебора файлов
вместо листинга по glob-шаблону. 0 означает, что параметр отключён.
Тайм-аут бездействия при отправке и получении данных в/из S3. Операция завершается ошибкой, если один вызов TCP-чтения или записи блокируется на это время.
Включает или отключает пропуск пустых файлов в таблицах движка S3.
Возможные значения:
- 0 —
SELECT генерирует исключение, если пустой файл несовместим с запрошенным форматом.
- 1 —
SELECT возвращает пустой результат для пустого файла.
s3_slow_all_threads_after_network_error
true, все потоки, выполняющие запросы S3 к одной и той же конечной точке резервного копирования, замедляются
после того, как любой отдельный запрос S3 сталкивается с сетевой ошибкой, допускающей повторную попытку, например тайм-аутом сокета.
Если установлено значение false, каждый поток обрабатывает задержку запросов S3 независимо от остальных.
s3_strict_upload_part_size
s3_throw_on_zero_files_match
- 0 — запрос
INSERT создаёт новый файл или завершается ошибкой, если файл уже существует и параметр s3_create_new_file_on_insert не задан.
- 1 — запрос
INSERT заменяет существующее содержимое файла новыми данными.
Подробнее см. здесь.
s3_upload_part_size_multiply_factor
s3_upload_part_size_multiply_parts_count_threshold
true, то для всех запросов к S3 первые две попытки выполняются с короткими тайм-аутами отправки и получения.
Если установлено значение false, то все попытки выполняются с одинаковыми тайм-аутами.
s3_validate_request_settings
- 1 — проверять настройки.
- 0 — не проверять настройки.
s3queue_default_zookeeper_path
s3queue_enable_logging_to_s3queue_log
s3queue_keeper_fault_injection_probability
schema_inference_cache_require_modification_time_for_url
schema_inference_use_cache_for_azure
schema_inference_use_cache_for_file
schema_inference_use_cache_for_hdfs
schema_inference_use_cache_for_s3
schema_inference_use_cache_for_url
secondary_indices_enable_bulk_filtering
select_sequential_consistency
Поведение этой настройки различается в SharedMergeTree и ReplicatedMergeTree. Подробнее о поведении select_sequential_consistency в SharedMergeTree см. в разделе SharedMergeTree consistency. SELECT. Требует, чтобы insert_quorum_parallel был отключен (по умолчанию он включен).
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Использование
Когда последовательная согласованность включена, ClickHouse позволяет клиенту выполнять запрос SELECT только к тем репликам, которые содержат данные из всех предыдущих запросов INSERT, выполненных с insert_quorum. Если клиент обращается к неполной реплике, ClickHouse сгенерирует исключение. Запрос SELECT не будет включать данные, которые еще не записаны в кворум реплик.
Когда insert_quorum_parallel включен (по умолчанию), select_sequential_consistency не работает. Это связано с тем, что параллельные запросы INSERT могут записываться в разные наборы реплик, образующих кворум, поэтому нет гарантии, что какая-либо одна реплика получит все записи.
См. также:
Отправляет клиенту текстовые журналы сервера с указанным минимальным уровнем. Допустимые значения: ‘trace’, ‘debug’, ‘information’, ‘warning’, ‘error’, ‘fatal’, ‘none’
Отправлять текстовые журналы сервера, имя источника которых соответствует указанному регулярному выражению. Пустое значение означает все источники.
Включает или отключает отправку клиенту пакетов ProfileEvents.
Этот параметр можно отключить, чтобы уменьшить сетевой трафик для клиентов, которым события профилирования не нужны.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Включает или отключает HTTP-заголовки ответа X-ClickHouse-Progress в ответах clickhouse-server.
Дополнительную информацию см. в описании HTTP interface.
Possible values:
- 0 — Отключено.
- 1 — Включено.
send_table_structure_on_insert_with_inline_data
receive_timeout.
Сериализация плана запроса для распределённой обработки
serialize_string_in_memory_with_zero_byte
timeZone() и serverTimeZone().
Возможные значения:
- Любое имя часового пояса из
system.time_zones, например Europe/Berlin, UTC или Zulu
Примеры:
SELECT timeZone(), serverTimeZone() FORMAT CSV
"Europe/Berlin","Europe/Berlin"
SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV
"Asia/Novosibirsk","Europe/Berlin"
SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
1999-12-13 07:23:23.123
Не все функции, которые разбирают DateTime/DateTime64, учитывают session_timezone. Это может приводить к трудноуловимым ошибкам.
См. пример и пояснение ниже.
CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');
SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
0 rows in set.
SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
┌───────────────────d─┬─timeZone()───────┐
│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
└─────────────────────┴──────────────────┘
toDateTime() без явно указанного часового пояса, используемая в первом запросе SELECT, учитывает настройку session_timezone и глобальный часовой пояс.- Во втором запросе значение DateTime разбирается из String и наследует тип и часовой пояс существующего столбца
d. Поэтому настройка session_timezone и глобальный часовой пояс не учитываются.
См. также
Определяет, что произойдёт, если объём данных превысит один из лимитов.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные закончились.
shared_merge_tree_sequential_consistency_initial_parts_update_backoff_ms
select_sequential_consistency с SharedMergeTree. Доступно только в ClickHouse Cloud.
shared_merge_tree_sequential_consistency_max_parts_update_backoff_ms
select_sequential_consistency с SharedMergeTree. Доступно только в ClickHouse Cloud.
shared_merge_tree_sequential_consistency_parts_update_max_retries
select_sequential_consistency с SharedMergeTree. Доступно только в ClickHouse Cloud.
shared_merge_tree_sync_parts_on_partition_operations
short_circuit_function_evaluation
enable — Включает вычисление функций с коротким замыканием для функций, к которым оно применимо (которые могут сгенерировать исключение или требуют больших вычислительных затрат).force_enable — Включает вычисление функций с коротким замыканием для всех функций.disable — Отключает вычисление функций с коротким замыканием.
short_circuit_function_evaluation_for_nulls
short_circuit_function_evaluation_for_nulls_threshold
show_data_lake_catalogs_in_system_tables
show_processlist_include_internal
SHOW PROCESSLIST.
К внутренним процессам относятся перезагрузка словарей, перезагрузка refreshable materialized view, вспомогательные SELECT, выполняемые в запросах SHOW ..., вспомогательные запросы CREATE DATABASE ..., которые выполняются внутри системы для обработки повреждённых таблиц, и многое другое.
show_table_uuid_in_table_create_query_if_not_nil
SHOW TABLE.
Возможные значения:
- 0 — запрос отображается без UUID таблицы.
- 1 — запрос отображается с UUID таблицы.
single_join_prefer_left_table
skip_redundant_aliases_in_udf
- 1 — Псевдонимы пропускаются (подставляются) в UDF.
- 0 — Псевдонимы не пропускаются (не подставляются) в UDF.
Пример
Разница между включенным и отключенным состоянием:
Запрос:
SET skip_redundant_aliases_in_udf = 0;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));
EXPLAIN SYNTAX SELECT test_03274(4 + 2);
SELECT ((4 + 2) + 1 AS y, y + 2)
SET skip_redundant_aliases_in_udf = 1;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));
EXPLAIN SYNTAX SELECT test_03274(4 + 2);
SELECT ((4 + 2) + 1, ((4 + 2) + 1) + 2)
-
ClickHouse не может подключиться к реплике по любой причине.
При подключении к реплике ClickHouse выполняет несколько попыток. Если все они завершаются неудачей, реплика считается недоступной.
-
Реплику не удается разрешить через DNS.
Если имя хоста реплики не удается разрешить через DNS, это может указывать на одну из следующих ситуаций:
-
У хоста реплики отсутствует DNS-запись. Это может происходить в системах с динамическим DNS, например, Kubernetes, где во время простоя узлы могут не разрешаться, и это не считается ошибкой.
-
Ошибка конфигурации. В файле конфигурации ClickHouse указано неверное имя хоста.
Возможные значения:
-
1 — пропуск включен.
Если сегмент недоступен, ClickHouse возвращает результат на основе частичных данных и не сообщает о проблемах с доступностью узлов.
-
0 — пропуск отключен.
Если сегмент недоступен, ClickHouse генерирует исключение.
sleep_after_receiving_query_ms
sleep_in_send_tables_status_ms
throw: сгенерировать исключение.break: остановить выполнение запроса и вернуть частичный результат.
split_intersecting_parts_ranges_into_layers_final
split_parts_ranges_into_intersecting_and_non_intersecting_final
splitby_max_substrings_includes_remaining_string
max_substrings > 0 включать оставшуюся часть строки в последний элемент результирующего массива.
Возможные значения:
0 - Оставшаяся часть строки не будет включена в последний элемент результирующего массива.1 - Оставшаяся часть строки будет включена в последний элемент результирующего массива. Это соответствует поведению функции split() в Spark и метода ‘string.split()’ в Python.
stop_refreshable_materialized_views_on_startup
SYSTEM START VIEWS или SYSTEM START VIEW <name>. Также применяется к вновь созданным представлениям. Не влияет на materialized view без обновления по расписанию.
Метод чтения данных из файла хранилища; одно из значений: read, pread, mmap. Метод mmap не используется в clickhouse-server (он предназначен для clickhouse-local).
storage_system_stack_trace_pipe_read_timeout_ms
system.stack_trace. Эта настройка используется только в целях тестирования и не предназначена для изменения пользователями.
Применяется к таблицам со стримингом при тайм-ауте или когда поток генерирует max_insert_block_size строк.
Значение по умолчанию — 7500.
Чем меньше значение, тем чаще данные записываются в таблицу. Слишком низкое значение приводит к снижению производительности.
stream_like_engine_allow_direct_select
stream_like_engine_insert_queue
system_events_show_zero_values
system.events.
Некоторые системы мониторинга требуют передавать им все значения метрик для каждой контрольной точки, даже если значение метрики равно нулю.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Примеры
Запрос
SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
SET system_events_show_zero_values = 1;
SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
┌─event────────────────────┬─value─┬─description───────────────────────────────────────────┐
│ QueryMemoryLimitExceeded │ 0 │ Number of times when memory limit exceeded for query. │
└──────────────────────────┴───────┴───────────────────────────────────────────────────────┘
system_metric_log_show_zero_values_in_histograms
histograms таблицы system.metric_log.
По умолчанию гистограммы, у которых общее число наблюдений count равно нулю, пропускаются, а в каждой записываемой гистограмме из map histogram также исключаются записи бакетов без наблюдений. Включите эту настройку, чтобы записывать каждую гистограмму и каждый бакет независимо от значения count — это полезно для систем мониторинга, которым требуется, чтобы каждая метрика присутствовала в каждой контрольной точке.
Возможные значения:
- 0 — Отключено. Гистограммы с
count = 0 не записываются; записанные гистограммы включают только те бакеты, в которые попало хотя бы одно наблюдение.
- 1 — Включено. Записываются все гистограммы, и в
histogram присутствует каждая граница бакета.
table_engine_read_through_distributed_cache
table_function_remote_max_addresses
- Положительное целое число.
Время в секундах, в течение которого соединение должно оставаться бездействующим, прежде чем TCP начнет отправлять keepalive-пакеты
temporary_data_in_cache_reserve_space_wait_lock_timeout_milliseconds
temporary_files_buffer_size
- LZ4 — применяется сжатие LZ4.
- NONE — сжатие не применяется.
text_index_hint_max_selectivity
text_index_like_max_postings_to_read
use_text_index_like_evaluation_by_dictionary_scan.
text_index_like_min_pattern_length
use_text_index_like_evaluation_by_dictionary_scan был включен.
throw_if_no_data_to_insert
clickhouse-client или gRPC-интерфейс.
throw_on_error_from_cache_on_write_operations
throw_on_max_partitions_per_insert_block
max_partitions_per_insert_block.
Возможные значения:
true - Когда блок вставки достигает max_partitions_per_insert_block, генерируется исключение.false - При достижении max_partitions_per_insert_block в журнал записывается предупреждение.
throw_on_unsupported_query_inside_transaction
timeout_before_checking_execution_speed
min_execution_speed), после истечения указанного времени в секундах.
Указывает, что делать, если запрос выполняется дольше max_execution_time или
оценочное время выполнения превышает max_estimated_execution_time.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные были исчерпаны.
timeout_overflow_mode_leaf
max_execution_time_leaf.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные были исчерпаны.
Порог для totals_mode = 'auto'.
См. раздел «Модификатор WITH TOTALS».
Как вычислять TOTALS при наличии HAVING, а также когда заданы max_rows_to_group_by и group_by_overflow_mode = ‘any’.
См. раздел “модификатор WITH TOTALS”.
Включает или отключает сбор трассировок стека при каждом обновлении profile events вместе с именем события профиля и значением приращения, а также отправку этих данных в trace_log.
Возможные значения:
- 1 — трассировка profile events включена.
- 0 — трассировка profile events отключена.
trace_profile_events_list
trace_profile_events включена, трассировка ограничивается указанным списком имен, разделенных запятыми.
Если trace_profile_events_list — пустая строка (по умолчанию), трассируются все profile events.
Пример значения: ‘DiskS3ReadMicroseconds,DiskS3ReadRequestsCount,SelectQueryTimeMicroseconds,ReadBufferFromS3Bytes’
Эта настройка позволяет точнее собирать данные для большого числа запросов, поскольку в противном случае огромный объем событий может переполнить очередь внутреннего системного журнала, и часть из них будет отброшена.
Определяет, что произойдёт, если объём данных превысит одно из ограничений.
Возможные значения:
throw: сгенерировать исключение (по умолчанию).break: остановить выполнение запроса и вернуть частичный результат, как если бы
исходные данные закончились.
Включает возможность считать значения NULL равными для оператора IN.
По умолчанию значения NULL нельзя сравнивать, поскольку NULL означает неопределённое значение. Поэтому сравнение expr = NULL всегда должно возвращать false. При включении этой настройки выражение NULL = NULL для оператора IN возвращает true.
Возможные значения:
- 0 — Сравнение значений
NULL в операторе IN возвращает false.
- 1 — Сравнение значений
NULL в операторе IN возвращает true.
Пример
Рассмотрим таблицу null_in:
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
│ 3 │ 3 │
└──────┴───────┘
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;
┌──idx─┬────i─┐
│ 1 │ 1 │
└──────┴──────┘
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
└──────┴───────┘
traverse_shadow_remote_data_paths
SELECT-запросов. Эта настройка используется только при работе с UNION, если явно не указаны UNION ALL или UNION DISTINCT.
Возможные значения:
'DISTINCT' — ClickHouse возвращает строки, полученные в результате объединения запросов, удаляя дублирующиеся строки.'ALL' — ClickHouse возвращает все строки, полученные в результате объединения запросов, включая дублирующиеся.'' — ClickHouse генерирует исключение при использовании с UNION.
См. примеры в разделе UNION.
unknown_packet_in_send_data
UPDATE.
Возможные значения:
sync - выполнять все запросы UPDATE последовательно.auto - выполнять последовательно только те запросы UPDATE, в которых есть зависимости между столбцами, обновляемыми в одном запросе, и столбцами, используемыми в выражениях другого запроса.async - не синхронизировать запросы UPDATE.
update_sequential_consistency
- URL, относительный к пути (например,
data.csv): объединяется с путём базового URL согласно RFC 3986. Всё после последнего / в базовом пути заменяется относительным URL, поэтому завершающий слеш имеет значение: https://example.com/dir/ + data.csv = https://example.com/dir/data.csv, а https://example.com/dir + data.csv = https://example.com/data.csv. Если у базового URL нет пути (например, https://example.com), вставляется /: https://example.com/data.csv. Сегменты (./ и ../) в относительном URL нормализуются: https://example.com/dir/ + ../a.csv = https://example.com/a.csv.
- URL, относительный к хосту (например,
/test/data.csv): разрешается относительно схемы и хоста базового URL.
- URL, относительный к схеме (например,
//other.com/test/data.csv): разрешается с использованием схемы базового URL.
- Ссылка, содержащая только строку запроса (например,
?x=1): добавляется к пути базового URL (заменяя существующие строку запроса и фрагмент).
- Ссылка, содержащая только фрагмент (например,
#frag): добавляется к базовому URL с сохранением строки запроса (заменяя существующий фрагмент).
- Пустая ссылка: возвращает базовый URL без фрагмента.
Например, если url_base имеет значение https://example.com/def/, то:
data.csv разрешается в https://example.com/def/data.csv/test/data.csv разрешается в https://example.com/test/data.csv//other.com/test/data.csv разрешается в https://other.com/test/data.csv
use_async_executor_for_materialized_views
use_cache_for_count_from_files
file/s3/url/hdfs/azureBlobStorage.
Включено по умолчанию.
Использовать часовой пояс клиента для интерпретации строковых значений DateTime вместо часового пояса сервера.
Использует компактный формат для хранения блоков при фоновой (distributed_foreground_insert) операции INSERT в таблицы с движком Distributed.
Возможные значения:
- 0 — Использует формат каталога
user[:password]@host:port#default_database.
- 1 — Использует формат каталога
[shard{shard_index}[_replica{replica_index}]].
- при
use_compact_format_in_distributed_parts_names=0 изменения в определении кластера не будут применяться к фоновой операции INSERT.
- при
use_compact_format_in_distributed_parts_names=1 изменение порядка узлов в определении кластера приведёт к изменению shard_index/replica_index, имейте это в виду.
concurrent_threads_soft_limit_num и concurrent_threads_soft_limit_ratio_to_cores). Если отключено, позволяет использовать большее число потоков даже при перегрузке сервера (не рекомендуется для обычного использования и в основном требуется для тестов).
Значение по умолчанию в Cloud: 0.
use_hash_table_stats_for_join_reordering
hedged_connection_timeout
или если в течение receive_data_timeout не были получены данные. Запрос использует первое соединение, которое отправляет непустой пакет Прогресс (или пакет данных, если allow_changing_replica_until_first_data_packet);
остальные соединения отменяются. Поддерживаются запросы с max_parallel_replicas > 1.
Включено по умолчанию.
Значение по умолчанию в Cloud: 0.
Когда настройка включена, ClickHouse определяет секционирование в стиле Hive в пути (/name=value/) в движках таблиц, работающих с файлами: File/S3/URL/HDFS/AzureBlobStorage, и позволяет использовать столбцы партиций как виртуальные столбцы в запросе. Эти виртуальные столбцы будут иметь те же имена, что и в пути секционирования, но с префиксом _.
Если параметр включен, табличная функция Iceberg и хранилище Iceberg могут использовать кэш файлов метаданных Iceberg.
Возможные значения:
- 0 - Отключено
- 1 - Включено
use_iceberg_partition_pruning
use_index_for_in_with_subqueries
use_index_for_in_with_subqueries_max_values
use_join_disjunctions_push_down
use_page_cache_for_disks_without_file_cache
use_page_cache_for_local_disks
local_filesystem_read_method = 'pread' или 'read'. Не отключает кэш страниц ОС; для этого можно использовать min_bytes_to_use_direct_io. Влияет только на обычные таблицы, но не на табличную функцию file() и не на движок таблицы File().
use_page_cache_for_object_storage
use_page_cache_with_distributed_cache
use_paimon_partition_pruning
- 0 - Отключено
- 1 - Включено
Псевдонимы: use_partition_key
Использовать ключ партиционирования для отсечения партиций при выполнении запроса в таблицах MergeTree.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Использовать первичный ключ для отсечения гранул при выполнении запроса в таблицах MergeTree.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Если включено, запросы SELECT могут использовать кэш запросов. Параметры enable_reads_from_query_cache
и enable_writes_to_query_cache более точно определяют, как используется кэш.
Возможные значения:
- 0 - Отключено
- 1 - Включено
use_query_condition_cache
WHERE,
и использует эту информацию как эфемерный индекс для последующих запросов.
Возможные значения:
- 0 - Отключено
- 1 - Включено
use_roaring_bitmap_iceberg_positional_deletes
- 0 — Отключено.
- 1 — Включено.
use_skip_indexes_for_disjunctions
- 0 — Отключено.
- 1 — Включено.
use_skip_indexes_for_top_k
ORDER BY <column> LIMIT n для столбца существует minmax-индекс пропуска данных, оптимизатор попытается использовать его, чтобы пропускать гранулы, не влияющие на итоговый результат. Это может снизить задержку запроса.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
use_skip_indexes_if_final
- 0 — Отключено.
- 1 — Включено.
use_skip_indexes_if_final_exact_mode
- 0 — Отключено.
- 1 — Включено.
use_skip_indexes_on_data_read
- 0 — Отключено.
- 1 — Включено.
/// предпочтительнее ‘allow_statistics_optimize’ для единообразия с ‘use_primary_key’ и ‘use_skip_indexes’
Позволяет использовать статистику для оптимизации запросов
Использовать кэш статистики в запросе, чтобы избежать накладных расходов при загрузке статистики для каждой части
use_statistics_for_part_pruning
- 0 — Отключено.
- 1 — Включено.
use_strict_insert_block_limits
- Минимальные пороги (AND): достигнуты оба порога — min_insert_block_size_rows AND min_insert_block_size_bytes.
- Максимальные пороги (OR): достигнут либо max_insert_block_size_rows, либо max_insert_block_size_bytes.
Когда отключена, блок формируется, когда:
- Минимальные пороги (OR): достигнут либо min_insert_block_size_rows, либо min_insert_block_size_bytes.
Примечание: Если максимальные настройки меньше минимальных, приоритет имеют максимальные ограничения, и блоки будут формироваться до достижения минимальных порогов.
Примечание: Эта настройка автоматически отключается для async inserts, поскольку async inserts добавляют токены дедупликации для каждой записи, которые несовместимы с разбиением блоков, необходимым для соблюдения строгих ограничений.
По умолчанию отключена.
use_structure_from_insertion_table_in_table_functions
use_text_index_like_evaluation_by_dictionary_scan
use_text_index_postings_cache
use_text_index_tokens_cache
use_top_k_dynamic_filtering
ORDER BY <column> LIMIT n.
Если настройка включена, исполнитель запроса будет пытаться пропускать гранулы и строки, которые не попадут в итоговый набор строк top N. Эта оптимизация носит динамический характер, и снижение задержки зависит от распределения данных и наличия в запросе других предикатов.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
use_top_k_dynamic_filtering_for_variable_length_types
use_top_k_dynamic_filtering, когда столбец сортировки имеет тип данных переменной длины (например, String, Array, Map, Tuple, содержащий элементы переменной длины).
Для таких типов сравнение с порогом для каждой строки, выполняемое динамическим фильтром, может свести на нет получаемую выгоду, если в столбце преобладает лексикографический минимум (например, в основном пустые строки) и удаётся пропустить лишь небольшое число гранул. В таком случае динамический фильтр не уменьшает, а увеличивает задержку запроса.
Когда этот параметр равен 0, динамическая фильтрация ограничивается столбцами, значения которых имеют фиксированный максимальный размер в памяти (числа, Date, DateTime, FixedString, Enum, Nullable таких типов, Tuple таких типов). Если задано значение 1, динамическая фильтрация также применяется к типам переменной длины.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
Определяет, использовать ли кэш несжатых блоков. Допустимые значения: 0 или 1. По умолчанию — 0 (отключено).
Использование кэша несжатых блоков (только для таблиц семейства MergeTree) может значительно снизить задержку и повысить пропускную способность при работе с большим количеством коротких запросов. Включайте эту настройку для пользователей, которые часто отправляют короткие запросы. Также обратите внимание на параметр конфигурации uncompressed_cache_size (задаётся только в файле config) — размер кэша несжатых блоков. По умолчанию он составляет 8 GiB. Кэш несжатых блоков заполняется по мере необходимости, а наименее используемые данные удаляются автоматически.
Для запросов, читающих хотя бы относительно большой объём данных (один миллион строк или более), кэш несжатых блоков автоматически отключается, чтобы освободить место для действительно небольших запросов. Это означает, что параметр ‘use_uncompressed_cache’ можно всегда оставлять равным 1.
use_variant_as_common_type
Variant в качестве типа результата для функций if/multiIf/array/map, если для типов аргументов нет общего типа.
Пример:
SET use_variant_as_common_type = 1;
SELECT toTypeName(if(number % 2, number, range(number))) as variant_type FROM numbers(1);
SELECT if(number % 2, number, range(number)) as variant FROM numbers(5);
┌─variant_type───────────────────┐
│ Variant(Array(UInt64), UInt64) │
└────────────────────────────────┘
┌─variant───┐
│ [] │
│ 1 │
│ [0,1] │
│ 3 │
│ [0,1,2,3] │
└───────────┘
SET use_variant_as_common_type = 1;
SELECT toTypeName(multiIf((number % 4) = 0, 42, (number % 4) = 1, [1, 2, 3], (number % 4) = 2, 'Hello, World!', NULL)) AS variant_type FROM numbers(1);
SELECT multiIf((number % 4) = 0, 42, (number % 4) = 1, [1, 2, 3], (number % 4) = 2, 'Hello, World!', NULL) AS variant FROM numbers(4);
─variant_type─────────────────────────┐
│ Variant(Array(UInt8), String, UInt8) │
└──────────────────────────────────────┘
┌─variant───────┐
│ 42 │
│ [1,2,3] │
│ Hello, World! │
│ ᴺᵁᴸᴸ │
└───────────────┘
SET use_variant_as_common_type = 1;
SELECT toTypeName(array(range(number), number, 'str_' || toString(number))) as array_of_variants_type from numbers(1);
SELECT array(range(number), number, 'str_' || toString(number)) as array_of_variants FROM numbers(3);
┌─array_of_variants_type────────────────────────┐
│ Array(Variant(Array(UInt64), String, UInt64)) │
└───────────────────────────────────────────────┘
┌─array_of_variants─┐
│ [[],0,'str_0'] │
│ [[0],1,'str_1'] │
│ [[0,1],2,'str_2'] │
└───────────────────┘
SET use_variant_as_common_type = 1;
SELECT toTypeName(map('a', range(number), 'b', number, 'c', 'str_' || toString(number))) as map_of_variants_type from numbers(1);
SELECT map('a', range(number), 'b', number, 'c', 'str_' || toString(number)) as map_of_variants FROM numbers(3);
┌─map_of_variants_type────────────────────────────────┐
│ Map(String, Variant(Array(UInt64), String, UInt64)) │
└─────────────────────────────────────────────────────┘
┌─map_of_variants───────────────┐
│ {'a':[],'b':0,'c':'str_0'} │
│ {'a':[0],'b':1,'c':'str_1'} │
│ {'a':[0,1],'b':2,'c':'str_2'} │
└───────────────────────────────┘
use_variant_default_implementation_for_comparisons
use_with_fill_by_sorting_prefix
validate_enum_literals_in_operators
IN, NOT IN, ==, !=, проверяются на соответствие типу enum; если литерал не является допустимым значением enum, будет сгенерировано исключение.
Проверяет запросы мутации перед их принятием. Мутации выполняются в фоновом режиме, и запуск некорректного запроса приведёт к их зависанию, из-за чего потребуется ручное вмешательство.
Изменяйте эту настройку только если столкнулись с ошибкой, нарушающей обратную совместимость.
Включает или отключает генерирование исключения в функции pointInPolygon, если полигон самопересекающийся или самокасающийся.
Возможные значения:
- 0 — Генерирование исключения отключено.
pointInPolygon принимает некорректные полигоны и может возвращать для них неверные результаты.
- 1 — Генерирование исключения включено.
variant_throw_on_type_mismatch
true (по умолчанию) — сгенерировать исключение.false — вместо этого возвращать NULL для этих строк.
vector_search_filter_strategy
- ‘auto’ - Постфильтрация (точная семантика может измениться в будущем).
- ‘postfilter’ - Использовать индекс векторного сходства для определения ближайших соседей, затем применить другие фильтры
- ‘prefilter’ - Сначала применить другие фильтры, затем выполнить полный перебор для определения соседей.
vector_search_index_fetch_multiplier
vector_search_postfilter_multiplier
Умножает количество получаемых ближайших соседей из индекса векторного сходства на это число. Применяется только при постфильтрации с другими предикатами или если включена настройка ‘vector_search_with_rescoring = 1’.
vector_search_with_rescoring
wait_changes_become_visible_after_commit_mode
wait_for_async_insert_timeout
wait_for_window_view_fire_signal_timeout
webassembly_udf_max_instances
webassembly_udf_max_memory
window_view_clean_interval
window_view_heartbeat_interval
write_through_distributed_cache
write_through_distributed_cache_buffer_size
Последнее изменение 10 июня 2026 г.
