在dbt SQL中集成GCP标签遇报错，求@@符号解析问题原因

直接在SQL文件内添加SET @@query_label = "key1:value1,key2:value2";会报错，核心原因是dbt的SQL执行逻辑：dbt默认将模型内的SQL当作单一查询块处理，而BigQuery的会话变量设置语句需要单独作为独立语句执行，不能与后续的数据查询/写入语句放在同一个块中。

解决方法如下：

1. 单模型配置（推荐） #

在模型的配置段中使用pre-hook，让dbt在执行模型SQL前单独运行标签设置语句：

{{ config(
    pre_hook="SET @@query_label = 'key1:value1,key2:value2';"
) }}

-- 你的模型核心SQL逻辑
SELECT col1, col2 FROM your_source_table

2. 全局批量配置 #

如果需要给所有模型统一设置标签，在dbt_project.yml中添加全局pre-hook配置：

models:
  <你的项目名称>:
    +pre-hook: "SET @@query_label = 'global_tag_key:global_tag_value';"

注意事项 #

• 钩子语句内建议用单引号包裹标签内容，避免与SQL中的双引号产生冲突
• 确保使用的dbt-bigquery适配器版本≥1.0.0，旧版本对BigQuery会话变量的支持存在兼容性问题

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