为表、视图和数据集添加标记

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在探索器窗格中，选择您要在其中创建数据集的项目。

3. 点击 more_vert 查看操作 > 创建数据集。

4. 输入新数据集的信息。如需了解详情，请参阅创建数据集。

5. 展开标记部分。

   1. 如需应用现有标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择当前范围 - 选择当前组织或选择当前项目。

         或者，点击选择范围以搜索资源或查看当前资源列表。

      2. 对于键 1 和值 1，请从列表中选择适当的值。

   2. 如需手动输入新标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择手动输入 ID > 组织、项目或标记。

      2. 如果您要为项目或组织创建标记，请在对话框中输入 PROJECT_ID 或 ORGANIZATION_ID，然后点击保存。

      3. 对于键 1 和值 1，请从列表中选择适当的值。

   3. 可选：如需向表中添加其他标记，请点击添加标记，然后按照上面的步骤操作。

6. 点击创建数据集。

SQL

使用 CREATE SCHEMA 语句。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   CREATE SCHEMA PROJECT_ID.DATASET_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：您要创建的数据集的 ID。
   • TAG_KEY_1：您要将其设置为数据集的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

使用带有 --add_tags 标志的 bq mk --dataset 命令：

bq mk --dataset \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

替换以下内容：

• TAG：您要附加到新数据集的标记。多个标记之间以英文逗号分隔。例如 556741164180/env:prod,myProject/department:sales。每个标记必须具有命名空间键名称和值简称。
• PROJECT_ID：您要在其中创建数据集的项目的 ID。
• DATASET_ID：新数据集的 ID。

Terraform

使用 google_bigquery_dataset 资源。

如需向 BigQuery 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为客户端库设置身份验证。

以下示例会创建一个名为 my_dataset 的数据集，然后通过填充 resource_tags 字段将标记附加到该数据集：

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env2"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department2"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "my_dataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days

  # Attach tags to the dataset
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

如需在 Google Cloud 项目中应用 Terraform 配置，请完成以下部分中的步骤。

准备 Cloud Shell

1. 启动 Cloud Shell。

2. 设置要应用 Terraform 配置的默认 Google Cloud 项目。

   您只需为每个项目运行一次以下命令，即可在任何目录中运行它。

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   如果您在 Terraform 配置文件中设置显式值，则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录（也称为“根模块”）。

1. 在 Cloud Shell 中，创建一个目录，并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名，例如 main.tf。在本教程中，该文件称为 main.tf。

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 如果您按照教程进行操作，可以在每个部分或步骤中复制示例代码。

   将示例代码复制到新创建的 main.tf 中。

   （可选）从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段，则建议这样做。

3. 查看和修改要应用到您的环境的示例参数。
4. 保存更改。
5. 初始化 Terraform。您只需为每个目录执行一次此操作。

   terraform init

   （可选）如需使用最新的 Google 提供程序版本，请添加 -upgrade 选项：

   terraform init -upgrade

应用更改

1. 查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期：

   terraform plan

   根据需要更正配置。

2. 通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置：

   terraform apply

   等待 Terraform 显示“应用完成！”消息。

3. 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源，以确保 Terraform 已创建或更新它们。

API

调用 datasets.insert 方法，并将标记添加到 resource_tags 字段。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在浏览器窗格中，展开您的项目，然后选择数据集。

3. 在数据集信息部分中，点击 mode_edit 修改详细信息。

4. 展开标记部分。

   1. 如需应用现有标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择当前范围 - 选择当前组织或选择当前项目。

         或者，点击选择范围以搜索资源或查看当前资源列表。

      2. 对于键 1 和值 1，请从列表中选择适当的值。

   2. 如需手动输入新标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择手动输入 ID > 组织、项目或标记。

      2. 如果您要为项目或组织创建标记，请在对话框中输入 PROJECT_ID 或 ORGANIZATION_ID，然后点击保存。

      3. 对于键 1 和值 1，请从列表中选择适当的值。

   3. 可选：如需向表中添加其他标记，请点击添加标记，然后按照上面的步骤操作。

5. 点击保存。

SQL

使用 ALTER SCHEMA SET OPTIONS 语句。

以下示例会覆盖现有数据集的所有标记。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要添加标记的表的名称。
   • TAG_KEY_1：您要将其设置为表的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

以下示例使用 += 运算符将标记附加到数据集，而不会覆盖现有标记。如果某个现有标记具有相同的键，则该标记会被覆盖。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要添加标记的表的名称。
   • TAG_KEY_1：您要将其设置为表的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

使用带有 --add_tags 标志的 bq update 命令：

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

替换以下内容：

• TAG：您要附加到数据集的标记。多个标记之间以英文逗号分隔。例如 556741164180/env:prod,myProject/department:sales。每个标记必须具有命名空间键名称和值简称。
• PROJECT_ID：现有数据集所在项目的 ID。
• DATASET_ID：现有数据集的 ID。

gcloud

如需使用命令行将标记附加到数据集，请使用 gcloud resource-manager tags bindings create 命令创建标记绑定资源：

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• TAG_VALUE_NAME：要附加的标记值的永久 ID 或命名空间名称，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：数据集的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)，例如 //bigquery.googleapis.com/projects/my_project/datasets/my_dataset。
• LOCATION：您的数据集所在的位置。

Terraform

向数据集的 resource_tags 字段添加标记，然后使用 google_bigquery_dataset 资源应用更新后的配置。如需了解详情，请参阅创建新数据集时附加标签中的 Terraform 示例。

API

调用 datasets.get 方法以获取数据集资源，包括 resource_tags 字段。将标记添加到 resource_tags 字段，然后使用 datasets.update 方法传递回更新后的数据集资源。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在浏览器窗格中，展开您的项目，然后选择数据集。

   标记会显示在数据集信息部分中。

bq

如需列出附加到数据集的标记，请使用 bq show 命令。

bq show PROJECT_ID:DATASET_ID

替换以下内容：

• PROJECT_ID：包含数据集的项目的 ID。
• DATASET_ID：要为其列出标记的数据集的 ID。

gcloud

如需获取附加到资源的标记绑定的列表，请使用 gcloud resource-manager tags bindings list 命令：

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• RESOURCE_ID：数据集的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)，例如 //bigquery.googleapis.com/projects/my_project/datasets/my_dataset。

• LOCATION：您的数据集所在的位置。

输出类似于以下内容：

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

使用 terraform state show 命令列出数据集的属性，包括 resource_tags 字段。在运行数据集的 Terraform 配置文件的目录中运行此命令。

terraform state show google_bigquery_dataset.default

API

调用 datasets.get 方法以获取数据集资源。数据集资源包含 resource_tags 字段中附加到数据集的标记。

视图

使用 INFORMATION_SCHEMA.SCHEMATA_OPTIONS 视图。

例如，以下查询会显示某个区域中所有数据集附加的所有标记。此查询会返回一个表，其中的列包括 schema_name（数据集名称）、option_name（始终为 'tags'）、object_type（始终为 ARRAY<STRUCT<STRING, STRING>>）和 option_value，该表包含 STRUCT 对象数组，表示与每个数据集关联的标记。对于未分配标记的数据集，option_value 列会返回一个空数组。

SELECT * from region-REGION.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE option_name='tags'

替换以下内容：

• REGION：您的数据集所在的区域。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在浏览器窗格中，展开您的项目，然后选择数据集。

3. 在数据集信息部分中，点击 mode_edit 修改详细信息。

4. 在标记部分中，点击要删除的标记旁边的 delete 删除项。

5. 点击保存。

SQL

使用 ALTER SCHEMA SET OPTIONS 语句。

以下示例使用 -= 运算符从数据集中分离标记。如需从数据集中分离所有标记，您可以指定 tags=NULL 或 tags=[]。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要从中分离标记的表的名称。
   • TAG_KEY_1：要分离的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：要分离的标记的值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：要分离的第二个标记的命名空间键名称。
   • TAG_VALUE_2：要分离的第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

使用带有 --remove_tags 标志的 bq update 命令：

bq update \
    --remove_tags=REMOVED_TAG \
    PROJECT_ID:DATASET_ID

替换以下内容：

• REMOVED_TAG：要从数据集中移除的标记。多个标记之间以英文逗号分隔。仅接受不带值的键对。例如 556741164180/env,myProject/department。 每个标记都必须具有命名空间键名称。
• PROJECT_ID：包含数据集的项目的 ID。
• DATASET_ID：要从中分离标记的数据集的 ID。

或者，如果您想从数据集中移除所有标记，请将 bq update 命令与 --clear_all_tags 标志结合使用：

bq update \
    --clear_all_tags
    PROJECT_ID:DATASET_ID

gcloud

如需使用命令行从数据集中分离标记，请使用 gcloud resource-manager tags bindings delete 命令删除标记绑定：

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• TAG_VALUE_NAME：要分离的标记值的永久 ID 或命名空间名称，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：数据集的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)，例如 //bigquery.googleapis.com/projects/my_project/datasets/my_dataset。
• LOCATION：您的数据集所在的位置。

Terraform

从数据集的 resource_tags 字段中移除标记，然后使用 google_bigquery_dataset 资源应用更新后的配置。

API

调用 datasets.get 方法以获取数据集资源，包括 resource_tags 字段。从 resource_tags 字段中移除标记，然后使用 datasets.update 方法传递回更新后的数据集资源。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在探索器窗格中，展开您的项目，然后选择数据集。

3. 在数据集信息部分中，点击 add_box 创建表。

4. 输入新表格的信息。如需了解详情，请参阅创建和使用表。

5. 展开标记部分。

   1. 如需应用现有标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择当前范围 - 选择当前组织或选择当前项目。

         或者，点击选择范围以搜索资源或查看当前资源列表。

      2. 对于键 1 和值 1，请从列表中选择适当的值。

   2. 如需手动输入新标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择手动输入 ID > 组织、项目或标记。

      2. 如果您要为项目或组织创建标记，请在对话框中输入 PROJECT_ID 或 ORGANIZATION_ID，然后点击保存。

      3. 对于键 1 和值 1，请从列表中选择适当的值。

   3. 可选：如需向表中添加其他标记，请点击添加标记，然后按照上面的步骤操作。

6. 点击创建表。

SQL

使用 CREATE TABLE 语句。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   CREATE TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：要在其中创建表的数据集的 ID。
   • TABLE_ID：新表的名称。
   • TAG_KEY_1：您要将其设置为表的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

使用带有 --add_tags 标志的 bq mk --table 命令：

bq mk --table \
    --schema=SCHEMA \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

替换以下内容：

• SCHEMA：内嵌架构定义。
• TAG：要附加到新表的标记。多个标记之间以英文逗号分隔。例如 556741164180/env:prod,myProject/department:sales。每个标记必须具有命名空间键名称和值简称。
• PROJECT_ID：要在其中创建表的项目的 ID。
• DATASET_ID：要在其中创建表的数据集的 ID。
• TABLE_ID：新表的 ID。

Terraform

使用 google_bigquery_table 资源。

如需向 BigQuery 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅为客户端库设置身份验证。

以下示例会创建一个名为 mytable 的表，然后通过填充 resource_tags 字段将标记附加到该表：

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env3"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department3"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "MyDataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days
}

# Create a table
resource "google_bigquery_table" "default" {
  dataset_id          = google_bigquery_dataset.default.dataset_id
  table_id            = "mytable"
  description         = "table description"
  deletion_protection = false # set to "true" in production

  # Attach tags to the table
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

如需在 Google Cloud 项目中应用 Terraform 配置，请完成以下部分中的步骤。

准备 Cloud Shell

1. 启动 Cloud Shell。

2. 设置要应用 Terraform 配置的默认 Google Cloud 项目。

   您只需为每个项目运行一次以下命令，即可在任何目录中运行它。

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   如果您在 Terraform 配置文件中设置显式值，则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录（也称为“根模块”）。

1. 在 Cloud Shell 中，创建一个目录，并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名，例如 main.tf。在本教程中，该文件称为 main.tf。

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 如果您按照教程进行操作，可以在每个部分或步骤中复制示例代码。

   将示例代码复制到新创建的 main.tf 中。

   （可选）从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段，则建议这样做。

3. 查看和修改要应用到您的环境的示例参数。
4. 保存更改。
5. 初始化 Terraform。您只需为每个目录执行一次此操作。

   terraform init

   （可选）如需使用最新的 Google 提供程序版本，请添加 -upgrade 选项：

   terraform init -upgrade

应用更改

1. 查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期：

   terraform plan

   根据需要更正配置。

2. 通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置：

   terraform apply

   等待 Terraform 显示“应用完成！”消息。

3. 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源，以确保 Terraform 已创建或更新它们。

API

使用定义的表资源调用 tables.insert 方法。在 resource_tags 字段中添加标记。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在探索器窗格中，展开您的项目和数据集，然后选择表。

3. 点击详情标签页，然后点击 mode_edit 修改详情。

4. 展开标记部分。

   1. 如需应用现有标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择当前范围 - 选择当前组织或选择当前项目。

         或者，点击选择范围以搜索资源或查看当前资源列表。

      2. 对于键 1 和值 1，请从列表中选择适当的值。

   2. 如需手动输入新标记，请执行以下操作：

      1. 点击选择范围旁边的下拉箭头，然后选择手动输入 ID > 组织、项目或标记。

      2. 如果您要为项目或组织创建标记，请在对话框中输入 PROJECT_ID 或 ORGANIZATION_ID，然后点击保存。

      3. 对于键 1 和值 1，请从列表中选择适当的值。

   3. 可选：如需向表中添加其他标记，请点击添加标记，然后按照上面的步骤操作。

5. 点击保存。

SQL

使用 ALTER TABLE SET OPTIONS 语句。

以下示例会覆盖现有表的所有标记。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要添加标记的表的名称。
   • TAG_KEY_1：您要将其设置为表的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

以下示例使用 += 运算符将标记附加到表，而不会覆盖现有标记。如果某个现有标记具有相同的键，则该标记会被覆盖。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要添加标记的表的名称。
   • TAG_KEY_1：您要将其设置为表的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：标记值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二个标记的命名空间键名称。
   • TAG_VALUE_2：第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

使用带有 --add_tags 标志的 bq update 命令：

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

替换以下内容：

• TAG：要附加到表的标记。多个标记之间以英文逗号分隔。例如 556741164180/env:prod,myProject/department:sales。每个标记必须具有命名空间键名称和值简称。
• PROJECT_ID：包含表的项目的 ID。
• DATASET_ID：包含表的数据集的 ID。
• TABLE_ID：您要更新的表的 ID。

gcloud

如需使用命令行将标记附加到表，请使用 gcloud resource-manager tags bindings create 命令创建标记绑定资源：

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• TAG_VALUE_NAME：要附加的标记值的永久 ID 或命名空间名称，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：表的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)。例如，//bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table
• LOCATION：表的位置。

Terraform

向表的 resource_tags 字段添加标记，然后使用 google_bigquery_table 资源应用更新后的配置。如需了解详情，请参阅在创建新表时附加标签中的 Terraform 示例。

API

使用定义的表资源调用 tables.update 方法。在 resource_tags 字段中添加标记。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在探索器窗格中，展开您的项目和数据集，然后选择表。

   这些标记会显示在详细信息标签页中。

bq

使用 bq show 命令并查找 tags 列。如果表中没有标记，则不会显示 tags 列。

bq show \
    PROJECT_ID:DATASET_ID.TABLE_ID

替换以下内容：

• PROJECT_ID：包含表的项目的 ID。
• DATASET_ID：包含表的数据集的 ID。
• TABLE_ID：表的 ID。

gcloud

如需获取附加到资源的标记绑定的列表，请使用 gcloud resource-manager tags bindings list 命令：

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• RESOURCE_ID：表的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)。例如 //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table。

• LOCATION：您的数据集所在的位置。

输出类似于以下内容：

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

使用 terraform state show 命令列出表的属性，包括 resource_tags 字段。在运行表的 Terraform 配置文件的目录中运行此命令。

terraform state show google_bigquery_table.default

API

使用定义的表资源调用 tables.get 方法，并查找 resource_tags 字段。

视图

使用 INFORMATION_SCHEMA.TABLE_OPTIONS 视图。

例如，以下查询会显示数据集中所有表附加的所有标记。此查询会返回一个表，其中的列包括 schema_name（数据集名称）、option_name（始终为 'tags'）、object_type（始终为 ARRAY<STRUCT<STRING, STRING>>）和 option_value，该表包含 STRUCT 对象数组，表示与每个数据集关联的标记。对于未分配标记的表，option_value 列会返回一个空数组。

SELECT * from DATASET_ID.INFORMATION_SCHEMA.TABLE_OPTIONS
WHERE option_name='tags'

将 DATASET_ID 替换为包含表的数据集的 ID。

控制台

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在探索器窗格中，展开您的项目和数据集，然后选择表。

3. 点击详情标签页，然后点击 mode_edit 修改详情。

4. 在标记部分中，点击要删除的标记旁边的 delete 删除项。

5. 点击保存。

SQL

使用 ALTER TABLE SET OPTIONS 语句。

以下示例使用 -= 运算符从表中分离标记。如需从表中分离所有标记，您可以指定 tags=NULL 或 tags=[]。

1. 在 Google Cloud 控制台中，前往 BigQuery 页面。

   转到 BigQuery

2. 在查询编辑器中，输入以下语句：

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   请替换以下内容：

   • PROJECT_ID：您的项目 ID。
   • DATASET_ID：包含表的数据集的 ID。
   • TABLE_ID：要从中分离标记的表的名称。
   • TAG_KEY_1：要分离的第一个标记的命名空间键名称，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：要分离的标记的值的简称，例如 'prod' 或 'sales'。
   • TAG_KEY_2：要分离的第二个标记的命名空间键名称。
   • TAG_VALUE_2：要分离的第二个标记的值的简称。

3. 点击 play_circle 运行。

如需详细了解如何运行查询，请参阅运行交互式查询。

bq

如需从表中移除某些标记，请将 bq update 命令与 --remove_tags 标志结合使用：

bq update \
    --remove_tags=TAG_KEYS \
    PROJECT_ID:DATASET_ID.TABLE_ID

替换以下内容：

• TAG_KEYS：要从表中分离的标记键，以英文逗号分隔。例如 556741164180/env,myProject/department。每个标记键都必须具有命名空间键名称。
• PROJECT_ID：包含表的项目的 ID。
• DATASET_ID：包含表的数据集的 ID。
• TABLE_ID：您要更新的表的 ID。

如需从表中移除所有标记，请将 bq update 命令与 --clear_all_tags 标志结合使用：

bq update \
    --clear_all_tags \
    PROJECT_ID:DATASET_ID.TABLE_ID

gcloud

如需使用命令行从表中移除标记关联，请使用 gcloud resource-manager tags bindings delete 命令删除标记绑定：

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

替换以下内容：

• TAG_VALUE_NAME：要删除的标记值的永久 ID 或命名空间名称，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：表的完整 ID，包括用于标识资源类型的 API 域名 (//bigquery.googleapis.com/)。例如 //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table。
• LOCATION：您的数据集所在的位置。

Terraform

从表的 resource_tags 字段中移除标记，然后使用 google_bigquery_table 资源应用更新后的配置。

API

使用定义的表资源调用 tables.update 方法，并移除 resource_tags 字段中的标记。如需移除所有标记，请移除 resource_tags 字段。