group_by_* 会话设置 - ClickHouse Documentation

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

group_by_overflow_mode

设置当用于聚合的唯一键数量超过限制时的行为：

throw：抛出异常
break：停止执行查询并返回部分结果
any：继续对已进入集合的键进行聚合，但不再向集合中添加新键。

使用 any 值可以执行 GROUP BY 的近似计算。这种近似计算的效果取决于数据的统计特性。

group_by_two_level_threshold

键的数量达到多少时开始启用两级聚合。0 表示未设置该阈值。

group_by_two_level_threshold_bytes

当聚合状态的大小达到多少字节时，开始使用两级聚合。0 表示未设置阈值。当至少一个阈值达到条件时，将使用两级聚合。

group_by_use_nulls

更改 GROUP BY clause 处理聚合键类型的方式。使用 ROLLUP、CUBE 或 GROUPING SETS 说明符时，某些聚合键可能不会用于生成某些结果行。这些键对应的列会根据此设置，在相应行中填入默认值或 NULL。 Possible values:

0 — 使用聚合键类型的默认值来填补缺失值。
1 — ClickHouse 会按照 SQL 标准的方式执行 GROUP BY。聚合键的类型会转换为 Nullable。对于未使用相应聚合键的行，其对应列会填充为 NULL。

See also:

GROUP BY clause

最后修改于 2026年7月23日

hdfs_*hdfs_* 自动生成分组中的 ClickHouse 会话设置。