ClickHouse中如何通过ALTER TABLE添加NOT NULL列？

核心结论 #

可以为已存在的表添加带NOT NULL约束的新列，但必须为该列指定默认值（或使用MATERIALIZED/ALIAS这类能自动生成值的表达式），否则语句无法生效。

原因分析 #

已存在的表包含历史数据行，新添加的NOT NULL列要求所有行（包括历史行）都不能有NULL值。如果不指定默认值，ClickHouse无法自动为历史行的新列填充合法的非NULL值，因此会拒绝执行该ALTER语句。

修正后的示例语句 #

将原语句补充默认值即可正常执行，比如：

ALTER TABLE product_stock_history_analytics
ADD COLUMN IF NOT EXISTS product_id STRING NOT NULL DEFAULT 'unknown';

如果有业务逻辑上的合理默认值（比如关联已有字段的表达式），也可以使用MATERIALIZED列，例如：

ALTER TABLE product_stock_history_analytics
ADD COLUMN IF NOT EXISTS product_id STRING NOT NULL MATERIALIZED substring(sku, 1, 8);

额外说明 #

ClickHouse中的NOT NULL是元数据层面的约束：写入时如果尝试插入NULL值会直接报错，但底层存储不会强制物理层面排除NULL（除非列类型本身是非Nullable的）。添加新列时的默认值会自动填充到所有历史数据行，确保新列满足NOT NULL要求。

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