添加 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. 在 Files 窗格中，展开 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

后续步骤