管理业务术语库

本文档介绍了如何在 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
    • GLOSSARY_ID:术语库的 ID
    • DISPLAY_NAME:术语库的显示名称
    • DESCRIPTION:术语库的说明,最多 1024 个字符
  2. 可选:为术语库添加概览。

    1. 查找术语表的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
      \
      \&view=ALL

      PROJECT_NUMBER 替换为在其中创建术语库的项目的编号。

    2. 为术语库添加概览:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
      --data @- << EOF
      {
      "aspects": {
         "dataplex-types.global.overview": {
            "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
            "data": {
            "content": "OVERVIEW",
            "links": []
            },
         }
      }
      }
      EOF

      OVERVIEW 替换为用于描述术语库类别或术语的纯文本或 HTML。

查看可用的术语库

控制台

  • 在 Google Cloud 控制台中,前往 Dataplex Universal Catalog 术语库页面。

    前往“术语库”

    我的术语库窗格会显示您有权查看的所有组织术语库,以及它们的说明和上次修改时间戳。

REST

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

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

修改术语库

您可以修改术语库的名称和说明。

控制台

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

    前往“术语库”

  2. 点击要修改的术语库。

  3. 点击名称、说明或概览旁边的修改,然后进行更改。

  4. 点击保存

REST

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

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

删除术语表

您需要先删除术语库中的所有类别术语,然后才能删除术语库。

控制台

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

    前往“术语库”

  2. 点击您要删除的术语库。

  3. 点击删除,然后在系统提示时进行确认。

REST

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

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

创建和管理类别

以下部分介绍了如何创建、查看、更新和删除类别。

在术语库下创建类别

一个业务术语库最多可以包含 200 个类别。

控制台

  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/categories?category_id=CATEGORY_ID --data @- << EOF
    {
    "displayName": "CATEGORY_DISPLAY_NAME",
    "description": "CATEGORY_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
    }
    EOF

    替换以下内容:

    • CATEGORY_ID:类别 ID
    • CATEGORY_DISPLAY_NAME:类别显示名称
    • CATEGORY_DESCRIPTION:类别说明
  2. 可选:为类别添加概览。

    1. 查找类别的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL
    2. 为类别添加概览:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      OVERVIEW 替换为用于描述术语库类别或术语的纯文本或 HTML。

  3. 可选:添加联系人

    1. 查找类别的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL
    2. 更新包含联系人的类别的条目:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

创建嵌套类别

业务术语库最多可以有三个嵌套的类别级别(不包括根术语库级别)。

控制台

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

    前往“术语库”

  2. 展开要在其中创建类别的术语库。

  3. 选择您要在其中创建其他类别的父级类别,然后点击创建类别

  4. 输入类别的名称。

  5. 点击创建

  6. 可选:在说明中添加简短说明(最多 1,024 个字符),或在概览中添加长说明(最多 120 KB)。

REST

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/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

PARENT_CATEGORY_ID 替换为父级类别的 ID。

查看属于术语库的类别

控制台

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

    前往“术语库”

  2. 如需查看术语库中的类别,请展开该术语库。

  3. 如需查看某个类别中的嵌套类别,请展开该类别。

REST

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

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

修改类别

您可以修改类别的名称、说明和联系人。对于嵌套类别,您还可以修改父级类别。

控制台

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

    前往“术语库”

  2. 展开相应术语库,然后点击要修改的类别。

  3. 点击名称、说明或概览旁边的 修改,然后进行更改。

  4. 点击保存

REST

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

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

删除类别

控制台

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

    前往“术语库”

  2. 展开相应术语库,然后点击要删除的类别。

  3. 点击删除,然后在系统提示时进行确认。

REST

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

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

创建和管理术语

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

在业务术语库下创建术语

一个业务术语库最多可以包含 5,000 个术语。

控制台

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

    前往“术语库”

  2. 如需在术语库级层创建术语,请选择要在其中创建术语的术语库,然后点击创建术语

  3. 输入术语的名称。

  4. 点击创建

  5. 可选:在说明中添加简短说明(最多 1,024 个字符),或在概览中添加长说明(最多 120 KB)。

  6. 可选:如需添加联系人,请点击修改,然后提供数据管理员、数据所有者或数据域名所有者的邮箱列表。然后点击保存

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/terms?term_id=TERM_ID --data @- << EOF
    {
    "displayName": "TERM_DISPLAY_NAME",
    "description": "TERM_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
    }
    EOF

    替换以下内容:

    • TERM_ID:您要创建的术语的 ID
    • TERM_DISPLAY_NAME:您要创建的术语的显示名称
    • TERM_DESCRIPTION:您要创建的术语的说明
  2. 可选:为术语添加概览。

    1. 查找术语的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. 为术语添加概览:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      OVERVIEW 替换为用于描述术语库类别或术语的纯文本或 HTML。

  3. 可选:添加联系人。

    1. 查找术语的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. 更新包含联系人的术语的条目:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

在类别下创建术语

控制台

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

    前往“术语库”

  2. 如需在类别中创建术语,请选择要在其中创建术语的类别,然后点击添加术语

  3. 输入术语的名称。

  4. 点击创建

  5. 可选:在说明中添加简短说明(最多 1,024 个字符),或在概览中添加长说明(最多 120 KB)。

  6. 可选:如需添加联系人,请点击修改,然后提供数据管理员、数据所有者或数据域名所有者的邮箱列表。然后点击保存

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/terms?term_id=TERM_ID --data @- << EOF
    {
    "displayName": "TERM_DISPLAY_NAME",
    "description": "TERM_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
    }
    EOF

    替换以下内容:

    • TERM_ID:您要创建的术语的 ID
    • TERM_DISPLAY_NAME:您要创建的术语的显示名称
    • TERM_DESCRIPTION:您要创建的术语的说明
  2. 可选:为术语添加概览。

    1. 查找术语的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. 为术语添加概览:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      OVERVIEW 替换为用于描述术语库类别或术语的纯文本或 HTML。

  3. 可选:添加联系人。

    1. 查找术语的条目:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. 更新包含联系人的术语的条目:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\