管理方面和丰富元数据

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

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. 点击创建切面类型 (Dataplex Catalog)。

4. 在创建方面类型窗口中，输入以下内容：

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

5. 可选：为您的切面类型定义模板。

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

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

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

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

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

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

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

      • 如果您选择了数组作为数据类型，请在数组项部分中定义数组中将包含的项的类型：

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

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

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

        6. 点击完成。

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

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

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

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

        6. 点击完成。

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

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

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

        4. 在 Name 字段中，输入记录字段的名称。

        5. 可选：在显示名称字段中，输入记录字段的显示名称。

        6. 可选：在说明字段中，输入记录字段的说明。

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

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

        8. 点击完成。

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

   6. 点击完成。

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

6. 可选：在标签部分中，为资源添加键值对形式的任意标签：

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

7. 点击保存。

gcloud

如需创建方面类型，请使用 gcloud dataplex aspect-types create 命令。

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）

这样，您无需重复填写另一个地址的字段。

向条目添加方面

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

请注意以下几点：

• 您可以向条目或条目的列添加方面。
• 您只能修改自定义条目的必填属性。您无法删除必需的方面。
• 您可以修改和删除自定义条目和系统条目的可选方面。

注意 ：使用 CREATE OR REPLACE TABLE 语句替换 BigQuery 表时，与原始表关联的元数据（包括方面）不会应用于新表。如果您希望元数据保留，可以为表创建 BigQuery 视图，并将元数据添加到该视图。

控制台

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

   转到搜索

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

3. 搜索要为其添加方面信息的条目，然后点击该条目。系统会打开条目详情页面。

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

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

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

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

gcloud

如需向条目或条目的列添加方面，请使用 gcloud dataplex entries update 命令。

REST

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

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

管理条目的现有方面

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

更新方面

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

控制台

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

   转到搜索

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

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

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

4. 点击详情标签页。

5. 在标签和方面部分中，展开要更新的方面或标签，然后点击 Edit（修改）。

6. 在修改宽高比窗口中，更新必填字段。

7. 点击保存。

gcloud

如需更新条目或条目列的方面，请使用 gcloud dataplex entries update 命令。

REST

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

删除方面

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

控制台

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

   转到搜索

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

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

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

4. 点击详情标签页。

5. 在标记和方面部分中，展开要删除的方面或标记，然后点击 删除。

6. 点击确认。

gcloud

如需删除条目的某个方面，请使用 gcloud dataplex entries update 命令。

REST

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

管理切面类型

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

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

查看可用切面类型和标记模板的列表

控制台

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

   前往目录

2. 点击切面类型和标记模板标签页。

   此页面列出了所有可用的 Dataplex Catalog 切面类型和 Data Catalog 标记模板。

3. 如需查看自定义方面类型和代码模板，请点击自定义标签页。在自定义标签页中，目录来源列会显示资源所在的位置：Dataplex Catalog 或 Data Catalog。

   如需查看系统方面类型，请点击系统标签页。

   如需详细了解自定义和系统方面类型，请参阅本文档的方面类型的类别部分。

4. 可选：如需查看所选项目中的方面类型和代码模板列表，请点击自定义标签页，然后将显示来自所有项目的方面切换开关切换到关闭状态。

   显示来自所有项目的资源切换开关默认处于开启状态，列表中包含所选组织中的 Dataplex Catalog 资源，以及您可以访问的所有组织中的 Data Catalog 资源。

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

gcloud

如需列出所有可用切面类型，请使用 gcloud dataplex aspect-types list 命令。

REST

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

查看切面类型或标记模板的详细信息

控制台

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

   前往目录

2. 点击切面类型和标记模板标签页。

3. 如需查看 Dataplex Catalog 切面类型的详细信息，请点击相应切面类型。系统随即会打开“方面类型详情”页面，您可以在其中查看详细信息，例如显示名称、方面类型 ID、说明、项目 ID、位置、标签、创建日期和最后修改日期。

   • 如需查看所选方面类型的结构，请点击 Template（模板）标签页。
   • 如需查看最近创建的 10 个相关条目列表，请点击示例条目标签页。
   • 如需搜索所有相关条目，请点击在搜索结果中显示所有相关条目。只有当至少有一个相关条目时，此按钮才会显示。

4. 如需查看 Data Catalog 标记模板的详细信息，请点击该标记模板。系统会在 Data Catalog 中打开标记模板详情页面，您可以在其中查看详细信息，例如显示名称、模板 ID、项目 ID、位置、公开范围和标签。

gcloud

如需获取方面类型的详细信息，请使用 gcloud dataplex aspect-types describe 命令。

REST

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

更新切面类型

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

创建方面类型后，您无法更新方面类型 ID 和位置。

控制台

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

   前往目录

2. 点击切面类型和标记模板标签页。

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

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

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

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

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

7. 点击保存。

gcloud

如需更新方面类型，请使用 gcloud dataplex aspect-types update 命令。

REST

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

删除切面类型

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

控制台

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

   前往目录

2. 点击切面类型和标记模板标签页。

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

4. 在方面类型详情页面上，点击删除。在出现提示时确认。

gcloud

如需删除某个方面类型，请使用 gcloud dataplex aspect-types delete 命令。

REST

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

后续步骤

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