此页面由 Cloud Translation API 翻译。

管理业务术语表

借助 Dataplex Universal Catalog 业务术语库，您可以在一个位置管理整个公司中与业务相关的术语和定义。

当不同团队共同处理一个项目时，或者当一家大型公司拥有许多部门时，企业中的每个部分通常都会创建自己的术语来描述他们所处理的各种数据资源。这可能会导致沟通不畅，以及对这些资源理解不一致。此外，有时某个概念可能需要技术知识或专业知识。这可能会导致其他网域中的企业用户难以理解该概念。

借助 Dataplex Universal Catalog 业务术语库，您可以为数据资源创建集中式标准化词汇。您可以使用业务术语库执行以下操作：

定义业务类别和概念（称为“术语”）的层次结构。
通过定义同义词和相关字词，在概念之间建立关联。
将数据资源与术语表中的术语相关联，以便您根据业务概念搜索数据资源。

业务术语表有助于简化数据发现流程并减少歧义，从而提高分析准确性、改进治理并更快获得数据洞见。

业务术语表的要素

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

术语库

词汇表具有以下属性：

概览。说明业务术语表的用途和内容。您可以向词汇表添加图片、链接、表格或格式化文本。支持的最大大小为 120 KB。
说明。描述术语表。此字段中的文本会编入索引以供搜索。支持的大小上限为 1 KB。
Region 绑定将多选选项设置为所有记录中 Region 的所有值。指定术语库所在的区域。

类别

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

类别具有词汇表的属性以及以下属性：

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

类别的区域与包含该类别的词汇表的区域相同。

术语

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

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

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

术语的区域与包含该术语的词汇表的区域相同。

同义词

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

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

限制

Dataplex Universal Catalog 业务术语库不支持 Assured Workload 项目。
业务术语表位于项目和位置内；项目和位置的限制适用于术语表。

所需的角色

如需获得创建和管理术语库所需的权限，请让您的管理员为您授予项目的以下 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.entryLinks.create 在项目中包含任一术语库术语的 Dataplex Universal Catalog 条目组上。链接是在授予权限的条目组中创建的。
- dataplex.entryGroups.useSynonymEntryLink 在项目中包含任一术语库术语的 Dataplex Universal Catalog 条目组上。链接是在授予权限的条目组中创建的。
- dataplex.glossaryTerms.use 在需要关联术语的词汇表上。
- 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 Universal Catalog 条目组中。
在项目中的术语与数据资产或列之间创建链接：
- dataplex.entryLinks.create 在与项目中的数据资产或列对应的系统条目组上。链接是在授予权限的项目中创建的。
- dataplex.entryGroups.useDefinitionEntryLink 在与项目中的数据资产或列对应的系统条目组上。链接是在授予权限的项目中创建的。
- dataplex.entries.link 在与项目中的数据资产或列对应的系统条目组上。链接是在授予权限的项目中创建的。
- dataplex.glossaryTerms.use 在需要关联字词的术语库上。
- dataplex.entryLinks.delete （如果链接存在于系统条目组中）。

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

如需了解详情，请参阅 Data Catalog 预定义角色。

创建和管理业务术语库

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

创建业务术语库

控制台

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

前往“术语库”
点击创建业务术语库。
在创建业务术语库页面上，指定业务术语库的名称和位置。创建术语库后，您无法更改其位置。
点击创建。系统在当前项目下创建了术语库。
可选：在说明中添加简短说明（最多 1,024 个字符），或在概览中添加长说明（最多 120 KB）。

REST

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

创建术语表。

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 个字符

可选：向词汇表添加概览。

查找术语表的条目：

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 替换为创建术语库的项目编号。

向词汇表添加概览：

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

修改术语库

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

控制台

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

前往“术语库”
点击要修改的术语库。
点击名称、说明或概览旁边的修改，然后进行更改。
点击保存。

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

删除术语表

如需删除词库，您需要先删除该词库中的所有类别和术语。

控制台

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

前往“术语库”
点击要删除的术语库。
点击删除，然后根据提示进行确认。

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 个类别。

控制台

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

前往“术语库”
选择要在其中创建类别的术语库，然后点击创建类别。
输入类别的名称。
点击创建。
可选：在说明中添加简短说明（最多 1,024 个字符），或在概览中添加长说明（最多 120 KB）。

REST

创建类别时，Dataplex Universal Catalog 会创建一个条目来表示该类别。

创建类别。

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：类别的说明

可选：为类别添加概览。

查找您类别的条目：

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

为类别添加概览：

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。

可选：添加联系人

查找您类别的条目：

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

使用联系人信息更新相应类别的条目：

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

创建嵌套类别

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

控制台

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

前往“术语库”
展开要在其中创建类别的术语库。
选择您要在其中创建其他类别的父级类别，然后点击创建类别。
输入类别的名称。
点击创建。
可选：在说明中添加简短说明（最多 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。

查看术语库所属的类别

控制台

在 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/GLOSSARY_ID/categories

修改类别

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

控制台

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

前往“术语库”
展开相应术语库，然后点击要修改的类别。
点击名称、说明或概览旁边的修改，然后进行更改。
点击保存。

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

删除类别

控制台

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

前往“术语库”
展开相应术语库，然后点击要删除的类别。
点击删除，然后根据提示进行确认。

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 个术语。

控制台

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

前往“术语库”
如需在术语库级别创建术语，请选择要在其中创建术语的术语库，然后点击创建术语。
输入术语的名称。
点击创建。
可选：在说明中添加简短说明（最多 1,024 个字符），或在概览中添加长说明（最多 120 KB）。
可选：如需添加联系人，请点击修改，然后提供数据管理员、数据所有者或数据网域所有者的电子邮件地址列表。然后点击保存。

REST

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

创建术语。

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：您要创建的术语的说明

可选：为术语添加概览。

查找相应字词的条目：

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

为您的术语添加概览：

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。

可选：添加联系人。

查找相应字词的条目：

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

更新了包含联系信息的术语条目：

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

在类别下创建术语

控制台

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

前往“术语库”
如需在类别中创建术语，请选择要在其中创建术语的类别，然后点击添加术语。
输入术语的名称。
点击创建。
可选：在说明中添加简短说明（最多 1,024 个字符），或在概览中添加长说明（最多 120 KB）。
可选：如需添加联系人，请点击修改，然后提供数据管理员、数据所有者或数据网域所有者的电子邮件地址列表。然后点击保存。

REST

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

创建术语。

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：您要创建的术语的说明

可选：为术语添加概览。

查找相应字词的条目：

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

为您的术语添加概览：

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。

可选：添加联系人。

查找相应字词的条目：

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

更新了包含联系信息的术语条目：

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

查看术语库或类别中的术语

控制台

在 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/GLOSSARY_ID/terms

查看术语的详细信息

控制台

在 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/GLOSSARY_ID/terms/TERM_ID

修改术语

您可以修改术语的名称、说明、概览、联系人和父级。

控制台

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

前往“术语库”
展开相应术语库，然后点击要修改的术语。
点击修改。
修改任意字段，然后点击保存。

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/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

删除术语

控制台

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

前往“术语库”
展开相应术语库，然后点击要删除的术语。
点击删除，然后根据提示进行确认。

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/terms/TERM_ID

管理同义词和相关字词

您可以通过将术语链接为同义词或相关字词，在术语之间添加关系。

术语关系是双向的。例如，当您将 profit 关联为 earnings 的同义词时，earnings 也会成为 profit 的同义词。

创建术语之间的同义词链接

控制台

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

前往“术语库”
展开相应术语库，然后点击要创建链接的术语。
点击同义词旁边的修改。
搜索并选择要链接到的术语。

您选择该术语后，系统会立即将其链接。
点击关闭。

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/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

替换以下内容：

TERM1_PROJECT_NUMBER：要关联的第一个条款的项目编号。
TERM1_LOCATION_ID：包含第一个术语的术语表的 ID。
TERM1_GLOSSARY_ID：包含第一个术语的术语表的 ID。
TERM1_ID：第一个期限的 ID。
TERM2_PROJECT_NUMBER：您要链接为同义词的第二个字词的项目编号。如果这两个期限位于同一项目中，则此值与第一个期限的项目编号相同。
TERM2_LOCATION_ID：包含第二个术语的术语表的 ID。如果两个字词位于同一位置，则此值与第一个字词的位置 ID 相同。
TERM2_GLOSSARY_ID：包含第二个术语的术语表的 ID。如果这两个术语位于同一术语表中，则此值与第一个术语的术语表 ID 相同。
TERM2_ID：第二个学期的 ID。
ENTRY_LINK_ID：两个术语之间链接的 ID。每个术语都表示为一个 Dataplex Universal Catalog 条目。条目链接是同义词之间的关系。

控制台

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

前往“术语库”
展开相应术语库，然后点击要创建链接的术语。
点击相关字词旁边的修改。
搜索并选择要链接到的术语。

您选择该术语后，系统会立即将其链接。
点击关闭。

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/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

替换以下内容：

TERM1_PROJECT_NUMBER：要关联的第一个期限的项目编号。
TERM1_LOCATION_ID：包含第一个术语的术语表的 ID。
TERM1_GLOSSARY_ID：包含第一个术语的术语表的 ID。
TERM1_ID：第一个期限的 ID。
TERM2_PROJECT_NUMBER：您要作为相关术语链接到的第二个学期的项目编号。如果这两个术语位于同一项目中，则此值与第一个术语的项目编号相同。
TERM2_LOCATION_ID：包含第二个术语的术语表的 ID。如果两个字词位于同一位置，则此值与第一个字词的位置 ID 相同。
TERM2_GLOSSARY_ID：包含第二个术语的术语表的 ID。如果这两个术语位于同一术语表中，则此值与第一个术语的术语表 ID 相同。
TERM2_ID：第二个学期的 ID。
ENTRY_LINK_ID：两个术语之间链接的 ID。每个术语都表示为一个 Dataplex Universal Catalog 条目。词条链接是相关术语之间的关系。

移除同义词和相关字词之间的链接

控制台

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

前往“术语库”
展开相应术语库，然后点击要移除其同义词或相关字词的术语。
如需删除相关字词之间的链接，请点击相关字词旁边的修改。删除相关字词，然后点击关闭。
如需删除同义词之间的链接，请点击同义词旁边的修改。删除同义词，然后点击关闭。

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/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

管理术语与数据资产之间的关联

您可以将术语附加到数据资产或数据资产列。例如，您可以将条款附加到 BigQuery 数据集。

将条款附加到数据资产

控制台

在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 搜索页面。

转到搜索
搜索要与术语相关联的数据资产（例如数据集、文件或表格），然后点击该资产。
在数据资产页面上，执行以下任一操作：
- 如需将术语与资产相关联，请在详细信息标签页的词汇表术语部分中，点击添加。搜索并选择相应条款，然后点击关闭。
- 如果资产具有架构，您可以将术语与列相关联。在架构标签页上，选择要关联术语的列，然后点击添加业务术语。搜索并选择相应条款，然后点击关闭。

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_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

替换以下内容：

PROJECT_NUMBER：要关联的数据资产的项目编号
ENTRY_LOCATION_ID：要关联的数据资产的位置 ID
ENTRY_GROUP_ID：要关联的数据资产的条目组
ENTRY_LINK_ID：术语与表示数据资产的 Dataplex Universal Catalog 条目之间的链接 ID。
TERM_PROJECT_NUMBER：要关联的术语的项目编号。

将术语附加到条目架构中的列

控制台

在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 搜索页面。

转到搜索
搜索具有包含您要将术语关联到的列的架构的数据资产（例如数据集、文件或表格）。点击数据资产。
在数据资产页面上，执行以下任一操作：
- 如需将术语与数据资产中的列相关联，请在架构标签页上选择要附加术语的列。
- 点击添加业务术语。搜索要附加的字词，然后点击要附加的字词。

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_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE"
  "path": "Schema/COLUMN_NAME"
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

替换以下内容：

PROJECT_NUMBER：要关联的数据资产的项目编号
ENTRY_LOCATION_ID：要关联的数据资产的位置 ID
ENTRY_GROUP_ID：要关联的数据资产的条目组
ENTRY_LINK_ID：术语与表示数据资产的 Dataplex Universal Catalog 条目之间的链接的 ID
TERM_PROJECT_NUMBER：要关联的术语的项目编号
COLUMN_NAME：要将相应字词附加到的列

从数据资产中移除术语

控制台

在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 搜索页面。

转到搜索
搜索要移除使用条款的数据资产（例如数据集、文件或表格），然后点击该资产。
在数据资产页面上，执行以下任一操作：
- 如需从素材资源中移除某个术语，请在详细信息标签页的词汇表术语部分中点击相应术语。然后点击。
- 如需从列中移除某个字词，请在架构标签页中点击该字词旁边的。

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/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

查找术语库、术语和关联的数据资产

控制台

如需浏览业务术语库内容，请使用术语库页面上的术语库和术语树。

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

前往“术语库”
在词汇表页面上，使用过滤栏查找类别。您可以使用以下过滤条件：
- 名称：返回名称中包含您提供的文本的词库、类别和术语。
- 父级：返回父级术语库名称或说明与您提供的文本匹配的术语。例如，parent:Finance 会返回与名称或说明包含字词 Finance 的父级术语库相关联的术语。
- 同义词：返回名称或 ID 包含您提供的文本的同义词的术语列表。例如，synonym:Profit 会返回具有同义词的术语，其中同义词的名称或 ID 包含短语 profit。
- 联系人：返回数据管理员被列为联系人的术语。例如，contact:alex@example.com 会返回与数据管理员匹配 alex@example.com 的术语相关联的条目。

REST

如需使用 REST API 查找术语库、术语和关联的数据资产，您需要注册参加预览版计划。

搜索与术语相关联的数据资产

控制台

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

前往“术语库”
在词汇表页面上，使用过滤条件栏输入自由格式的文本搜索查询。这会返回术语库、类别和术语名称中相应匹配项的列表。
点击匹配的术语。
在术语详情页面上，查看与该术语相关联的字词（同义词和相关字词）和条目（数据资产）。
如果您想查看 Dataplex Universal Catalog 中某个条目的详细信息，请点击该条目。

REST

如需使用 REST API 查找术语库、术语和关联的数据资产，您需要注册参加预览版计划。

导入术语库以及术语与术语或数据资产之间的链接

如需从其他编目工具导入术语表和链接，或更新 Dataplex Universal Catalog 中的术语表，您可以使用 REST API 批量导入术语表、类别、术语、术语之间的链接、术语与数据资产之间的链接或列。

创建目标术语表。

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=GLOSSARY_ID -d "$(cat<<EOF

{
 "displayName": "DISPLAY_NAME",
 "description": "DESCRIPTION"
}
EOF
)"

替换以下内容：

PROJECT_ID：您要在其中创建术语表的项目 ID
LOCATION_ID：我们要在其中创建术语表的位置
GLOSSARY_ID：术语表 ID
DISPLAY_NAME：术语表的显示名称
DESCRIPTION：术语表的说明

如需导入目标术语表中创建的类别、术语以及术语与数据资产之间的链接，请将这些文件分别上传到 Cloud Storage 存储桶。这些文件的格式如下：

术语表中的术语和类别示例格式

 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}

术语之间链接的格式示例

 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}

术语与数据资产之间链接的示例格式

 projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}

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

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "glossaries": "GLOSSARY_NAME"
     }
  }
}
EOF
)"

将 DATAPLEX_API 替换为 Dataplex Universal Catalog API 端点，格式为 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID。

可选：获取操作的状态。

gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

将 OPERATION_ID 替换为操作的 ID。

可选：获取元数据作业的状态。

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

将术语之间的链接作为同义词或相关字词导入。

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
           "projects/dataplex-types/locations/global/entryLinkTypes/related"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
  }
}
EOF
)"

将 DATAPLEX_API 替换为 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID。

导入术语与数据资产或列之间的链接。

如需在术语库术语与数据资产之间创建关联，请为数据资产条目所属的每个条目组运行导入作业。所有定义条目链接均在此条目组中创建。

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
"type":"IMPORT",
"import_spec":{
  "log_level":"DEBUG",
  "source_storage_uri":"gs://STORAGE_BUCKET/",
  "entry_sync_mode":"FULL",
  "aspect_sync_mode":"INCREMENTAL",
  "scope":{
     "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
     ],
     "entry_link_types":[
        "projects/dataplex-types/locations/global/entryLinkTypes/definition"
     ],
     "referenced_entry_scopes":[
        "PROJECT_IDS"
     ]
  }
}
}
EOF
)"

将 DATAPLEX_API 替换为 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID。

价格

自 2026 年 7 月起，Dataplex Universal Catalog 业务术语库将按与元数据存储相同的价格计费。请参阅 Dataplex Universal Catalog 元数据存储价格。

后续步骤

如果您使用的是 Data Catalog 的业务术语库预览版，请参阅转换到 Dataplex Universal Catalog 中的业务术语库。

管理业务术语表 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

业务术语表的要素

术语库

类别

术语

同义词

相关字词

限制

所需的角色

所需权限

创建和管理业务术语库

创建业务术语库

控制台

REST

查看可用的术语库

控制台

REST

修改术语库

控制台

REST

删除术语表

控制台

REST

创建和管理类别

在术语库下创建类别

控制台

REST

创建嵌套类别

控制台

REST

查看术语库所属的类别

控制台

REST

修改类别

控制台

REST

删除类别

控制台

REST

创建和管理术语

在业务术语库下创建术语

控制台

REST

在类别下创建术语

控制台

REST

查看术语库或类别中的术语

控制台

REST

查看术语的详细信息

控制台

REST

修改术语

控制台

REST

删除术语

控制台

REST

管理同义词和相关字词

创建术语之间的同义词链接

控制台

REST

创建术语之间的相关链接

控制台

REST

移除同义词和相关字词之间的链接

控制台

REST

管理术语与数据资产之间的关联

将条款附加到数据资产

控制台

REST

将术语附加到条目架构中的列

控制台

REST

从数据资产中移除术语

控制台

REST

查找术语库、术语和关联的数据资产

控制台

管理业务术语表