dbt宏使用ref().identifier触发解析错误，请求排查问题

这个解析错误的核心是dbt的预解析机制对宏参数中直接传入的ref()调用处理逻辑导致的：

• dbt在解析宏调用时，会优先解析参数中的所有表达式。当你直接把ref('model_name')作为参数传入宏时，dbt会将这个ref()的执行过程识别为一个独立的「内联查询操作（inline_query）」，但这个临时操作并没有被注册到dbt的依赖节点图中，因此触发了「找不到名为inline_query的节点」的错误。
• 而当你改用字符串传递模型名、在宏内部调用ref()时，dbt能正确识别这是对现有模型的依赖引用，不会生成额外的未注册内联节点，因此可以正常运行。

你不需要放弃dbt Cloud的模型名自动补全功能，只需要调整宏的参数设计和内部逻辑即可：

1. 修改宏定义，接收模型名字符串而非ref()调用结果 #

{% macro load_with_schema_info(tables) %}
    -- 生成Schema信息注释逻辑（保留你的原有实现）
    {% set schema_comments %}
        -- 模型Schema信息自动生成注释
        {% for alias, model_name in tables %}
            -- {{ alias }} 对应模型：{{ model_name }}，Schema: {{ ref(model_name).schema }}
        {% endfor %}
    {% endset %}

    -- 生成带别名的WITH子句
    {% set with_clause %}
        WITH
        {% for alias, model_name in tables %}
            {{ alias }} AS (
                {{ select_star(ref(model_name)) }}
            ){% if not loop.last %},{% endif %}
        {% endfor %}
    {% endset %}

    {{ schema_comments }}
    {{ with_clause }}
{% endmacro %}

2. 调用宏时传递模型名字符串 #

{{ load_with_schema_info([
    ('user_alias', 'stg_users'),
    ('order_alias', 'stg_orders')
]) }}

为什么这个方案能保留自动补全？ #

dbt Cloud的模型名自动补全功能会识别宏内部ref()函数的参数，当你在调用宏输入模型名字符串时，编辑器会自动弹出对应项目下的模型列表供你选择，完全不影响使用体验。

如果调整后仍有问题，检查以下内容：

• 确认宏内部没有使用dbt_utils.inline_query或其他会生成内联查询的宏，这类宏也可能触发类似的依赖识别错误。
• 检查项目中是否存在名为inline_query的模型/宏，排除命名冲突的可能。

内容的提问来源于stack exchange，提问作者Tim Choongjae Lee