向 BigQuery 表添加元数据

向 BigQuery 表添加元数据

了解如何开始在 Knowledge Catalog（以前称为 Dataplex Universal Catalog）中管理元数据。

本快速入门介绍了如何向 BigQuery 表添加元数据。在本快速入门中，您会执行以下操作：

1. 基于公共数据集创建 BigQuery 数据集和表。

2. 创建用于定义一组相关元数据字段的模板。

   该模板称为“切面类型”。一组相关的元数据字段，用于描述数据资产的业务元数据和技术元数据，称为切面。

3. 向表添加元数据。

   在 Knowledge Catalog 中，每个数据资产都表示为一个条目。如需将元数据附加到数据资产，请向条目添加切面。

准备工作

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. Verify that billing is enabled for your Google Cloud project.

4. Enable the Dataplex and BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

所需的角色

如需获得向 BigQuery 表添加元数据所需的权限，请让管理员向您授予项目的以下 IAM 角色：

• Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
• BigQuery Data Owner (roles/bigquery.dataOwner)
• BigQuery Job User (roles/bigquery.jobUser)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

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

创建数据集和表

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

   进入 BigQuery Studio

2. 创建数据集：

   1. 在左侧窗格中，点击 探索器：

      

      如果您没有看到左侧窗格，请点击 展开左侧窗格以打开该窗格。

   2. 在探索器窗格中，找到您的项目。点击 查看操作，然后点击创建表。

   3. 在数据集 ID 字段中，输入 catalog_demo_dataset。

      对于其他字段，请保留默认值。

   4. 点击创建数据集。

3. 将公共表复制到您的数据集：

   1. 在探索器窗格中，搜索名为 bigquery-public-data.new_york_citibike.citibike_stations 的表。您可能需要设置搜索范围，以包含 bigquery-public-data 项目。

      此表是纽约市花旗单车行程数据集的一部分，该数据集是一个包含共享单车计划相关数据的公共数据集。

   2. 选择 citibike_stations 表。

   3. 点击复制。请输入以下信息：

      • 项目：选择您的项目。
      • 数据集：选择 catalog_demo_dataset。
      • 表：输入 bike_stations。

   4. 点击复制。

4. 在探索器窗格中，找到 catalog_demo_dataset 数据集，并确认 bike_stations 表列在该数据集中。

定义元数据模板：创建切面类型

1. 在 Google Cloud 控制台中，前往 Knowledge Catalog 元数据类型页面。

   前往“元数据类型”

2. 点击切面类型和代码模板标签页，然后点击自定义标签页。

3. 点击创建切面类型。

4. 在切面类型 ID 字段中，输入 data-governance-demo。

5. 对于位置，请选择 global。

6. 在模板部分中，点击添加字段。使用下表中的信息向切面类型添加多个字段：

   名称	类型	必须提供	说明
   source-of-data-asset	文本	否	-
   retention-date	日期和时间	否	-
   data-classification	枚举 添加值 Public、Sensitive 和 Confidential。	是	-
   has-pii	布尔值	是	Whether the data asset has personally identifiable information

7. 点击保存。

向表添加元数据：向条目添加切面

1. 在 Google Cloud 控制台中，前往 Knowledge Catalog 搜索页面。

   前往“搜索”

2. 在搜索框中，输入 catalog_demo_dataset。

3. 选择 bike_stations 表。

4. 向条目添加自定义切面：

   1. 在标记和切面部分中，点击可选的标记和切面旁边的 添加。

   2. 选择 data-governance-demo 切面类型。

      这会创建一个以您的切面类型为模板的切面。

   3. 输入以下值：

      • 数据资产的来源：Copied from NYC Citi Bike Trips public dataset
      • 保留日期：输入日期。
      • 数据分类：Public
      • 含有 PII：False

   4. 点击保存。

5. 如需查看您添加的元数据值，请在标记和切面部分中选择 data-governance-demo 切面。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

删除项目

若要避免产生费用，最简单的方法是删除您为本快速入门创建的项目。

注意：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. 在 Google Cloud 控制台中，前往管理资源页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

删除各个资源

如果您希望重复使用该项目，请删除您创建的资源。

1. 删除数据集

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

      进入 BigQuery Studio

   2. 在左侧窗格中，点击 探索器：

      

   3. 在探索器窗格中，搜索 catalog_demo_dataset 数据集。

   4. 点击 查看操作，然后点击删除。在系统提示时确认。

2. 删除切面类型：

   1. 在 Google Cloud 控制台中，前往 Knowledge Catalog 元数据类型页面。

      前往“元数据类型”

   2. 点击切面类型和代码模板标签页，然后点击自定义标签页。

   3. 点击 data-governance-demo 切面类型。

   4. 点击删除。在系统提示时确认。

后续步骤

• 详细了解元数据管理。
• 了解如何搜索资源。
• 了解如何使用切面和切面类型。
• 尝试 Knowledge Catalog 应用场景。