添加 BigQuery 标签

本文档介绍如何在 Dataform 中为表添加标签。

BigQuery 支持为资源添加标签。如需详细了解 BigQuery 中的标签，请参阅标签简介。

准备工作

  1. 在 Google Cloud 控制台中，转到 Dataform 页面。

    转到 Dataform 页面

  2. 选择或创建代码库。

  3. 选择或创建开发工作区。

  4. 创建表。

所需的角色

如需获取向 BigQuery 添加表的 BigQuery 标签所需的权限，请让管理员授予您工作区上的 Dataform Editor (roles/dataform.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

添加 BigQuery 标签

如需将 BigQuery 标签添加到 Dataform 中的表，请将该标签添加到表定义 SQLX 文件的 config 代码块中的 bigquery 代码块。

如需向表定义文件添加 BigQuery 标签，请按以下步骤操作：

  1. 转到您的开发工作区。
  2. 在 Files 窗格中，展开 definitions/。
  3. 选择 SQLX 表定义文件。

  4. 在 config 代码块中，添加以下格式的标签：

    bigquery: {
    labels: {
      LABEL1: "VALUE_OF_LABEL1"
    }
  }

  5. 将 LABEL1 替换为您的标签的名称。

  6. 将 VALUE_OF_LABEL1 替换为您的标签的值。

  7. 可选：如需添加名称包含特殊字符的标签，请使用引号 "" 输入标签名称。

以下代码示例显示了 department:shipping 和 cost-center:logistics 标签，它们添加到分区表定义 SQLX 文件中的 bigquery 代码块中：

config {
  type: "table",
  bigquery: {
    partitionBy: "DATE(ts)",
    labels: {
      department: "shipping",
      "cost-center": "logistics"
    }
  }
}

SELECT CURRENT_TIMESTAMP() AS ts

后续步骤