管理方面和丰富元数据

本文档介绍了如何创建和管理方面类型，以及如何使用方面为条目添加注释。

Dataplex Catalog 会通过一组方面来描述条目。您可以使用切面和 切面类型。

如需了解详情，请参阅 Dataplex Catalog 概览。

切面

利用切面，您可以捕获条目中的元数据。向条目添加切面 有助于为需要使用该素材资源的任何人提供有意义的背景信息。您可以 使用各个方面来存储业务元数据（例如数据分类），并 技术元数据（例如架构）。

切面被视为条目资源的一部分，而非独立 资源。修改切面时，涉及修改包含 切面。

您可以在入口点指定切面来描述条目，也可以在 列级别，用于描述条目中的列。

每个切面都是切面类型的实例。切面类型定义模板 及其各个方面。每种方面类型都包含一组字段。创建方面时，您必须为这些字段提供值。

对于给定条目，每个方面类型最多只能与该条目相关联一个方面。您可以有多个与条目列相关联的切面 每个切面类型。

注意：不支持在相应方面类型和条目位于不同 Google Cloud 组织的情况下，在条目中创建和使用方面。

切面类别

这些方面分为以下几类：

• 必需切面：创建条目时必须提供的切面。此类切面由给定条目的条目类型定义。所有条目 属于某个条目类型必须始终具有 都由该条目类型定义

  Dataplex 会管理系统条目的必要方面（例如架构）。

  请注意以下几点：

  • 您只能将必需的方面与条目相关联，而不能与条目的列相关联。

  • 您无法从条目中删除必需切面。

  • 您可以读取系统条目的必要方面，但无法对其进行修改。

• 可选切面：您可以将可选切面与条目或 条目列。您可以在输入时填充可选切面 或者稍后通过更新条目来创建。

  在填充可选切面后，您可以将其删除。

切面类型

切面类型是可重复使用的资源，可为切面提供模板。

切面类型的类别

方面类型分为以下几类：

• 自定义切面类型：您在 Dataplex Catalog。

• 系统切面类型：Dataplex 提供、使用、 和管理

  系统切面类型进一步分为可重用和受限两类。 下表介绍了系统切面类型的类别，以及 Dataplex 为每个类别提供的切面类型列表：

  系统切面类型的类别	说明	Dataplex 提供的切面类型
  可重复使用的系统切面类型	您可以使用这些切面类型创建或修改切面。	generic storage
  受限的系统方面类型	Dataplex 会管理这些方面类型。 您可以查看这些方面类型下的方面，但无法在此类方面类型下创建或修改方面。	bigquery-connection bigquery-dataset bigquery-model bigquery-routine bigquery-table bigquery-view cloudsql-database cloudsql-instance cloudsql-schema cloudsql-table cloudsql-view storage sql-access storage-bucket storage-folder

  您可以在特定地区创建自定义方面类型，也可以将其作为全球资源创建。系统切面类型始终是全局的。相应方面类型的位置会影响其适用范围。如需了解详情，请参阅 项目和位置限制条件。

准备工作

在创建和管理切面类型和切面之前，请先完成任务 具体说明。

所需的角色

如需获得创建和管理方面类型和方面所需的权限，请让管理员向您授予资源的以下 IAM 角色：

• 对所有 Dataplex Catalog 资源（包括切面类型）的完整权限： Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
• 创建和管理所有 Dataplex Catalog 资源，包括切面类型： Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• 对自定义切面类型的全部权限（使用切面类型创建或修改条目的权限除外）： Dataplex Aspect Type Owner (roles/dataplex.aspectTypeOwner)
• 查看切面类型和关联的 IAM 政策： Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• 使用切面类型创建和修改具有相应切面的条目： Dataplex Aspect Type User (roles/dataplex.aspectTypeUser)
• 添加某些系统方面类型（例如 schema、overview、contacts）的方面： Dataplex Entry Owner (roles/dataplex.entryOwner)

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

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

如需了解详情，请参阅 Dataplex IAM 角色。

启用该 API

在 Dataplex 项目中启用 Dataplex API。

启用该 API

创建切面类型

控制台

1. 在 Google Cloud 控制台中，前往 Dataplex 的目录页面。

   前往目录

2. 依次点击切面类型 > 自定义标签页。

3. 在 Details 部分中，输入以下内容：

   1. 可选：在显示名称字段中，输入切面的名称 类型。
   2. 在切面类型 ID 字段中，为切面类型输入一个唯一 ID。
   3. 可选：在说明字段中，输入相应方面类型的说明。
   4. 在位置字段中，为相应方面类型选择一个位置。切面类型创建后，便无法修改其位置。

4. 可选：为切面类型定义模板。

   在模板中，点击添加字段。在新字段部分中， 输入以下内容：

   1. 在名称字段中，输入一个名称。
   2. 可选：在显示名称字段中，输入显示名称。
   3. 可选：在说明字段中，输入说明。

   4. 在 Type 字段中，为该字段选择数据类型。根据您的 系统会显示下一组字段和选项：

      • 如果您选择了文本作为数据类型，请按以下步骤操作：

        1. 在文本类型字段中，选择文本类型。
        2. 在文本值字段中，为文本字段提供提示。为此，请点击添加值并输入提示。 您可以为文本字段添加多个提示。
        3. 点击完成。

      • 如果您选择了枚举作为数据类型，请添加枚举值：

        1. 点击添加枚举值。
        2. 在值字段中，输入一个枚举值。您可以添加多个枚举值。
        3. 点击完成。

      • 如果您选择 Array 作为数据类型，请在数组项中 部分中，定义要在数组中显示的项目类型：

        1. 点击添加数组项。
        2. 在 Name 字段中，输入数组项的名称。
        3. 可选：在显示名称字段中，输入显示名称 。
        4. 可选：在说明字段中，输入以下各项的说明： 数组项。

        5. 在 Type 字段中，为数组项选择数据类型。

           根据您的选择，系统会显示下一组字段和选项。这些选项与本部分其他部分针对文本、枚举、映射、数组和记录数据类型所述的选项类似。

        6. 点击完成。

      • 如果您选择了映射作为数据类型，请在映射值中 部分，定义要在映射中显示的值的类型：

        1. 点击添加映射值。
        2. 在名称字段中，输入地图的名称。
        3. 可选：在显示名称字段中，输入地图的显示名称。
        4. 可选：在说明字段中，输入说明 。

        5. 在 Type 字段中，为地图选择数据类型。

           根据您的选择，系统会显示下一组字段和选项。这些选项与本部分其他部分针对数据类型 Text、Enum、Map、Array 和 Record 所述的选项类似。

        6. 点击完成。

      • 如果您选择记录作为数据类型，请输入以下内容：

        1. 在记录 ID 字段中，输入其他记录的唯一 ID 字段可用来引用此记录。请参阅 “记录 ID”和“记录引用”字段使用示例 部分。
        2. 可选：如果您想添加对另一条记录的引用， 请使用 Record reference 字段。创建此类别后，您将无法对其进行修改。请参阅 “记录 ID”和“记录引用”字段使用示例 部分。

        3. 在记录字段部分，您可以定义包含多个嵌套字段的复杂对象。为此，请点击添加记录字段项，然后指定以下内容：

           1. 在 Name（名称）字段中，为记录字段输入名称。
           2. 可选：在显示名称字段中，输入记录字段的显示名称。
           3. 可选：在说明字段中，输入以下各项的说明： 记录字段。

           4. 在 Type 字段中，选择数据类型。

              根据您的选择，下一组字段和选项 。这些选项与本部分前面针对数据类型 Text、Enum、Map、Array 和 Record 所述的选项类似。

        4. 点击完成。

   5. 要将该字段设为此类型的切面的必填字段，请选择 为必填项。如需详细了解必需的方面和可选的方面，请参阅本文档的方面类别部分。

   6. 点击完成。

   7. 如需添加多个字段，请点击添加字段，然后重复上述步骤。

5. 可选：在标签部分中，添加任意标签作为键值对 添加到您的资源：

   1. 点击添加标签。
   2. 在密钥字段中，输入一个密钥。
   3. 在值字段中，输入键的值。
   4. 如需添加更多标签，请点击添加标签，然后重复上述步骤。

6. 点击保存。

创建切面类型后，您可以向条目添加切面。

REST

如需创建新的方面类型，请使用 aspectType.create 方法。

使用“记录 ID”和“记录引用”字段的示例

您可以将记录 ID 和记录引用字段用于递归操作 参考。以下示例展示了如何使用这些字段：

假设有一个名为 Employee 的方面类型，其中包含以下字段：

• 名称（类型：Text）
• 开始日期（类型：Date & time）
• 名称（类型：Text）
• 当前地址（类型：Record）
• 永久地址（类型：Record）

当前地址和永久地址这两个地址字段是 数据类型相同 Record。为避免重复，您可以在定义这些字段时设置 Record ID 和 Record reference 值。

在定义当前地址字段时，您可以将记录 ID 指定为 address-field。对于永久地址，您可以为记录引用指定相同的值 (address-field)。例如：

• 名称（类型：Text）
• 开始日期（类型：Date & time）
• 职务（类型：Text）
• 当前地址（类型：Record，记录 ID：address-field）
• 永久地址（类型：Record，记录引用：address-field）

这样，您就不需要重复填写其他地址的字段。

向条目添加方面

创建切面类型后，您可以创建该类型的切面。如需向条目添加方面，您必须更新该条目，因为方面存储在条目中。

请注意以下几点：

• 您可以向条目或条目的列添加方面。
• 您只能修改自定义条目的必需切面。您无法删除必需的方面。

• 您可以修改和删除自定义条目和系统条目的可选方面。

控制台

1. 在 Google Cloud 控制台中，转到 Dataplex 搜索页面。

   转到搜索

2. 在选择搜索平台部分，选择 Dataplex Catalog 作为 搜索模式。

3. 搜索要为其添加方面信息的条目，然后点击该条目。

   系统会打开条目详情页面。

4. 如需向条目添加切面，请按以下步骤操作：

   1. 在条目详情页面上，点击详细信息标签页。
   2. 如需向条目添加必需的方面或可选的方面，请在方面部分中，点击相应类别的 添加。
      如果所选条目的类型，则无法添加必需切面 条目未定义必需切面。
      
   3. 搜索并选择要添加的切面。
   4. 在添加方面窗口中，输入相应字段的值。
   5. 点击保存。

5. 如需向条目的列添加方面，请按以下步骤操作：

   1. 在条目详情页面上，点击架构标签页。
   2. 选择要添加切面的列。
   3. 点击添加切面。
   4. 搜索并选择要添加的切面。
   5. 在添加方面窗口中，输入相应字段的值。
   6. 点击保存。

REST

要向条目或条目的列添加切面，请使用 entry.patch 方法。

在条目中创建和使用切面，且该条目对应的切面类型和 条目属于不同的 Google Cloud 组织，因此不受支持。

管理条目的现有方面

本部分介绍了如何更新和删除条目的现有方面。

更新方面

您可以修改自定义条目和系统条目的可选方面。 您只能修改自定义条目的必需切面。

控制台

1. 在 Google Cloud 控制台中，转到 Dataplex 搜索页面。

   转到搜索

2. 在选择搜索平台部分，选择 Dataplex Catalog 作为 搜索模式。

3. 搜索您要更新其方面信息的条目，然后点击该条目。

   系统会打开条目详情页面。

4. 点击详情标签页。

5. 针对要更新的方面，点击 修改。

6. 在修改切面窗口中，更新必填字段。

7. 点击保存。

REST

如需更新条目或条目列的方面，请使用 entry.update 方法。

删除切面

注意 ：您可以删除条目的可选切面，但不能删除必需的切面。 。

控制台

1. 在 Google Cloud 控制台中，转到 Dataplex 搜索页面。

   转到搜索

2. 在选择搜索平台中，选择 Dataplex Catalog 作为搜索模式。

3. 搜索要删除其方面信息的条目，然后点击该条目。

   参评资料详情页面即会打开。

4. 点击详情标签页。

5. 对于要删除的切面，点击 删除。

6. 点击确认。

REST

如需删除条目的某个方面，请使用 entry.update 方法。

管理切面类型

本部分介绍如何查看、更新和删除切面类型。

注意 ：您无法修改、删除或修改系统切面类型的权限。

查看可用切面类型的列表

控制台

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

   前往“目录”

2. 点击方面类型标签页。

   您可以访问自定义和系统切面类型的列表。有关 请参阅切面类型的类别 部分。

   在自定义标签页上，带有后缀的切面类型 (Data Catalog) 是已迁移的标记模板 Data Catalog 中的映射。

3. 如需查看所有项目中的切面类型的列表，请点击 自定义标签页，然后点击显示所有项目中的显示切换开关 打开位置

   注意：如果显示所有项目中的切面类型切换开关处于开启状态，您将无法直接修改或删除切面类型。您必须点击 切面类型以打开切面类型详情页面，然后修改 或将其删除。

REST

要列出所有可用的切面类型，请使用 aspectTypes.list 方法。

查看切面类型的详细信息

控制台

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

   前往“目录”

2. 点击方面类型标签页。

3. 点击相应切面类型。

   系统随即会打开“方面类型”详情页面。您可以查看 显示名称、切面类型 ID、说明、项目 ID、位置、标签 所选切面类型的创建日期和上次修改日期。

4. 要查看所选切面类型的结构，请点击 模板标签页。

5. 如需查看最近创建的 10 个相关条目列表，请点击示例条目标签页。

6. 如需搜索所有相关条目，请点击在搜索结果中显示所有相关条目。只有在至少有一个相关条目时，此按钮才会显示。

REST

如需获取方面类型的详细信息，请使用 aspectTypes.get 方法。

更新切面类型

您可以更新方面类型的显示名称、说明、模板字段和标签。您无法删除模板中的现有字段。

创建 切面类型。

控制台

1. 在 Google Cloud 控制台中，前往 Dataplex 的目录页面。

   前往目录

2. 点击方面类型标签页。

3. 点击要更新的切面类型。

4. 在方面类型详情页面上，点击修改。

5. 根据需要修改显示名称、说明、模板字段和标签。

6. 可选：如需将切面类型中的字段标记为已弃用，请执行以下操作： 请按以下步骤操作：

   1. 在模板部分中，展开该字段。
   2. 选择已废弃。
   3. 在弃用原因字段中，输入 弃用所选字段。
   4. 点击完成。

7. 点击保存。

REST

如需更新现有方面类型，请使用 aspectTypes.patch 方法。

删除切面类型

注意 ：删除切面类型会删除与该切面类型相关的所有切面。

控制台

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

   前往“目录”

2. 点击切面类型标签页。

3. 点击要删除的切面类型。

4. 在切面类型详细信息页面上，点击删除。在出现提示时确认。

REST

如要删除现有方面类型，请使用 aspectTypes.delete 方法。

后续步骤

• 了解如何在 Dataplex Catalog 中搜索数据资产。
• 了解如何管理条目和提取自定义来源。
• 了解如何将元数据导入 Dataplex。
• 详细了解 Dataplex Catalog。