dbt BigQuery快照每次重建表且缺失dbt专属字段如何解决

根因定位 #

你的快照配置中手动指定了materialized='table'参数，触发了错误的构建逻辑：dbt会将snapshots目录下的文件识别为普通表模型执行，而非快照本身要求的增量逻辑。这会导致每次执行全量重建表，不会生成dbt_valid_from、dbt_valid_to系统字段，也不会触发MERGE校验逻辑。

修复步骤 #

• 删除配置块中的materialized='table'行，快照模型不需要手动指定物化类型，dbt会自动识别快照目录下的文件采用snapshot类型物化。
• 手动删除BigQuery项目中已生成的错误普通表，旧表无快照专属系统字段，无法直接复用为快照表。
• 重新执行dbt snapshot，首次执行会按照快照结构新建表，后续执行会自动走正常的MERGE增量校验逻辑。

验证方法 #

修改配置后可先执行dbt compile查看编译后的SQL，确认SQL包含快照专属的有效期判断逻辑，而非普通的CREATE TABLE全量表逻辑。首次执行后检查表结构是否包含dbt_valid_from、dbt_valid_to字段，第二次执行查看运行日志是否输出MERGE操作记录即可确认功能恢复正常。

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