DBT宏内访问字典值异常，get方法返回None如何解决

问题根因 #

返回None的核心原因是混淆了Jinja编译阶段和SQL运行阶段的执行逻辑：

• 宏里的Jinja代码（包括字典定义、.get()取值操作）是在dbt将模型编译为纯SQL的阶段执行的，这个阶段还未向数据库发起查询，完全拿不到数据表中任意行的实际存储值
• 传入的column_name在Jinja阶段只是一个代表列名的字符串（比如调用宏时写normalize_state(state)，Jinja拿到的column_name值就是字符串state），用这个字符串去字典里匹配键，自然找不到对应映射，返回None。
  原写法本质是试图在Jinja编译阶段拿到SQL运行时的行级值，两个阶段完全隔离，无法实现。

可行解决方案 #

方案1：编译期生成全量CASE WHEN分支（推荐，映射条目<100条时用） #

直接在Jinja阶段循环字典的所有键值对，拼接成标准SQL的CASE WHEN匹配逻辑，编译后生成纯原生SQL，执行性能最好。
修正后的宏代码如下：

{% macro normalize_state(column_name) -%}
{% set states_dict = {
    "Alabama" : "AL",
    "Alaska" : "AK",
    "Wyoming": "WY"
} %}
CASE
    {% for full_state_name, state_abbr in states_dict.items() %}
    WHEN {{ column_name }} = '{{ full_state_name }}' THEN '{{ state_abbr }}'
    {% endfor %}
    ELSE NULL
END
{%- endmacro %}

举个例子，调用{{ normalize_state('user_home_state') }}时，dbt编译后会生成如下纯SQL：

CASE
    WHEN user_home_state = 'Alabama' THEN 'AL'
    WHEN user_home_state = 'Alaska' THEN 'AK'
    WHEN user_home_state = 'Wyoming' THEN 'WY'
    ELSE NULL
END

不需要在运行时做Jinja取值，SQL引擎可以直接逐行匹配。

小提示：如果源数据里的州名存在大小写不统一的问题，可以把匹配条件改成WHEN LOWER({{ column_name }}) = LOWER('{{ full_state_name }}')，避免大小写导致匹配失败。

方案2：映射表JOIN（适合映射条目多、需要频繁更新的场景） #

如果州名映射条目超过上百条，或者后续需要频繁更新映射关系，不建议把字典硬编码在宏里：

• 把州名和缩写的映射关系存为csv文件，放在dbt项目的seeds目录下
• 执行dbt seed把映射表加载到数据仓库
• 业务模型里直接JOIN这张映射表拿缩写值即可，不需要写复杂的宏逻辑，后续更新映射只需要改csv文件重跑seed就行。

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