如何为已有ClickHouse表添加带默认值的新列且保留原有数据

要给已存在的ClickHouse表添加新列并自动为原有数据填充默认值，直接使用ALTER TABLE语句搭配ADD COLUMN即可，ClickHouse会自动处理原有数据的默认值填充，无需额外导出导入操作。

基础语法 #

ALTER TABLE [数据库名.]表名 ADD COLUMN 列名 数据类型 DEFAULT 默认值;

实际示例 #

假设你有一张名为user_info的表，现在需要添加不同类型的新列：

1. 添加日期类型列，默认值为当前日期

ALTER TABLE user_info ADD COLUMN create_date Date DEFAULT today();

2. 添加字符串类型列，默认值为空字符串

ALTER TABLE user_info ADD COLUMN address String DEFAULT '';

3. 添加整数类型列，默认值为0

ALTER TABLE user_info ADD COLUMN login_count Int32 DEFAULT 0;

进阶用法 #

• 指定新列的位置：如果希望新列放在某一列之后，使用AFTER关键字

ALTER TABLE user_info ADD COLUMN age Int8 DEFAULT 18 AFTER username;

• 基于现有列计算默认值：默认值可以是依赖其他列的表达式，原有数据会自动计算填充

ALTER TABLE user_info ADD COLUMN full_name String DEFAULT concat(first_name, ' ', last_name);

注意事项 #

• 执行操作前确保你拥有该表的ALTER权限
• 对于MergeTree系列引擎，添加列属于轻量级元数据操作，不会重写全量数据，执行效率很高
• 如果你的ClickHouse版本较旧（低于20.3），部分复杂默认值的列添加可能需要重写数据，建议先备份或在测试环境验证

内容的提问来源于stack exchange，提问作者Андрей Степанов