如何在dbt run-operation的参数中正确解析环境变量？

问题原因 #

你用单引号包裹了--args的JSON参数内容，而shell不会解析单引号内部的环境变量，导致$COLOUR_NAME被原样传递给dbt，没有替换为实际的环境变量值。

解决方案 #

方法1：替换外层引号并转义内部双引号 #

将外层的单引号改为双引号，同时对JSON内部的双引号添加反斜杠转义，让shell先解析环境变量，再传递正确的JSON：

dbt run-operation my_macros --args "{\"model\":\"abc\", \"colour\":\"$COLOUR_NAME\"}"

方法2：先构造JSON变量再传递 #

先把包含环境变量的JSON赋值给一个shell变量，再传给dbt，可读性更强：

ARGS_JSON="{\"model\":\"abc\", \"colour\":\"$COLOUR_NAME\"}"
dbt run-operation my_macros --args "$ARGS_JSON"

方法3：在宏内部直接读取环境变量（推荐） #

修改你的my_macros宏，直接通过dbt内置的env_var函数读取环境变量，避免命令行的引号转义麻烦：

{% macro my_macros(model, colour=None) %}
    {% set colour_value = colour or env_var('COLOUR_NAME') %}
    -- 这里写你的宏逻辑，使用colour_value变量
{% endmacro %}

之后执行命令时无需传递colour参数（需要覆盖时再传）：

dbt run-operation my_macros --args '{"model":"abc"}'

方法4：用jq构造安全的JSON（处理特殊字符） #

如果环境变量包含双引号、反斜杠等特殊字符，用jq工具生成正确转义的JSON更可靠：

dbt run-operation my_macros --args "$(jq -n --arg model abc --arg colour "$COLOUR_NAME" '{model: $model, colour: $colour}')"

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