元数据对于整理和了解数据资产至关重要。例如,受监管的行业需要保护个人身份信息 (PII),例如姓名、地址和政府签发的身份证号码。此类数据可能出现在分布式数据系统的多个实例中。Dataplex Universal Catalog 可帮助您快速发现和编目分布式数据资产。然后,您可以将数据归类为 PII。
通过为数据条目添加有意义的上下文,您可以让数据更易于发现且更有用。Dataplex Universal Catalog 通过以下方式实现上下文:
- 切面类型:用于定义相关数据的 JSON 模板。例如,对于合规性信息,您可能需要提供个人身份信息分类和 GDPR 合规性。
- 切面:切面类型的实例。例如,{"pii_classification": "confidential", "gdpr_compliant": true}。您可以将切面应用于整个表或单个表列。
对数据进行分类后,您可以对数据应用数据质量或访问政策。
如需了解详情,请参阅 Dataplex Universal Catalog 中的元数据管理简介。
切面
利用切面,您可以捕获条目中的元数据,从而提供有意义的上下文。 您可以使用切面来存储:
业务元数据:提供业务上下文,例如数据分类。
技术元数据:数据资产的技术详细信息,例如其架构。
数据派生元数据:根据数据本身生成的信息,例如 BigQuery 表中的统计信息。
切面被视为条目资源的一部分,而不是单独的资源。修改切面时,涉及修改包含该切面的条目。
您可以在条目级层指定用于描述条目的切面,也可以在列级层指定用于描述条目中列的切面。
每个切面都是切面类型的一个实例。切面类型用于为其切面定义模板。每个切面类型都包含一组字段。创建切面时,您必须为这些字段提供值。
对于给定的条目,每个切面类型最多只能有一个与该条目关联的切面。每个切面类型可以有多个与条目列关联的切面。
切面类别
切面分为以下几类:
必需的切面:创建条目时必须使用的切面。此类切面由给定条目的条目类型定义。属于某个条目类型的所有条目都必须始终具有该条目类型定义的所有必需切面。
Dataplex Universal Catalog 会管理系统条目所需的切面(例如架构)。
请注意以下几点:
您只能将必需的切面与条目相关联,而不能与条目列相关联。
您无法从条目中删除必需的切面。
您可以读取系统条目的必需切面,但无法修改它们。
数据切面不能是必需的切面。
可选切面:您可以将可选切面与条目或条目列相关联。您可以在创建条目时填充可选切面,也可以稍后通过更新条目来填充。
填充可选切面后,您可以将其删除。
数据切面
切面可以包含从数据中派生的信息,例如数据分析或示例查询的结果。这些切面称为数据切面。
切面类型
切面类型是可重复使用的资源,可为切面提供模板。
切面类型的类别
切面类型分为自定义切面类型和系统切面类型。
自定义切面类型
您在 Dataplex Universal Catalog 中创建的切面类型称为自定义切面类型。
自定义切面类型可以是全球性的,也可以是区域级的。您可以在特定区域位置(例如 us-central1)创建自定义切面类型,也可以将其创建为 global 资源。切面类型的位置会影响其适用范围,并决定它可以与哪些条目搭配使用:
- 全球切面类型:可用于为任何区域中的条目创建切面。如果您需要将相同的结构应用于多个区域中的条目,请选择
global切面类型,因为您只需定义一次。由于全球切面类型的定义会复制到所有区域,因此如果切面类型架构本身包含敏感信息,或者需要对所有元数据组件实施严格的数据驻留,则此选项可能不适合。 - 区域切面类型:只能用于为与切面类型位于同一区域的条目创建切面。例如,在
us-central1中创建的切面类型只能与us-central1中的条目搭配使用。如果某种切面类型仅与特定区域中的条目相关,或者为了确保切面类型定义位于所选区域内(这有助于满足数据主权和合规性要求),请选择区域位置。如果您使用区域切面类型,但需要在多个区域中使用相同的结构,则必须在每个区域中创建和管理单独的切面类型定义。
如需了解详情,请参阅项目和位置限制条件。
系统切面类型
Dataplex Universal Catalog 提供、使用和管理的切面类型称为系统切面类型。系统切面类型始终是全球性的,因此可在任何区域使用。系统切面类型存储在项目编号为 655216118709 的 Google 管理的项目中。例如 projects/655216118709/locations/global/aspectTypes/schema。
系统切面类型进一步分为可重复使用和受限两类。下表介绍了系统切面类型的类别,以及 Dataplex Universal Catalog 为每个类别提供的切面类型列表:
| 系统切面类型的类别 | 说明 | Dataplex Universal Catalog 提供的切面类型 |
|---|---|---|
| 可重复使用的系统切面类型 | 您可以使用这些切面类型来创建或修改切面。 |
|
| 受限的系统切面类型 | Dataplex Universal Catalog 会管理这些切面类型。 您可以读取这些切面类型下的切面,但无法在这些切面类型下创建或修改切面。 |
包括但不限于:
|
准备工作
在创建和管理方面类型及切面之前,请完成本部分中所述的任务。
所需的角色
如需获得创建和管理切面类型及切面所需的权限,请让您的管理员为您授予资源的以下 IAM 角色:
-
拥有 Dataplex Universal Catalog 中的元数据资源(包括切面类型和数据切面)的整套权限:Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) -
在 Dataplex Universal 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 and EntryLink Owner (roles/dataplex.entryOwner)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
如需了解详情,请参阅 Dataplex Universal Catalog IAM 角色。
启用 API
在 Dataplex Universal Catalog 项目中启用 Dataplex API。
创建自定义切面类型
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 目录页面。
点击切面类型和标记模板 > 自定义标签页。
点击创建切面类型。
在创建切面类型窗口中,输入以下内容:
- 可选:在显示名称字段中,输入切面类型的名称。
- 在切面类型 ID 字段中,输入切面类型的唯一 ID。
- 可选:在说明字段中,输入切面类型的说明。
- 在位置字段中,为切面类型选择一个位置。创建切面类型后,您无法修改其位置。 如需了解选择全球位置与区域位置的影响,请参阅自定义切面类型部分。
可选:为切面类型定义模板。
在模板部分中,点击添加字段。在新字段部分中,输入以下内容:
- 在名称字段中,输入一个名称。
- 可选:在显示名称字段中,输入一个显示名称。
- 可选:在说明字段中,输入说明。
在类型字段中,为该字段选择一种数据类型。系统会根据您的选择显示下一组字段和选项:
如果您选择了文本作为数据类型,请按照以下步骤操作:
- 在文本类型字段中,选择文本类型。
- 在文本值字段中,为文本字段提供提示。为此,请点击添加值,然后输入提示。您可以为文本字段添加多个提示。
- 点击完成。
如果您选择了枚举作为数据类型,请添加枚举值:
- 点击添加枚举值。
- 在值字段中,输入一个枚举值。您可以添加多个枚举值。
- 点击完成。
如果您选择了数组作为数据类型,请在数组项部分中,定义要在数组中显示的项的类型:
- 点击添加数组项。
- 在名称字段中,输入数组项的名称。
- 可选:在显示名称字段中,输入数组项的显示名称。
- 可选:在说明字段中,输入数组项的说明。
在类型字段中,为数组项选择一种数据类型。
系统会根据您的选择显示下一组字段和选项。它们与本部分其他位置针对文本、枚举、映射、数组和记录数据类型描述的选项类似。
点击完成。
如果您选择了映射作为数据类型,请在映射值部分中,定义要在映射中显示的值的类型:
- 点击添加映射值。
- 在名称字段中,输入映射的名称。
- 可选:在显示名称字段中,输入映射的显示名称。
- 可选:在说明字段中,输入映射的说明。
在类型字段中,为映射选择一种数据类型。
系统会根据您的选择显示下一组字段和选项。它们与本部分其他位置针对文本、枚举、映射、数组和记录数据类型描述的选项类似。
点击完成。
如果您选择了记录作为数据类型,请输入以下内容:
- 在记录 ID 字段中,输入一个唯一 ID,其他记录字段可以使用该 ID 来引用此记录。请参阅本文档的使用记录 ID 和记录引用字段的示例部分。
- 可选:如果您想添加对此模板中其他记录的引用,请使用记录引用字段。创建切面类型后,您无法修改此字段。请参阅本文档的使用记录 ID 和记录引用字段的示例部分。
在记录字段部分,您可以定义包含多个嵌套字段的复杂对象。为此,请点击添加记录字段项,然后指定以下内容:
在名称字段中,输入记录字段的名称。
可选:在显示名称字段中,输入记录字段的显示名称。
可选:在说明字段中,输入记录字段的说明。
在类型字段中,选择一种数据类型。
系统会根据您的选择显示下一组字段和选项。它们与本部分前面针对文本、枚举、映射、数组和记录数据类型描述的选项类似。
点击完成。
如需将相应字段设为此类型的切面的必填字段,请选择为必填项。如需详细了解必需的切面和可选切面,请参阅本文档的切面类别部分。
点击完成。
如需添加多个字段,请点击添加字段,然后重复执行上述步骤。
可选:在标签部分中,为资源添加键值对形式的任意标签:
- 点击添加标签。
- 在键字段中,输入一个键。
- 在值字段中,输入该键的值。
- 如需添加更多标签,请点击添加标签,然后重复执行上述步骤。
点击保存。
gcloud
如需创建自定义切面类型,请使用 gcloud dataplex aspect-types create 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需创建自定义切面类型,请使用 aspectType.create 方法。
创建自定义切面类型后,您可以向条目添加切面。
使用记录 ID 和记录引用字段的示例
您可以使用记录 ID 和记录引用字段进行递归引用。以下示例展示了如何使用这些字段:
假设一个名为 Employee 的切面类型,其中包含以下字段:
- 名称(类型:
Text) - 开始日期(类型:
Date & time) - 标识(类型:
Text) - 当前地址(类型:
Record) - 永久地址(类型:
Record)
两个地址字段(当前地址和永久地址)的数据类型均为 Record。为避免重复,您可以在定义这些字段时设置记录 ID 和记录引用 值。
定义当前地址字段时,您可以将记录 ID 指定为 address-field。对于永久地址,您可以为记录引用指定相同的值 (address-field)。例如:
- 名称(类型:
Text) - 开始日期(类型:
Date & time) - 标识(类型:
Text) - 当前地址(类型:
Record,记录 ID:address-field) - 永久地址(类型:
Record,记录引用:address-field)
这样一来,您便无需重复其他地址的字段。
向条目添加切面
创建切面类型后,您可以创建该类型的切面。如需向条目添加切面,您必须更新该条目,因为切面存储在条目中。
请注意以下几点:
- 您可以向条目或条目列添加切面。
- 您只能修改自定义条目的必需切面。您无法删除必需的切面。
- 您可以修改和删除自定义条目及系统条目的可选切面。
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 搜索页面。
对于选择搜索平台,选择 Dataplex Universal Catalog 作为搜索模式。
搜索要向其添加切面的条目,然后点击该条目。系统会打开条目详情页面。
如需向条目添加切面,请按照以下步骤操作:
- 点击详情标签页。
- 如需向条目添加必需的切面或可选切面,请在标记和切面部分中,针对相应类别点击 添加。
如果所选条目的条目类型未定义必需的切面,则您无法添加必需的切面。 - 搜索并选择您要添加的切面。
- 在添加切面窗口中,输入相应字段的值。
- 点击保存。
如需向条目列添加切面,请按照以下步骤操作:
- 在条目详情页面上,点击架构标签页。
- 选择要向其添加切面的列。
- 点击添加切面。
- 搜索并选择您要添加的切面。
- 在添加切面窗口中,输入相应字段的值。
- 点击保存。
gcloud
如需向条目或条目列添加切面,请使用 gcloud dataplex entries update 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
如需向条目对象添加切面,请参阅切面。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
如需向条目对象添加切面,请参阅条目。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
如需向条目对象添加切面,请参阅 #required_aspects=。
REST
如需向条目或条目列添加切面,请使用 entry.patch 方法。
不支持在条目中创建和使用切面,因为相应的切面类型和条目位于不同的 Google Cloud 组织中。
管理条目的现有切面
本部分介绍了如何更新和删除条目的现有切面。
更新切面
您可以修改自定义条目和系统条目的可选切面。您只能修改自定义条目的必需切面。
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 搜索页面。
对于选择搜索平台,选择 Dataplex Universal Catalog 作为搜索模式。
搜索要更新其切面的条目,然后点击该条目。
系统会打开条目详情页面。
点击详情标签页。
在标记和切面部分中,展开要更新的切面或标记,然后点击 修改。
在修改切面窗口中,更新必填字段。
点击保存。
gcloud
如需更新条目或条目列的切面,请使用 gcloud dataplex entries update 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需更新条目或条目列的切面,请使用 entry.patch 方法。
删除切面
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 搜索页面。
对于选择搜索平台,选择 Dataplex Universal Catalog 作为搜索模式。
搜索要删除其切面的条目,然后点击该条目。
系统会打开条目详情页面。
点击详情标签页。
在标记和切面部分中,展开要删除的切面或标记,然后点击 删除。
点击确认。
gcloud
如需删除条目的切面,请使用 gcloud dataplex entries update 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需删除条目的切面,请使用 entry.patch 方法。
管理切面类型
本部分介绍了如何查看、更新和删除切面类型。
查看可用切面类型和标记模板的列表
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 目录页面。
点击切面类型和标记模板标签页。
此页面列出了所有可用的 Dataplex Universal Catalog 切面类型和 Data Catalog 标记模板。
如需查看自定义切面类型和标记模板,请点击自定义标签页。在自定义标签页中,目录来源列会显示资源所在的位置,即 Dataplex Universal Catalog 或 Data Catalog。
如需查看系统切面类型,请点击系统标签页。
如需详细了解自定义切面类型和系统切面类型,请参阅本文档的切面类型的类别部分。
可选:如需查看所选项目中的切面类型和标记模板列表,请点击自定义标签页,然后点击显示所有项目中的切面类型切换开关,将其切换到关闭位置。
显示所有项目中的切面类型切换开关默认处于开启状态,并且该列表包含所选组织中的 Dataplex Universal Catalog 资源以及您可以访问的所有组织中的 Data Catalog 资源。
gcloud
如需列出所有可用的切面类型,请使用 gcloud dataplex aspect-types list 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需列出所有可用的切面类型,请使用 aspectTypes.list 方法。
查看切面类型或标记模板的详细信息
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 目录页面。
点击切面类型和标记模板标签页。
如需查看 Dataplex Universal Catalog 切面类型的详细信息,请点击该切面类型。系统会打开切面类型详细信息页面,您可以在其中查看显示名称、切面类型 ID、说明、项目 ID、位置、标签、创建日期和上次修改日期等详细信息。
- 如需查看所选切面类型的结构,请点击模板标签页。
- 如需查看最近创建的 10 个相关条目的列表,请点击示例条目标签页。
- 如需搜索所有相关条目,请点击在搜索结果中显示所有相关条目。仅当至少存在一个相关条目时,才会显示此按钮。
如需查看 Data Catalog 标记模板的详细信息,请点击该标记模板。Data Catalog 中会打开标记模板详细信息页面,您可以在其中查看显示名称、模板 ID、项目 ID、位置、可见性和标签等详细信息。
gcloud
如需获取切面类型的详细信息,请使用 gcloud dataplex aspect-types describe 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需获取切面类型的详细信息,请使用 aspectTypes.get 方法。
更新自定义切面类型
您可以更新自定义切面类型的显示名称、说明、模板字段和标签。您无法删除模板中的现有字段。
创建切面类型后,您无法更新切面类型 ID 和位置。
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 目录页面。
点击切面类型和标记模板标签页。
点击要更新的切面类型。
在切面类型详细信息页面上,点击修改。
根据需要修改显示名称、说明、模板字段和标签。
可选:如需将切面类型中的某个字段标记为已弃用,请按照以下步骤操作:
- 在模板部分,展开相应字段。
- 选择已弃用。
- 在弃用原因字段中,输入弃用所选字段的原因。
- 点击完成。
点击保存。
gcloud
如需更新自定义切面类型,请使用 gcloud dataplex aspect-types update 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需更新自定义切面类型,请使用 aspectTypes.patch 方法。
删除自定义切面类型
控制台
在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 目录页面。
点击切面类型和标记模板标签页。
点击要删除的切面类型。
在切面类型详细信息页面上,点击删除。在系统提示时确认。
gcloud
如需删除自定义切面类型,请使用 gcloud dataplex aspect-types delete 命令。
C#
C#
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 C# 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog C# API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
Go
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Go API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
Java
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Java API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
Python
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Python API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
Ruby
在尝试此示例之前,请按照 Dataplex Universal Catalog 快速入门:使用客户端库中的 Ruby 设置说明进行操作。如需了解详情,请参阅 Dataplex Universal Catalog Ruby API 参考文档。
如需向 Dataplex Universal Catalog 进行身份验证,请设置应用默认凭证。如需了解详情,请参阅为本地开发环境设置身份验证。
REST
如需删除现有的自定义切面类型,请使用 aspectTypes.delete 方法。
后续步骤
- 了解如何在 Dataplex Universal Catalog 中搜索数据资产。
- 了解如何管理条目和注入自定义来源。
- 了解如何将元数据导入 Dataplex Universal Catalog。
- 详细了解 Dataplex Universal Catalog 中的元数据管理。
- 详细了解如何从 Data Catalog 转换到 Dataplex Universal Catalog。
- 按照 Codelab:使用 Dataplex Universal Catalog 实现基础治理操作。