添加 BigQuery 标签

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

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

准备工作

  1. 在 Google Cloud 控制台中，进入 Dataform 页面。

    前往 Dataform 页面

  2. 选择或创建代码库。

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

  4. 创建表。

所需的角色

如需获得向 Dataform 表添加 BigQuery 标签所需的权限，请让您的管理员为您授予工作区的 Dataform Editor (roles/dataform.editor) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

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

添加 BigQuery 标签

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

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

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

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

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

    替换以下内容：

    • LABEL1：标签的名称
    • VALUE_OF_LABEL1：标签的值

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

  6. 可选：点击格式。

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

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

SELECT CURRENT_TIMESTAMP() AS ts

后续步骤