Dbt问题：dbt_project.yml中添加query-comment未在编译代码中生效

可能的原因及解决办法 #

• 补充必要配置项：
  仅设置comment字段不足以触发注释功能，针对PostgreSQL，需要额外指定注释的添加方式。修改dbt_project.yml配置如下：

  query-comment:
    comment: 'run by {{ target.user }} in dbt'
    append: true  # 若希望注释在SQL开头，可替换为prepend: true
  

• 检查dbt版本：
  query-comment功能从dbt Core 0.19.0版本才开始支持，执行dbt --version确认版本，若版本过低请升级到符合要求的版本。

• 测试变量有效性：
  先使用固定字符串验证注释功能是否正常，比如：

  query-comment:
    comment: 'test comment from dbt'
    append: true
  

  执行dbt compile后查看target文件夹中的SQL，如果固定注释出现，说明是target.user变量未正确取值。此时可检查profiles.yml的用户配置，或改用env_var('USER')获取本地用户名。

• 排查自定义宏干扰：
  若项目中存在自定义的query_comment宏，可能会覆盖默认配置，检查项目的macros目录下是否有相关宏文件，确保其逻辑与你的需求一致。

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