如何通过Terraform为BigQuery列添加Policy Tags？

可行性说明 #

可以通过Terraform为BigQuery表的列应用Policy Tags，但需依赖正确的Provider版本和配置方式。

步骤与代码示例 #

1. 确认Provider版本要求 #

必须使用google-beta Provider，且版本需在v3.50.0及以上（该功能在此版本正式发布）。

2. 创建Policy Tag资源（基础示例） #

先定义分类和对应的Policy Tag：

resource "google_data_catalog_taxonomy" "pii_taxonomy" {
  provider     = google-beta
  region       = "us-central1"
  display_name = "PII_Taxonomy"
  description  = "用于PII数据分类的分类体系"
}

resource "google_data_catalog_policy_tag" "pii_tag" {
  provider     = google-beta
  taxonomy     = google_data_catalog_taxonomy.pii_taxonomy.name
  display_name = "PII"
  description  = "标记包含PII信息的列"
}

3. 在BigQuery表Schema中关联Policy Tag #

在表的Schema定义里，为目标列添加policyTags字段，值为Policy Tag的完整名称。修改你的表资源如下：

resource "google_bigquery_table" "table_with_pii" {
  provider     = google-beta
  dataset_id   = google_bigquery_dataset.integration_testing_dataset.dataset_id
  table_id     = "table_with_pii"

  schema = <<EOF
[
  {
    "name": "col1",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "This is col1. It's a PII column.",
    "policyTags": {
      "names": ["${google_data_catalog_policy_tag.pii_tag.name}"]
    }
  },
  {
    "name": "col2",
    "type": "BOOLEAN",
    "mode": "NULLABLE",
    "description": "This is col2"
  }
]
EOF
}

常见错误排查 #

你遇到的policy_tags不是有效选项的错误，原因通常是：

• 使用了低于v3.50.0的google-beta Provider版本，未支持该配置；
• 错误地在google_bigquery_table资源的顶层配置policy_tags，而非在Schema的列定义中添加policyTags字段（注意大小写：是驼峰式的policyTags而非下划线式的policy_tags）。

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