ClickHouse创建表后DDL中AggregateFunction出现多余1的原因

你执行的建表SQL如下：

CREATE TABLE A
(
    `year_month` UInt32,
    some_sum AggregateFunction(sumMap, Tuple(Array(String), Array(Int64)))
)
ENGINE = AggregatingMergeTree
ORDER BY (`year_month`);

但查看表的DDL时，得到的内容却多了一个"1"：

CREATE TABLE A
(
    year_month UInt32,
    some_sum AggregateFunction(1, sumMap, Tuple(Array (String), Array(Int64)))
)
ENGINE = AggregatingMergeTree ORDER BY year_month
        SETTINGS index_granularity = 8192;

原因说明 #

这个"1"是ClickHouse内部用于标记聚合函数版本的参数，属于正常的元数据序列化行为，并非错误：

• ClickHouse会为聚合函数添加版本号，用于兼容不同版本的函数实现逻辑，避免因版本迭代导致的兼容性问题
• sumMap这类聚合函数存在多个历史实现版本，"1"代表当前使用的是默认的稳定版本
• 该版本号不会影响表的功能、数据存储或查询结果，只是ClickHouse内部的标识信息
• 无论使用带版本号还是不带版本号的DDL语句来操作表，最终的效果都是完全一致的

内容的提问来源于stack exchange，提问作者Tish17