如何在DBT中为BigQuery表添加NOT ENFORCED主键？

DBT本身没有原生配置项直接定义带NOT ENFORCED的主键，但可以通过post-hook实现需求，这是最直接的方式。

方法一：模型级post-hook实现 #

在你的模型文件顶部添加配置，指定物化类型为table，并通过post-hook执行ALTER TABLE语句：

-- models/my_model.sql
{{ config(
    materialized='table',
    post_hook="ALTER TABLE {{ this }} ADD primary key(column1) NOT ENFORCED"
) }}

with my_model as (
  select
    column1,
    column2,
    column3
  from
    source_table
)

select
  column1,
  column2,
  column3
from
  my_model

关键细节说明 #

• {{ this }}是DBT内置变量，会自动替换为当前模型的全限定表名（包含数据库、schema），避免硬编码表名引发的环境适配问题。
• 必须确保column1是模型输出的有效字段，否则ALTER语句会执行失败。
• 不同数据仓库的主键语法可能略有差异，比如Snowflake、Databricks均支持NOT ENFORCED语法，但部分细节需根据你的实际仓库调整。

可选：全局配置（多模型复用场景） #

如果多个模型需要添加同类约束，可在dbt_project.yml中配置全局post-hook，但更推荐模型级配置，保持每个模型的独立性和可维护性。

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