Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки таблиц семейства MergeTree shared_merge_*

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

shared_merge_tree_activate_coordinated_merges_tasks

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.90Новая настройка
25.80Новая настройка
25.70Новая настройка
25.60Новая настройка
25.100Новая настройка

Активирует перепланирование задач координированных слияний. Это может быть полезно даже при shared_merge_tree_enable_coordinated_merges=0, поскольку позволяет заполнить статистику координатора слияний и ускорить холодный старт.

shared_merge_tree_blobs_list_inline_file_max_bytes

Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.90Новая настройка, позволяющая хранить небольшие файлы части blob-list непосредственно в консолидированном blobs.list вместо отдельных blob-объектов

Хранит файлы части blob-list размером не более указанного числа байтов (например, count.txt, metadata_version.txt, индексы minmax) непосредственно в консолидированном файле blobs.list вместо отдельного blob-объекта в объектном хранилище, экономя одну операцию записи и чтения blob-объекта для каждого небольшого файла. Значение 0 отключает встраивание. Настройка действует только для частей, использующих хранилище blob-list (см. shared_merge_tree_use_blobs_list_for_parts). Доступно только в ClickHouse Cloud.

shared_merge_tree_create_per_replica_metadata_nodes

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.110Уменьшает объём метаданных в Keeper.
25.11Синхронизация с Cloud

Включает создание узлов /metadata и /columns для каждой реплики в ZooKeeper. Доступно только в ClickHouse Cloud

shared_merge_tree_disable_merges_and_mutations_assignment

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

Отключает назначение слияний для shared merge tree. Доступно только в ClickHouse Cloud

shared_merge_tree_empty_partition_lifetime

Тип
Секунды
По умолчанию
86400
История версий
ВерсияЗначение по умолчаниюКомментарий
25.986400Новая настройка

Сколько секунд партиция будет храниться в Keeper, если у неё нет частей.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.21Включено по умолчанию
25.90новая настройка

Включает очистку записей Keeper для пустых партиций.

shared_merge_tree_enable_coordinated_merges

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.61Координированные слияния включены по умолчанию
25.50новая настройка

Включает стратегию координированных слияний

shared_merge_tree_enable_keeper_parts_extra_data

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.61По умолчанию включает координированные слияния
25.30Новая настройка

Включает запись атрибутов в виртуальные части и коммит блоков в Keeper

shared_merge_tree_enable_outdated_parts_check

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11Синхронизация с Cloud

Включить проверку устаревших частей. Доступно только в ClickHouse Cloud

shared_merge_tree_idle_parts_update_seconds

Тип
UInt64
По умолчанию
3600
История версий
ВерсияЗначение по умолчаниюКомментарий
25.13600Синхронизация с Cloud

Интервал в секундах между обновлениями частей, не инициированными наблюдением ZooKeeper в shared merge tree. Доступно только в ClickHouse Cloud

shared_merge_tree_inactive_replica_cutoff_seconds

Тип
Секунда
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.60Новая настройка, которая определяет, как долго неактивная реплика учитывается при фоновой очистке (0 означает два тайм-аута сеанса ZooKeeper)

Как долго неактивная реплика продолжает учитываться при фоновой очистке (OutdatedPartsQuorumThread): пока реплика неактивна меньше указанного количества секунд, она по-прежнему препятствует удалению устаревших частей и усечению завершённых мутаций. Значение 0 означает использование значения по умолчанию — двух тайм-аутов сеанса ZooKeeper. Только в ClickHouse Cloud

shared_merge_tree_initial_parts_update_backoff_ms

Тип
UInt64
По умолчанию
50
История версий
ВерсияЗначение по умолчаниюКомментарий
25.250новая настройка

Начальная задержка перед обновлением частей. Доступно только в ClickHouse Cloud

shared_merge_tree_interserver_http_connection_timeout_ms

Тип
UInt64
По умолчанию
100
История версий
ВерсияЗначение по умолчаниюКомментарий
25.2100новая настройка

Тайм-ауты межсерверных HTTP-соединений. Доступно только в ClickHouse Cloud

shared_merge_tree_interserver_http_timeout_ms

Тип
UInt64
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.110000Синхронизация с Cloud

Тайм-ауты межсерверного HTTP-взаимодействия. Доступно только в ClickHouse Cloud

shared_merge_tree_leader_update_period_random_add_seconds

Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
25.110Синхронизация с Cloud

Добавляет к shared_merge_tree_leader_update_period случайное значение с равномерным распределением в диапазоне от 0 до x секунд, чтобы избежать эффекта «стада». Доступно только в ClickHouse Cloud

shared_merge_tree_leader_update_period_seconds

Тип
UInt64
По умолчанию
30
История версий
ВерсияЗначение по умолчаниюКомментарий
25.130Синхронизация с Cloud

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

shared_merge_tree_max_outdated_parts_to_process_at_once

Тип
UInt64
По умолчанию
1000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11000Синхронизация с Cloud

Максимальное количество устаревших частей, удаление которых лидер попытается подтвердить за один HTTP-запрос. Доступно только в ClickHouse Cloud.

shared_merge_tree_max_parts_update_backoff_ms

Тип
UInt64
По умолчанию
5000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.25000новая настройка

Максимальная задержка при обновлении частей. Доступно только в ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_in_total

Тип
UInt64
По умолчанию
6
История версий
ВерсияЗначение по умолчаниюКомментарий
25.16Синхронизация с Cloud

Максимальное число лидеров обновления частей. Доступно только в ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_per_az

Тип
UInt64
По умолчанию
2
История версий
ВерсияЗначение по умолчаниюКомментарий
25.12Синхронизация с Cloud

Максимальное число лидеров обновления частей. Доступно только в ClickHouse Cloud

shared_merge_tree_max_replicas_for_parts_deletion

Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
25.110Синхронизация с Cloud

Максимальное число реплик, участвующих в удалении частей (поток killer). Доступно только в ClickHouse Cloud

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

Тип
UInt64
По умолчанию
5
История версий
ВерсияЗначение по умолчаниюКомментарий
25.15Синхронизация с Cloud

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

shared_merge_tree_max_suspicious_broken_parts

Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.20Максимальное количество повреждённых частей для SMT; при превышении этого значения автоматическое отсоединение запрещается

Максимальное количество повреждённых частей для SMT; при превышении этого значения автоматическое отсоединение запрещается.

shared_merge_tree_max_suspicious_broken_parts_bytes

Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.20Максимальный размер всех поврежденных частей для SMT; при превышении запретить автоматическое отсоединение

Максимальный размер всех поврежденных частей для SMT; при превышении запретить автоматическое отсоединение.

shared_merge_tree_memo_ids_remove_timeout_seconds

Тип
Int64
По умолчанию
1800
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11800Синхронизация с Cloud

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

shared_merge_tree_merge_coordinator_distribution_algorithm

Тип
MergeCoordinatorDistributionAlgorithm
По умолчанию
sainte_lague
История версий
ВерсияЗначение по умолчаниюКомментарий
26.8sainte_lagueВключить распределение Sainte-Lague по умолчанию.
26.7water_fillingНовая настройка, которая определяет, какой алгоритм координатор слияний использует для распределения слияний между репликами

Алгоритм, используемый потоком координатора слияний для распределения слияний между репликами.

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

  • water_filling
  • sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

Тип
Milliseconds
По умолчанию
30000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.530000новая настройка

Интервал между запусками потока выборов координатора слияний

shared_merge_tree_merge_coordinator_factor

Тип
Float
По умолчанию
1.1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.51.100000023841858новая настройка
25.101.100000023841858Сокращено время ожидания координатора после нагрузки

Коэффициент изменения времени задержки потока координатора

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Тип
Milliseconds
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.510000Новая настройка

Как часто координатор слияний должен синхронизироваться с ZooKeeper для получения свежих метаданных

shared_merge_tree_merge_coordinator_max_merge_request_size

Тип
UInt64
По умолчанию
20
История версий
ВерсияЗначение по умолчаниюКомментарий
25.520Новая настройка

Количество слияний, которые координатор может одновременно запросить у MergerMutator

shared_merge_tree_merge_coordinator_max_period_ms

Тип
Milliseconds
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.510000новая настройка

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

shared_merge_tree_merge_coordinator_merges_prepare_count

Тип
UInt64Auto
По умолчанию
auto
История версий
ВерсияЗначение по умолчаниюКомментарий
26.4autoУстановить для настройки значение `auto`: максимальное число задач слияния на одну реплику * число активных реплик
25.5100новая настройка

Количество записей о слияниях, которые координатор должен подготовить и распределить между воркерами. Если установлено значение 'auto', оно равно максимальному числу задач слияния, разрешённых для одной реплики, умноженному на число активных реплик.

shared_merge_tree_merge_coordinator_min_period_ms

Тип
Milliseconds
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.51новая настройка

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

shared_merge_tree_merge_worker_fast_timeout_ms

Тип
Milliseconds
По умолчанию
100
История версий
ВерсияЗначение по умолчаниюКомментарий
25.5100новая настройка

Тайм-аут, который использует рабочий поток слияния, если ему требуется обновить своё состояние после немедленного действия

shared_merge_tree_merge_worker_regular_timeout_ms

Тип
Milliseconds
По умолчанию
10000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.510000новая настройка

Интервал между запусками рабочего потока слияния

shared_merge_tree_outdated_parts_group_size

Тип
UInt64
По умолчанию
2
История версий
ВерсияЗначение по умолчаниюКомментарий
25.92новая настройка

Сколько реплик будет входить в одну группу rendezvous hash при очистке устаревших частей. Доступно только в ClickHouse Cloud.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

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

Будет перезагружать предикат слияния в задаче выбора для слияния/мутации, когда отношение <candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> превышает значение этой настройки. Доступно только в ClickHouse Cloud

shared_merge_tree_parts_load_batch_size

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

Количество одновременно планируемых задач по получению метаданных частей. Доступно только в ClickHouse Cloud

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.10Синхронизация с Cloud

Время, в течение которого локально слитая часть хранится без запуска нового слияния с её участием. Это даёт другим репликам возможность получить эту часть и начать такое слияние. Доступно только в ClickHouse Cloud.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

Тип
UInt64
По умолчанию
1000000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11000000Синхронизация с Cloud

Минимальный размер части (в строках), после локального слияния которой назначение следующего слияния откладывается. Доступно только в ClickHouse Cloud.

shared_merge_tree_range_for_merge_window_size

Тип
UInt64
По умолчанию
10
История версий
ВерсияЗначение по умолчаниюКомментарий
25.110Синхронизация с Cloud

Размер окна (в номерах блоков), используемый для распределения заданий на merge между репликами. Части в пределах одного окна назначаются одним и тем же репликам. Доступно только в ClickHouse Cloud

shared_merge_tree_read_virtual_parts_from_leader

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11Синхронизация с Cloud

Считывать виртуальные части с лидера, когда это возможно. Доступно только в ClickHouse Cloud

shared_merge_tree_replica_set_max_lifetime_seconds

Тип
Секунды
По умолчанию
1800
История версий
ВерсияЗначение по умолчаниюКомментарий
26.41800Увеличен интервал фонового обновления набора реплик по умолчанию до 30 минут
26.2300новая настройка

Как часто реплики будут пытаться обновлять набор реплик в фоновом режиме. Время следующего запуска выбирается со случайным равномерным смещением в диапазоне [0, value] секунд. Исключение: value = 0 не подчиняется этому правилу; реализация задаёт минимум 200 мс, поэтому время следующего запуска выбирается со случайным равномерным смещением в диапазоне [0, 200] мс.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.10Новая настройка для получения хранящихся в памяти данных части от других реплик

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

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.60Новая настройка, позволяющая SMT при запуске загружать данные частей из реплик, а не из S3

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

shared_merge_tree_update_replica_flags_delay_ms

Тип
Milliseconds
По умолчанию
30000
История версий
ВерсияЗначение по умолчаниюКомментарий
25.830000новая настройка

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

shared_merge_tree_use_blobs_list_for_parts

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.90Новая настройка: карта blob-объектов для каждого файла части SharedMergeTree хранится в одном объединённом узле Keeper вместо отдельного узла для каждого файла

Храните части таблицы SharedMergeTree (как Wide, так и Compact) в виде одного объединённого узла метаданных blob-list вместо отдельного узла Keeper для каждого файла. Сокращает объём метаданных Keeper для каждой части с O(файлов) до небольшой постоянной величины, сохраняя один blob-объект в объектном хранилище для каждого файла. Доступно только в ClickHouse Cloud.

shared_merge_tree_use_metadata_hints_cache

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.11Синхронизация с Cloud

Включает запрос подсказок для FS-кэша из in-memory-кэша на других репликах. Доступно только в ClickHouse Cloud

shared_merge_tree_use_outdated_parts_compact_format

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.91Устаревшие части v3 включены по умолчанию
25.10Синхронизация с Cloud

Использовать compact-формат для устаревших частей: снижает нагрузку на Keeper, улучшает обработку устаревших частей. Доступно только в ClickHouse Cloud

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.10Синхронизация с Cloud

Если включено, счётчик Too many parts будет опираться на общие данные в Keeper, а не на локальное состояние реплики. Доступно только в ClickHouse Cloud

shared_merge_tree_use_zookeeper_connection_pool

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.30новая настройка

Если настройка включена, SharedMergeTree использует один из пулов сеансов ZooKeeper на уровне сервера.

shared_merge_tree_virtual_parts_discovery_batch

Тип
UInt64
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.81Новая настройка

Сколько операций обнаружения партиций следует объединять в батч

shared_merge_tree_virtual_parts_partition_atomic_discovery

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.71Новая настройка

Устаревшая настройка, не имеет эффекта.

Navigation