能否将BigQuery项目级Saved Queries与Scheduled Queries导出为Terraform代码？

Scheduled Queries：完全可行 #

Terraform的Google Cloud Provider提供了google_bigquery_data_transfer_config资源，专门用于管理BigQuery的定时查询（Scheduled Queries本质属于Data Transfer Service的一种类型）。你可以通过这个资源完整迁移项目中的定时查询，包括调度规则、查询语句、目标表配置等核心属性。

示例配置：

resource "google_bigquery_data_transfer_config" "daily_sales_query" {
  display_name        = "每日销售数据汇总"
  location            = "asia-east1"
  data_source_id      = "scheduled_query"
  project_id          = "target-project-id"

  params = {
    query                          = file("${path.module}/queries/daily_sales.sql")
    destination_table_name_template = "sales_summary_{run_time}"
    write_disposition              = "WRITE_TRUNCATE"
    partition_field                = "sale_date"
  }

  schedule = "every day 00:00"
}

Saved Queries：无原生资源支持，可通过替代方案实现 #

目前Terraform官方Google Provider没有直接对应BigQuery Saved Queries的资源（这类查询属于UI层面的项目级保存对象，未被封装为标准Terraform资源），但可以通过以下两种方式完成迁移：

方案1：用gcloud CLI配合null_resource导入 #

借助null_resource和gcloud命令，将本地保存的Saved Query SQL内容导入到目标项目：

resource "null_resource" "import_saved_queries" {
  for_each = fileset("${path.module}/saved_queries", "*.sql")

  triggers = {
    query_file = each.value
    query_content = file("${path.module}/saved_queries/${each.value}")
    query_id = replace(each.value, ".sql", "")
  }

  provisioner "local-exec" {
    command = <<EOT
      bq mk --query \
        --description "迁移的Saved Query" \
        --project_id=target-project-id \
        ${self.triggers.query_id} \
        "${self.triggers.query_content}"
    EOT
  }
}

注意：执行Terraform的环境需要安装并授权gcloud CLI，确保有权限操作目标项目的BigQuery资源。

方案2：用BigQuery Routine替代 #

如果不需要严格对应UI中的Saved Queries入口，可以用google_bigquery_routine将查询语句封装为存储过程或函数，实现查询语句的复用和版本管理：

resource "google_bigquery_routine" "saved_query_routine" {
  dataset_id = "target-dataset-id"
  project_id = "target-project-id"
  routine_id = "customer_segment_query"

  routine_type = "PROCEDURE"
  definition_body = file("${path.module}/saved_queries/customer_segment.sql")
}

这种方式的优势是完全基于Terraform原生资源，无需依赖外部CLI，但和原生Saved Queries的使用场景略有差异。

内容的提问来源于stack exchange，提问作者Ziya Mert Karakas