shared_merge_* MergeTree 表设置

这些设置可在 system.merge_tree_settings 中查看，且由 ClickHouse 源代码自动生成。

shared_merge_tree_activate_coordinated_merges_tasks

类型

Bool

默认值

版本历史

版本	默认值	注释
25.9	0	新设置
25.8	0	新设置
25.7	0	新设置
25.6	0	新设置
25.10	0	新设置

启用协调式合并任务的重新调度。即使在 shared_merge_tree_enable_coordinated_merges=0 时，它也可能很有用，因为这会补充 merge coordinator 统计信息，并有助于冷启动。

shared_merge_tree_blobs_list_inline_file_max_bytes

类型

UInt64

默认值

版本历史

版本	默认值	注释
26.9	0	新增设置：将 blob-list part 中的小文件内联存储在合并后的 blobs.list 中，而不是存储为独立 blob

将 blob-list part 中大小不超过此字节数的文件 (例如 count.txt、metadata_version.txt、minmax 索引) 直接存储在合并后的 blobs.list 文件中，而不是存储为单独的对象存储 blob，从而为每个小文件节省一次 blob 写入和读取操作。设置为 0 将禁用内联。仅对使用 blob-list 存储的 parts 生效 (请参阅 shared_merge_tree_use_blobs_list_for_parts) 。仅在 ClickHouse Cloud 中可用。

shared_merge_tree_create_per_replica_metadata_nodes

类型

Bool

默认值

版本历史

版本	默认值	注释
25.11	0	减少 Keeper 中的元数据量。
25.1	1	Cloud sync

启用在 ZooKeeper 中为每个副本创建各自的 /metadata 和 /columns 节点。仅在 ClickHouse Cloud 中可用

shared_merge_tree_disable_merges_and_mutations_assignment

类型

Bool

默认值

停止 shared merge tree 的合并任务分配。仅在 ClickHouse Cloud 中可用

shared_merge_tree_empty_partition_lifetime

类型

秒

默认值

86400

版本历史

版本	默认值	注释
25.9	86400	新设置

当分区没有 parts 时，会在 Keeper 中保留多少秒。

shared_merge_tree_enable_automatic_empty_partitions_cleanup

类型

Bool

默认值

版本历史

版本	默认值	注释
26.2	1	默认启用
25.9	0	新设置

启用自动清理空分区的 Keeper 条目。

shared_merge_tree_enable_coordinated_merges

类型

Bool

默认值

版本历史

版本	默认值	注释
26.6	1	默认启用协调合并策略
25.5	0	新设置

启用协调合并策略

shared_merge_tree_enable_keeper_parts_extra_data

类型

Bool

默认值

版本历史

版本	默认值	注释
26.6	1	默认启用协调合并
25.3	0	新设置

启用向 virtual parts 写入属性，并在 Keeper 中提交块

shared_merge_tree_enable_outdated_parts_check

类型

Bool

默认值

版本历史

版本	默认值	注释
25.1	1	Cloud sync

启用对过期分区片段的检查。仅在 ClickHouse Cloud 中可用

shared_merge_tree_idle_parts_update_seconds

类型

UInt64

默认值

3600

版本历史

版本	默认值	注释
25.1	3600	Cloud sync

在 shared merge tree 中，未由 ZooKeeper watch 触发时更新 parts 的时间间隔 (秒) 。仅在 ClickHouse Cloud 中可用

shared_merge_tree_inactive_replica_cutoff_seconds

类型

秒

默认值

版本历史

版本	默认值	注释
26.6	0	用于控制后台清理在多长时间内仍将非活动副本纳入考虑范围的新增设置（0 表示两个 ZooKeeper 会话超时）

后台清理 (OutdatedPartsQuorumThread) 在多长时间内仍会将非活动副本纳入考虑：当某个副本处于非活动状态的时间少于该秒数时，它仍会阻止移除过期分区片段以及截断已完成的变更。值为 0 表示使用默认值，即两个 ZooKeeper 会话超时。仅适用于 ClickHouse Cloud

shared_merge_tree_initial_parts_update_backoff_ms

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.2	50	新设置

parts 更新的初始退避时间。仅在 ClickHouse Cloud 中可用

shared_merge_tree_interserver_http_connection_timeout_ms

类型

UInt64

默认值

100

版本历史

版本	默认值	注释
25.2	100	新设置

服务器间 HTTP 连接超时。仅在 ClickHouse Cloud 中可用

shared_merge_tree_interserver_http_timeout_ms

类型

UInt64

默认值

10000

版本历史

版本	默认值	注释
25.1	10000	Cloud sync

interserver HTTP 通信的超时时间。仅在 ClickHouse Cloud 中可用

shared_merge_tree_leader_update_period_random_add_seconds

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	10	Cloud sync

为避免惊群效应，向 shared_merge_tree_leader_update_period 添加一个从 0 到 x 秒均匀分布的随机值。仅在 ClickHouse Cloud 中可用

shared_merge_tree_leader_update_period_seconds

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	30	Cloud sync

重新检查 parts 更新 leader 的最长周期。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_outdated_parts_to_process_at_once

类型

UInt64

默认值

1000

版本历史

版本	默认值	注释
25.1	1000	Cloud sync

在一次 HTTP 请求中，leader 尝试确认可移除的过期分区片段的最大数量。仅在 ClickHouse Cloud 中可用。

shared_merge_tree_max_parts_update_backoff_ms

类型

UInt64

默认值

5000

版本历史

版本	默认值	注释
25.2	5000	新设置

parts 更新的最大退避时间。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_parts_update_leaders_in_total

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	6	Cloud sync

parts update leaders 的最大数量上限。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_parts_update_leaders_per_az

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	2	Cloud sync

parts update leader 的最大数量。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_replicas_for_parts_deletion

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	10	Cloud sync

参与 parts 删除 (killer 线程) 的最大副本数上限。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	5	Cloud sync

尝试为可能发生冲突的合并进行分配的最大副本数 (可避免在合并分配中出现冗余冲突) 。0 表示禁用。仅在 ClickHouse Cloud 中可用

shared_merge_tree_max_suspicious_broken_parts

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.2	0	SMT 的损坏 parts 最大数量；超过该数量时，将禁止自动分离

SMT 的损坏 parts 最大数量；超过该数量时，将禁止自动分离。

shared_merge_tree_max_suspicious_broken_parts_bytes

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.2	0	SMT 中所有损坏 parts 的最大总大小；如果超过该值，则禁止自动 detach

SMT 中所有损坏 parts 的最大总大小；如果超过该值，则禁止自动 detach。

shared_merge_tree_memo_ids_remove_timeout_seconds

类型

Int64

默认值

1800

版本历史

版本	默认值	注释
25.1	1800	Cloud sync

我们会将插入记忆化 ID 保留多长时间，以避免在插入重试期间发生错误操作。仅在 ClickHouse Cloud 中可用

shared_merge_tree_merge_coordinator_distribution_algorithm

类型

MergeCoordinatorDistributionAlgorithm

默认值

sainte_lague

版本历史

版本	默认值	注释
26.8	sainte_lague	默认启用 Sainte-Lague 分配算法。
26.7	water_filling	新增设置，用于控制 merge coordinator 在副本之间分发合并时所使用的算法

merge coordinator 线程在副本之间分发合并时使用的算法。

可能的值：

water_filling
sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

类型

毫秒

默认值

30000

版本历史

版本	默认值	注释
25.5	30000	新设置

merge coordinator 选举线程的运行间隔时间

shared_merge_tree_merge_coordinator_factor

类型

Float

默认值

1.1

版本历史

版本	默认值	注释
25.5	1.100000023841858	新设置
25.10	1.100000023841858	负载后降低协调器休眠时间

协调器线程延迟时间的变化系数

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

类型

毫秒

默认值

10000

版本历史

版本	默认值	注释
25.5	10000	新设置

合并协调器应隔多久与 ZooKeeper 同步一次，以获取最新元数据

shared_merge_tree_merge_coordinator_max_merge_request_size

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.5	20	新设置

协调器一次可向 MergerMutator 请求的合并数量

shared_merge_tree_merge_coordinator_max_period_ms

类型

毫秒

默认值

10000

版本历史

版本	默认值	注释
25.5	新设置	10000

merge coordinator 线程两次运行之间的最大时间间隔

shared_merge_tree_merge_coordinator_merges_prepare_count

类型

UInt64Auto

默认值

auto

版本历史

版本	默认值	注释
26.4	auto	将该设置设为 auto：每个副本的最大 merge 任务数 * 活跃副本数
25.5	100	新设置

coordinator 应准备并分发给工作线程的 merge 条目数量。当设置为 auto 时，其值等于单个副本允许的最大 merge 任务数乘以活跃副本数。

shared_merge_tree_merge_coordinator_min_period_ms

类型

毫秒

默认值

版本历史

版本	默认值	注释
25.5	1	新设置

merge coordinator 线程两次运行之间的最短间隔时间

shared_merge_tree_merge_worker_fast_timeout_ms

类型

毫秒

默认值

100

版本历史

版本	默认值	注释
25.5	100	新设置

合并工作线程在即时操作后需要更新其状态时使用的超时时间

shared_merge_tree_merge_worker_regular_timeout_ms

类型

毫秒

默认值

10000

版本历史

版本	默认值	注释
25.5	10000	新设置

合并工作线程两次运行之间的间隔时间

shared_merge_tree_outdated_parts_group_size

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.9	2	新设置

将有多少个副本位于同一个 rendezvous 哈希组中，以进行过期分区片段清理。仅在 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> 的比率高于此设置值时，会在 merge/mutate 选择任务中重新加载合并谓词。仅在 ClickHouse Cloud 中可用

shared_merge_tree_parts_load_batch_size

类型

UInt64

默认值

一次可调度的拉取 parts 元数据作业数量。仅在 ClickHouse Cloud 中可用

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	0	Cloud sync

在不启动包含该分片的新合并的情况下，保留本地已合并分片的时长。这样可让其他副本有机会拉取该分片并启动此次合并。仅在 ClickHouse Cloud 中可用。

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

类型

UInt64

默认值

1000000

版本历史

版本	默认值	注释
25.1	1000000	Cloud sync

刚在本地完成合并后，用于推迟为其分配下一次合并的分片最小大小 (按行数计算) 。仅在 ClickHouse Cloud 中可用。

shared_merge_tree_range_for_merge_window_size

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.1	10	Cloud sync

用于在各副本之间分发 merge 任务的窗口大小 (按块编号计算) 。同一窗口内的 parts 会分配给相同的副本。仅在 ClickHouse Cloud 中可用

shared_merge_tree_read_virtual_parts_from_leader

类型

Bool

默认值

版本历史

版本	默认值	注释
25.1	1	Cloud sync

如果可能，则从 leader 读取 virtual parts。仅在 ClickHouse Cloud 中可用

shared_merge_tree_replica_set_max_lifetime_seconds

类型

秒

默认值

1800

版本历史

版本	默认值	注释
26.4	1800	将默认的副本集后台更新间隔增加到 30 分钟
26.2	300	新设置

副本在后台尝试更新副本集的频率。下一次运行会在 [0, value] 秒范围内按均匀分布引入抖动。例外情况：value = 0 不遵循该规则；实现中会应用最小 200 毫秒，因此下一次运行会在 [0, 200] 毫秒范围内引入抖动。

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

类型

Bool

默认值

版本历史

版本	默认值	注释
25.1	0	用于从其他副本拉取分片内存数据的新设置

如果启用，所有副本都会尝试从其他已具有这些数据的副本拉取分片的内存数据 (如主键、分区信息等) 。

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

类型

Bool

默认值

版本历史

版本	默认值	注释
26.6	0	新增设置，允许 SMT 在启动时从副本而非 S3 下载分片数据

如果启用，所有副本都会在启动时尝试从其他已存在这些数据的副本拉取分片的内存数据 (如主键、分区信息等) 。

shared_merge_tree_update_replica_flags_delay_ms

类型

毫秒

默认值

30000

版本历史

版本	默认值	注释
25.8	30000	新设置

副本按后台调度尝试重新加载其标志的频率。

shared_merge_tree_use_blobs_list_for_parts

类型

Bool

默认值

版本历史

版本	默认值	注释
26.9	0	新增设置：将 SharedMergeTree part 中每个文件的 blob 映射存储在单个汇总的 Keeper 节点中，而不是每个文件使用一个节点

将 SharedMergeTree 表的 parts (包括 Wide 和 Compact) 存储在单个汇总的 blob-list 元数据节点中，而不是每个文件使用一个 Keeper 节点。将每个 part 的 Keeper 元数据从 O(files) 缩减为一个较小的常量，同时仍为每个文件保留一个对象存储 blob。仅在 ClickHouse Cloud 中可用。

shared_merge_tree_use_metadata_hints_cache

类型

Bool

默认值

版本历史

版本	默认值	注释
25.1	1	Cloud sync

启用从其他副本上的内存缓存中请求 FS 缓存提示。仅在 ClickHouse Cloud 中可用

shared_merge_tree_use_outdated_parts_compact_format

类型

Bool

默认值

版本历史

版本	默认值	注释
25.9	1	默认启用过期分区片段 v3
25.1	0	Cloud sync

对过期分区片段使用紧凑格式：可降低 Keeper 负载，并提升过期分区片段的处理效率。仅在 ClickHouse Cloud 中可用

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

类型

Bool

默认值

版本历史

版本	默认值	注释
25.1	0	Cloud sync

如果启用，parts 过多计数器将依赖 Keeper 中的共享数据，而不是本地副本状态。仅在 ClickHouse Cloud 中可用

shared_merge_tree_use_zookeeper_connection_pool

类型

Bool

默认值

版本历史

版本	默认值	注释
26.3	0	新设置

如果启用，SharedMergeTree 将使用服务器级 ZooKeeper 会话池中的一个会话。

shared_merge_tree_virtual_parts_discovery_batch

类型

UInt64

默认值

版本历史

版本	默认值	注释
25.8	1	新设置

应将多少个分区发现操作打包为一个批次

shared_merge_tree_virtual_parts_partition_atomic_discovery

类型

Bool

默认值

版本历史

版本	默认值	注释
26.7	1	新设置

已废弃的设置，不起任何作用。