Terraform中使用HEREDOC导致资源频繁触发更新问题求助

问题根源 #

你遇到的问题本质是HEREDOC生成的字符串包含多余的缩进空格、换行符，而GCP后端存储的查询字符串会自动压缩或标准化空白格式。Terraform在执行plan时，会将本地生成的带冗余空白的字符串与GCP返回的标准化字符串比对，判定为不一致，从而触发资源更新。

可行解决方案 #

方案1：用trimspace函数清理冗余空白 #

通过trimspace()函数去除HEREDOC字符串首尾的空白（包括换行、空格），同时保留SQL内部合理的缩进（不影响BigQuery执行）。修改后的locals块如下：

locals {
  local_query = trimspace(<<-EOT
    SELECT
        table_a.*,
        table_b.*
    FROM `${var.project_id}.dataset.table_a` as table_a
    JOIN `${var.project_id}.dataset.table_b` as table_b ON table_b.table_a_id = table_a.id
  EOT)
}

注意：原SQL中table_b.*,末尾的多余逗号会导致语法错误，建议一并移除。

方案2：使用templatefile分离SQL文件 #

将长SQL写入单独的模板文件，既保持代码可读性，又能通过templatefile函数生成标准化的字符串：

1. 在Terraform模块目录下创建refresh_view_query.tpl文件：

SELECT
    table_a.*,
    table_b.*
FROM `${project_id}.dataset.table_a` as table_a
JOIN `${project_id}.dataset.table_b` as table_b ON table_b.table_a_id = table_a.id

2. 在Terraform配置中引用该模板：

locals {
  local_query = templatefile("${path.module}/refresh_view_query.tpl", {
    project_id = var.project_id
  })
}

这种方式更适合超长篇SQL，同时templatefile会自动处理模板中的变量替换，生成的字符串不会包含多余的空白。

验证 #

修改配置后执行terraform plan，如果查询内容未变更，query参数将不再触发资源更新操作。

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