管理业务术语库

本文档介绍了如何在 Dataplex Universal Catalog 中创建和管理 Dataplex Universal Catalog 业务术语库。使用业务术语库为数据资产建立标准化的词汇，从而减少歧义并提高整个组织的数据发现和治理水平。

Dataplex Universal Catalog 业务术语库使用情形

通过使用 Dataplex Universal Catalog 业务术语库为数据创建通用语言，您可以实现以下目标：

  • 明确定义业务类别和术语的层次结构。
  • 使用同义词关联概念，并显示术语之间的关系。
  • 根据业务概念（而不仅仅是技术名称）搜索数据资源。

Dataplex Universal Catalog 业务术语库有助于简化数据发现流程并减少歧义，从而实现更好的治理、更准确的分析并更快地获取数据洞见。

业务术语库的要素

本部分介绍了可用于构建业务术语库的关键要素。

术语库

术语库具有以下属性：

  • 概览。描述业务术语库的用途和内容。 您可以添加图片、链接和表格。虽然不支持 HTML 格式，但您可以添加格式为代码的 HTML 代码，也可以添加指向 HTML 页面的链接。您还可以使用富文本格式设置选项，例如粗体、斜体、下划线、项目符号列表、段落、标题和代码块。支持的大小上限为 120 KB。

  • 说明。描述术语库。此字段中的文本会编入索引以进行搜索。支持的大小上限为 1 KB。

  • Region 绑定将多选选项设置为所有记录中 Region 的所有值。指定术语库所在区域。

类别

类别可用于整理和编排各种类别和术语。类别是在业务术语库中定义的。您最多可以嵌套三个级层的类别。

类别具有术语库的属性以及以下属性：

  • 联系人。指定负责维护类别的人员。此属性是描述性属性，不会影响类别的权限。
  • 父级。指定用于建立当前类别的父级的关系。您最多可以嵌套三个类别。

类别的区域与包含该类别的术语库的区域相同。

术语

术语 (term)（“glossary term”的简称）是指公司内特定业务分支中使用的概念。例如，某公司的营销部门可能会创建一个描述每次点击费用的术语。术语是在业务术语库中定义的，要么直接在术语库中定义，要么在术语库中的任何类别中定义。

术语具有类别的属性以及以下属性：

  • 同义词。指定具有相同含义的字词之间的关联。请参阅同义词。
  • 相关字词。指定在概念上彼此相关但含义不同的字词之间的链接。请参阅相关字词。
  • 相关条目。指定术语与数据资产之间或术语与数据资产中的列之间的关联。
  • 联系人。指定负责维护术语的人员。术语不会沿用类别中定义的联系人。

术语的区域与包含该术语的术语库的区域相同。

同义词

同义词是一种关系，用于指示两个不同术语之间的等效性。当两个含义相同的术语由不同团队在不同的术语库中定义时，请使用同义词。例如，您可以创建一个同义词来链接“利润”和“盈利”这两个术语。

相关字词是一种关系，用于指示两个字词彼此关联，但含义不同。例如，您可以创建一个相关字词，将“收入”和“利润”这两个字词关联起来。

限制

所需的角色

如需获得创建和管理术语库所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

  • 对于数据管理员，获取对术语库、类别、术语、同义词和相关字词的完整访问权限，并设置 IAM 政策：Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
  • 对于数据管理员或数据所有者，获取创建、修改或删除术语库、类别、术语、术语之间的关联、术语与数据资产之间的关联以及搜索的权限：Dataplex Catalog Editor (roles/dataplex.catalogEditor)
  • 对于数据分析师或数据使用者，获取对术语库、类别、术语、术语之间的关联、术语与数据资产之间的关联以及搜索的只读权限：Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

这些预定义角色可提供创建和管理术语库所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

创建和管理术语库需要以下权限：

  • 在项目中创建、读取、更新和删除业务术语库、类别和术语：
    • dataplex.glossaries.list
    • dataplex.glossaries.create
    • dataplex.glossaries.get
    • dataplex.glossaries.update
    • dataplex.glossaries.delete
    • dataplex.glossaryCategories.create
    • dataplex.glossaryCategories.list
    • dataplex.glossaryCategories.get
    • dataplex.glossaryCategories.update
    • dataplex.glossaryCategories.delete
    • dataplex.glossaryTerms.create
    • dataplex.glossaryTerms.list
    • dataplex.glossaryTerms.get
    • dataplex.glossaryTerms.update
    • dataplex.glossaryTerms.delete
  • 在项目中创建和删除同义词与同义词关联：
    • 针对任一术语库术语所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryLinks.create。关联是在授予权限的条目组中创建的。
    • 针对任一术语库术语所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryGroups.useSynonymEntryLink。关联是在授予权限的条目组中创建的。
    • 针对不需要关联其术语的术语库的 dataplex.glossaryTerms.use。
    • 针对关联所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryLinks.delete。
  • 在项目中创建和删除相关词与相关词关联：
    • 针对任一术语库术语所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryLinks.create。关联是在授予权限的条目组中创建的。
    • 针对任一术语库术语所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryGroups.useRelatedEntryLink。关联是在授予权限的条目组中创建的。
    • 针对对应于术语库术语的条目所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entries.link。
    • 针对关联所在项目中的 Dataplex Universal Catalog 条目组的 dataplex.entryLinks.delete。
  • 在项目中的术语与数据资产或列之间创建关联：
    • 针对与项目中的数据资产或列对应的系统条目组的 dataplex.entryLinks.create关联是在授予权限的项目中创建的。
    • 针对与项目中的数据资产或列对应的系统条目组的 dataplex.entryGroups.useDefinitionEntryLink关联是在授予权限的项目中创建的。
    • 针对与项目中的数据资产或列对应的系统条目组的 dataplex.entries.link关联是在授予权限的项目中创建的。
    • 针对不需要关联其术语的术语库的 dataplex.glossaryTerms.use 。
    • 针对关联所在的系统条目组的 dataplex.entryLinks.delete。

您也可以使用自定义角色或其他预定义角色来获取这些权限。

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

创建和管理业务术语库

以下部分介绍了如何创建、查看、修改和删除业务术语库。

创建业务术语库

控制台

  1. 在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 术语库页面。

    前往“术语库”

  2. 点击创建业务术语库。

  3. 在创建业务术语库页面上，指定业务术语库的名称和位置。创建术语库后，您无法更改其位置。

  4. 点击创建。系统在当前项目下创建了术语库。

  5. 可选：在说明中添加简短说明（最多 1,024 个字符），或在概览中添加长说明（最多 120 KB）。

REST

创建术语库时，Dataplex Universal Catalog 会创建一个条目来表示该术语库。

  1. 创建术语库。

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

    替换以下内容：

    • PROJECT_ID：您要在其中创建术语库的项目的 ID
    • LOCATION_ID：您要在其中创建术语库的位置的 ID