如何使用Jinja include命令将SQL文件加载到dbt宏中？

核心结论 #

不能直接在dbt宏内部设置Jinja模板渲染器，dbt的Jinja环境是预配置的，宏无法修改加载器配置。但可以通过以下两种方式解决问题：

方法一：调整文件位置或配置宏路径 #

dbt的Jinja include默认只会在**配置的宏路径（macro-paths）**下查找文件：

• 将select.sql移动到项目的macros/目录（dbt默认的宏路径）；
• 若SQL文件在自定义目录（如sql_snippets/），在dbt_project.yml中添加该路径到宏路径：

  macro-paths: ["macros", "sql_snippets"]
  

修改后原宏代码无需调整，{% include 'select.sql' %}即可正确加载文件。

方法二：使用dbt.utils.load_file读取文件 #

如果不想调整文件位置，可借助dbt内置工具函数load_file读取指定路径的SQL内容：

{% macro test_sql_macro() -%}
  {%- if execute -%}
    -- 读取项目根目录下的select.sql，可修改路径为相对项目根的路径（如sql/select.sql）
    {%- set sql_content = dbt.utils.load_file('select.sql', project_dir=var('project_dir')) -%}
    {%- call statement('do_stuff', fetch_result=True) -%}
      {{ sql_content }}
    {%- endcall -%}

    {%- set call_results = load_result('do_stuff') -%}
    {{ log("Snowflake response: " ~ call_results, info=True) }}

  {% endif %}
{%- endmacro %}

报错原因说明 #

执行dbt run-operation时，dbt的Jinja环境仅为宏路径下的文件配置了加载器，非宏路径的文件无法被include直接识别，因此抛出“no loader for this environment specified”错误。dbt不允许在宏内部修改核心的Jinja加载器配置。

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