dbt多唯一键增量模型中，如何用Jinja引用组合唯一键？

你完全不需要手动哈希多列唯一键，dbt本身就支持直接基于列表形式的unique_key生成匹配逻辑，下面是具体实现方式：

1. 直接利用dbt内置增量策略（最省心） #

如果用dbt默认的merge增量策略，只要在模型配置里正确设置列表形式的unique_key，dbt会自动生成包含所有列匹配的MERGE语句，根本不用自己写WHERE条件：

{{ config(
  materialized='incremental',
  unique_key=['col1', 'col2', 'col3']
) }}

当模型运行时，dbt会自动生成类似target.col1 = source.col1 AND target.col2 = source.col2 AND target.col3 = source.col3的匹配条件，自动完成更新和插入逻辑。

2. 自定义增量逻辑时生成匹配条件 #

如果需要手动写MERGE、UPDATE或INSERT语句，可以通过Jinja直接读取模型配置里的unique_key列表，循环生成匹配条件：

{% set unique_key_cols = model.config.unique_key %}
{% set match_clause = [] %}

{% for col in unique_key_cols %}
  {% do match_clause.append("target." ~ col ~ " = source." ~ col) %}
{% endfor %}

{% set match_condition = match_clause | join(' AND ') %}

-- 在自定义SQL中使用生成好的匹配条件
MERGE INTO {{ this }} AS target
USING {{ ref('stg_your_source_table') }} AS source
ON {{ match_condition }}
WHEN MATCHED THEN
  UPDATE SET
    col4 = source.col4,
    updated_at = CURRENT_TIMESTAMP
WHEN NOT MATCHED THEN
  INSERT (col1, col2, col3, col4, created_at)
  VALUES (source.col1, source.col2, source.col3, source.col4, CURRENT_TIMESTAMP);

这里model.config.unique_key会直接读取你在模型配置中定义的多列唯一键列表，无需重复硬编码。如果列名包含特殊字符，可加上escape_sql过滤器处理：

{% do match_clause.append("target." ~ col | escape_sql ~ " = source." ~ col | escape_sql) %}

3. 注意事项 #

• 确保源表和目标表的唯一键列名完全一致，若有差异，可在循环中添加列名映射逻辑
• 除非有特定的性能优化需求，否则不要手动哈希组合键，dbt的原生匹配逻辑已经足够高效且易维护

内容的提问来源于stack exchange，提问作者Umar.H