如何为多个dbt模型定义统一的模型属性模板

问题背景 #

我有多个dbt模型（modelA、modelB、modelC），各自SQL查询逻辑不同，但输出表结构完全一致（均包含country和val列）。当前在models/model_schema.yml中，每个模型的列描述、测试规则等配置完全重复，希望通过单一模板简化配置，同时保留独立模型文件。

可行实现方法 #

方法一：在schema.yml中用Jinja循环批量生成配置 #

直接在YAML文件中嵌入Jinja循环，遍历模型列表生成重复配置，只需维护一套列规则即可。

示例代码：

# models/model_schema.yml
version: 2

{% set target_models = ['modelA', 'modelB', 'modelC'] %}

models:
  {% for model_name in target_models %}
  - name: {{ model_name }}
    description: "A starter dbt model {{ model_name }}"
    columns:
      - name: country
        description: "The primary key for this table"
        tests:
          - unique
          - not_null
      - name: val
        description: "value for the table"
  {% endfor %}

dbt编译时会自动将循环展开为完整的多模型配置，效果与手动重复编写完全一致，后续新增同结构模型只需修改target_models列表即可。

方法二：标签+批量配置分离描述与列规则 #

如果需要保留每个模型的个性化描述，同时统一列配置，可以用标签实现：

1. 给每个模型添加统一标签（在模型SQL文件开头）：

{{ config(tags=['shared_output']) }}
select country, val from ...

2. 在schema.yml中针对标签配置通用列规则，单独维护模型描述：

# models/model_schema.yml
version: 2

# 统一列配置应用到所有带shared_output标签的模型
models:
  - tag: shared_output
    columns:
      - name: country
        description: "The primary key for this table"
        tests:
          - unique
          - not_null
      - name: val
        description: "value for the table"

# 单独设置每个模型的个性化描述
  - name: modelA
    description: "A starter dbt model A"
  - name: modelB
    description: "A starter dbt model B"
  - name: modelC
    description: "A starter dbt model C"

方法三：用宏实现模型配置继承 #

编写通用配置宏，每个模型调用宏注入统一规则，无需在schema.yml中重复配置：

1. 创建配置宏：

-- macros/shared_model_config.sql
{% macro shared_model_config(model_name) %}
{{ config(
    description = "A starter dbt model " ~ model_name,
    columns = {
        "country": {
            "description": "The primary key for this table",
            "tests": ["unique", "not_null"]
        },
        "val": {
            "description": "value for the table"
        }
    }
) }}
{% endmacro %}

2. 在每个模型SQL文件开头调用宏：

{{ shared_model_config('modelA') }}
select country, val from ...

这种方式将配置逻辑完全移入宏，schema.yml可省略对应模型的重复配置，适合需要批量调整规则的场景。

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