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

allow_coalescing_columns_in_partition_or_order_key

启用后,允许在 CoalescingMergeTree 表中将合并列用作 分区键或排序键。

allow_commit_order_projection

启用提交顺序投影,该投影会存储 _block_number_block_offset 虚拟列,并在合并过程中保留原始插入顺序。 需要启用 enable_block_number_columnenable_block_offset_column

allow_dimensions_outside_sorting_key

AggregatingMergeTree 中,background merges 会折叠 排序键 key 值相同的行,并合并它们的 aggregate states。某个列如果既不属于 排序键,也不是 aggregate state measure (AggregateFunctionSimpleAggregateFunction) ,那它就是一个 dimension:在 merge 之后,它会保留被折叠行中任意一行的值,这会悄悄导致对该列执行 GROUP BY 或按其过滤的查询得到错误 结果 (参见 https://github.com/ClickHouse/ClickHouse/issues/751) 。 默认情况下,创建表时会拒绝这种 schema。如果该列在函数上依赖于 排序键 (也就是说,所有被折叠的行都具有相同的值) ,并且这种 行为是有意的,请启用此设置。 该检查仅适用于实际发生聚合的表 (即至少包含一个 aggregate state 列的表) ,并且在启用 allow_tuple_element_aggregation 时会跳过。

allow_floating_point_partition_key

启用后可将浮点数作为分区键。 可能的值:
  • 0 — 不允许使用浮点数分区键。
  • 1 — 允许使用浮点数分区键。

allow_minmax_index_for_json

允许在 JSON (Object) 列上创建 minmax 跳过索引。默认情况下禁用,因为 minmax 索引的序列化路径无法处理 JSON 列中可能包含的异构 Field 值。

allow_nullable_key

允许将 Nullable 类型作为主键。

allow_part_offset_column_in_projections

允许在投影的 select 查询中使用 _part_offset 列。

allow_reduce_blocking_parts_task

用于减少 shared merge tree 表中阻塞 parts 的后台任务。 仅适用于 ClickHouse Cloud

allow_remote_fs_zero_copy_replication

请勿在生产环境中使用此设置,因为它尚未准备就绪。

allow_summing_columns_in_partition_or_order_key

启用后,允许在 SummingMergeTree 表中将求和列用作 分区键或排序键。

allow_suspicious_indices

拒绝使用相同表达式的主索引/二级索引和排序键

allow_tuple_element_aggregation

启用后,Tuple 列中的各个元素会在 SummingMergeTree、AggregatingMergeTree 和 CoalescingMergeTree 合并期间参与聚合。嵌套的 Tuple 会被递归展开,因此所有 叶子元素都会被分别聚合。此设置不可更改, 必须在创建表时指定。

allow_vertical_merges_from_compact_to_wide_parts

允许将 compact parts 垂直合并为 wide parts。此设置在所有副本上必须保持相同的值。
最后修改于 2026年7月24日