ClickHouse物化视图写入Map时StatusCode字段值为0问题排查

问题现象 #

• 采用SummingMergeTree引擎的目标表err_rps_per_svc，手动执行查询插入数据时，UInt16类型的StatusCode字段值符合预期
• 但用同一查询创建物化视图后，StatusCode字段写入值全部为0；将字段类型改为LowCardinality(String)后，写入的是空字符串（对应类型的零值）

根因分析 #

物化视图的字段映射逻辑与普通INSERT语句存在差异：普通INSERT INTO tbl (col1, col2) SELECT val1, val2仅依赖列顺序匹配即可，但物化视图要求查询返回的列名必须与目标表的列名完全匹配，仅顺序一致无法正确映射字段。

解决方案 #

调整物化视图的SELECT语句，确保返回列的名称与目标表列名一一对应，示例如下：

错误写法（仅依赖列顺序） #

CREATE MATERIALIZED VIEW mv_err_rps_per_svc TO err_rps_per_svc
AS SELECT raw_code, other_value FROM source_log_table;

正确写法（列名显式匹配） #

CREATE MATERIALIZED VIEW mv_err_rps_per_svc TO err_rps_per_svc
AS SELECT raw_code AS StatusCode, other_value AS metric_value FROM source_log_table;

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