Skip to main content
这些设置可在 system.merge_tree_settings 中查看,且由 ClickHouse 源代码自动生成。

shared_merge_tree_activate_coordinated_merges_tasks

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

shared_merge_tree_create_per_replica_metadata_nodes

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

shared_merge_tree_disable_merges_and_mutations_assignment

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

shared_merge_tree_empty_partition_lifetime

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

shared_merge_tree_enable_automatic_empty_partitions_cleanup

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

shared_merge_tree_enable_coordinated_merges

启用协调合并策略

shared_merge_tree_enable_keeper_parts_extra_data

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

shared_merge_tree_enable_outdated_parts_check

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

shared_merge_tree_idle_parts_update_seconds

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

shared_merge_tree_inactive_replica_cutoff_seconds

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

shared_merge_tree_initial_parts_update_backoff_ms

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

shared_merge_tree_interserver_http_connection_timeout_ms

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

shared_merge_tree_interserver_http_timeout_ms

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

shared_merge_tree_leader_update_period_random_add_seconds

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

shared_merge_tree_leader_update_period_seconds

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

shared_merge_tree_max_outdated_parts_to_process_at_once

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

shared_merge_tree_max_parts_update_backoff_ms

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

shared_merge_tree_max_parts_update_leaders_in_total

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

shared_merge_tree_max_parts_update_leaders_per_az

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

shared_merge_tree_max_replicas_for_parts_deletion

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

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

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

shared_merge_tree_max_suspicious_broken_parts

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

shared_merge_tree_max_suspicious_broken_parts_bytes

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

shared_merge_tree_memo_ids_remove_timeout_seconds

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

shared_merge_tree_merge_coordinator_distribution_algorithm

merge coordinator 线程在副本之间分发 merge 操作时使用的算法

shared_merge_tree_merge_coordinator_election_check_period_ms

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

shared_merge_tree_merge_coordinator_factor

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

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

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

shared_merge_tree_merge_coordinator_max_merge_request_size

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

shared_merge_tree_merge_coordinator_max_period_ms

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

shared_merge_tree_merge_coordinator_merges_prepare_count

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

shared_merge_tree_merge_coordinator_min_period_ms

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

shared_merge_tree_merge_worker_fast_timeout_ms

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

shared_merge_tree_merge_worker_regular_timeout_ms

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

shared_merge_tree_outdated_parts_group_size

将有多少个副本位于同一个 rendezvous 哈希组中,以进行过期分区片段清理。 仅在 ClickHouse Cloud 中可用。

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

<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

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

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

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

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

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

shared_merge_tree_range_for_merge_window_size

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

shared_merge_tree_read_virtual_parts_from_leader

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

shared_merge_tree_replica_set_max_lifetime_seconds

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

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

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

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

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

shared_merge_tree_update_replica_flags_delay_ms

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

shared_merge_tree_use_metadata_hints_cache

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

shared_merge_tree_use_outdated_parts_compact_format

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

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

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

shared_merge_tree_use_zookeeper_connection_pool

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

shared_merge_tree_virtual_parts_discovery_batch

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

shared_merge_tree_virtual_parts_partition_atomic_discovery

SMT 是否会以原子方式发现 virtual parts 分区,并进行额外的数据拉取和 watch 设置。
最后修改于 2026年7月23日