本頁面由 Cloud Translation API 翻譯而成。

管理商務詞彙表

Dataplex Universal Catalog 商務詞彙表提供單一平台，可供您管理公司內與業務相關的術語和定義。

如果不同團隊共同處理專案，或是大型公司有許多部門，企業的每個部分通常會建立自己的術語，用來描述他們使用的各種資料資源。這可能會導致溝通不良，以及對這些資源的理解不一致。此外，有時概念可能需要技術或專業知識。這可能會導致其他網域的商家使用者難以理解這個概念。

Dataplex Universal Catalog 商務詞彙表可讓您為資料資源建立集中式標準化詞彙。您可以透過業務字彙表執行下列操作：

定義業務類別和概念的階層式結構，稱為「字詞」。
定義同義詞和相關字詞，建立概念之間的連結。
將資料資源與詞彙表中的字詞建立關聯，即可根據業務概念搜尋資料資源。

業務詞彙表有助於簡化資料探索程序並減少模糊不清之處，進而提升分析準確度、改善管理機制，以及加快取得洞察資料的速度。

業務詞彙表的元素

本節說明可用於建構業務字彙表的關鍵要素。

詞彙

字彙表具有下列屬性：

總覽。說明業務字彙表的用途和內容。您可以在詞彙表新增圖片、連結、表格或格式化文字。支援的大小上限為 120 KB。
說明。說明詞彙表。系統會為這個欄位中的文字建立索引，以供搜尋。支援的大小上限為 1 KB。
區域。指定術語表的區域。

類別

「類別」可讓您整理及建構各種類別和字詞。類別是在業務詞彙中定義，類別最多可建立三層巢狀結構。

類別具有術語表的屬性，以及下列屬性：

聯絡人。指定負責維護類別的人員。這個屬性是說明性質，不會影響類別的權限。
上層。指定用於建立目前類別父項的關係。最多可建立三層巢狀類別。

類別的區域與包含該類別的字彙表區域相同。

字詞

術語 (簡稱「詞彙術語」) 是指公司特定業務分支中使用的概念。舉例來說，公司行銷部門可能會建立描述單次點擊出價的字詞。詞彙定義於商務詞彙表中，可直接在詞彙表或詞彙表中的任何類別中找到。

字詞具有類別的屬性，以及下列屬性：

同義字：指定同義字詞之間的連結。請參閱同義字。
相關條款。指定概念相關但意義不同的字詞之間的連結。請參閱相關條款。
相關項目。指定術語與資料資產之間的連結，或術語與資料資產內欄之間的連結。
聯絡人。指定負責維護字詞的人員。字詞不會沿用類別中定義的聯絡人。

詞彙的地區與包含該詞彙的字彙表地區相同。

同義詞

同義詞是一種關係，表示兩個不同字詞之間的等價關係。如果不同團隊在不同詞彙表中定義了兩個意義相同的字詞，請使用同義詞。舉例來說，您可以建立同義字，連結「利潤」和「收益」這兩個字詞。

相關字詞是一種關係，表示兩個字詞彼此相關，但意義不同。舉例來說，您可以建立相關字詞，連結「收益」和「利潤」這兩個字詞。

限制

Dataplex Universal Catalog 商務詞彙表不支援 Assured Workload 專案。
商業詞彙表位於專案和位置中，專案和位置的限制也適用於詞彙表。

必要的角色

如要取得建立及管理字彙表所需的權限，請要求管理員授予專案的下列 IAM 角色：

資料管理員可取得詞彙表、類別、字詞、同義字和相關字詞的完整存取權，並設定 IAM 政策： Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin)
資料管理員或資料擁有者可透過 Dataplex Catalog 編輯器 (roles/dataplex.catalogEditor) 建立、編輯或刪除詞彙表、類別、字詞、字詞之間的連結、字詞與資料資產之間的連結，以及搜尋：
資料分析師或資料消費者可取得詞彙表、類別、字詞、字詞間的連結，以及字詞與資料資產間的連結的唯讀權限，並進行搜尋： Dataplex Catalog 檢視者 (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 ，連結所在的系統項目群組。

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

詳情請參閱「資料目錄的預先定義角色」。

建立及管理商務詞彙表

下列各節說明如何建立、查看、編輯及刪除商家詞彙表。

建立商務詞彙表

控制台

在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
按一下「建立商務詞彙表」。
在「建立商務詞彙表」頁面中，指定商務詞彙表的名稱和位置。建立詞彙表後，您就無法變更位置。
按一下「建立」，詞彙表會在目前專案下建立。
選用：在「說明」中新增簡短說明 (最多 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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)

「我的字彙表」窗格會顯示您有權查看的所有機構字彙表，以及這些字彙表的說明和上次修改時間戳記。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
按一下要編輯的字彙表。
按一下名稱、說明或總覽旁的「編輯」，然後進行變更。
按一下 [儲存]。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
按一下要刪除的字彙表。
按一下「刪除」，然後在系統提示時確認刪除。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
選取要建立類別的字彙表，然後按一下「建立類別」。
輸入類別名稱。
點選「建立」。
選用：在「說明」中新增簡短說明 (最多 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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開要建立類別的字彙表。
選取要建立其他類別的父類別，然後按一下「建立類別」。
輸入類別名稱。
點選「建立」。
選用：在「說明」中新增簡短說明 (最多 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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
如要查看詞彙表中的類別，請展開詞彙表。
如要查看類別中的巢狀類別，請展開該類別。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要編輯的類別。
按一下名稱、說明或總覽旁的「編輯」，然後進行變更。
按一下 [儲存]。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要刪除的類別。
按一下「刪除」，然後在系統提示時確認刪除。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
如要在術語表層級建立術語，請選取要建立術語的術語表，然後按一下「建立術語」。
輸入字詞名稱。
點選「建立」。
選用：在「說明」中新增簡短說明 (最多 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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
如要在類別中建立字詞，請選取要建立字詞的類別，然後按一下「新增字詞」。
輸入字詞名稱。
點選「建立」。
選用：在「說明」中新增簡短說明 (最多 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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
如要查看詞彙中的字詞，請展開詞彙。如要查看本詞彙表中的類別，請展開該類別。如要查看巢狀類別中的字詞，請展開巢狀類別。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
如要查看詞彙表中的字詞清單，請展開詞彙表。
按一下學期，「字詞詳細資料」頁面會顯示字詞名稱、說明、相關字詞、同義字和相關項目。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後點選要編輯的字詞。
按一下 [編輯]。
編輯任何欄位，然後按一下「儲存」。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要刪除的字詞。
按一下「刪除」，然後在系統提示時確認刪除。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要建立連結的字詞。
按一下「同義字詞」旁的「編輯」。
搜尋並選取要連結的字詞。

選取字詞後，系統會立即連結。
按一下 [關閉]。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要建立連結的字詞。
按一下「相關字詞」旁的「編輯」。
搜尋並選取要連結的字詞。

選取字詞後，系統會立即連結。
按一下 [關閉]。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
展開字彙表，然後按一下要移除同義詞或相關字詞的字詞。
如要刪除相關字詞之間的連結，請按一下「相關字詞」旁邊的「編輯」。刪除相關字詞，然後按一下「關閉」。
如要刪除同義字之間的連結，請按一下「同義字」旁邊的「編輯」。刪除同義字，然後按一下「關閉」。

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 的「Search」(搜尋) 頁面。

前往「搜尋」頁面
搜尋要連結字詞的資料資產 (例如資料集、檔案或表格)，然後按一下該資產。
在資料資產頁面上，執行下列其中一項操作：
- 如要將詞彙連結至資產，請在「詳細資料」分頁的「詞彙」部分中，按一下「新增」。搜尋並選取所需字詞，然後按一下「關閉」。
- 如果資產有結構定義，您可以將字詞連結至欄。在「結構定義」分頁中，選取要連結字詞的資料欄，然後按一下「新增業務字詞」。搜尋並選取所需字詞，然後按一下「關閉」。

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 的「Search」(搜尋) 頁面。

前往「搜尋」頁面
搜尋具有架構的資料資產 (例如資料集、檔案或資料表)，該架構包含您要連結至字詞的資料欄。按一下資料資產。
在資料資產頁面上，執行下列其中一項操作：
- 如要將字詞連結至資料資產中的資料欄，請在「架構」分頁中，選取要附加字詞的資料欄。
- 按一下「新增企業字詞」。搜尋要附加的字詞，然後按一下該字詞進行附加。

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 的「Search」(搜尋) 頁面。

前往「搜尋」頁面
搜尋要移除條款的資料資產 (例如資料集、檔案或資料表)，然後按一下該資產。
在資料資產頁面上，執行下列其中一項操作：
- 如要從資產中移除字詞，請在「詳細資料」分頁的「詞彙表字詞」部分中，按一下該字詞。然後按一下。
- 如要從資料欄中移除字詞，請在「結構定義」分頁中，點按字詞旁的。

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 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
在「字彙表」頁面，使用篩選列尋找類別。可用的篩選條件如下：
- 名稱：傳回名稱包含您提供文字的字彙表、類別和字詞。
- 父項：傳回父項術語表名稱或說明與您提供的文字相符的術語。舉例來說，如果父項字彙表的名稱或說明包含「Finance」這個詞組，parent:Finance 就會傳回與該字彙表相關聯的字詞。
- 同義字：傳回同義字清單，其中同義字名稱或 ID 包含您提供的文字。舉例來說，synonym:Profit 會傳回含有同義字詞的字詞，而同義字詞的名稱或 ID 包含「profit」這個片語。
- 聯絡人：傳回資料監管員列為聯絡人的字詞。舉例來說，contact:alex@example.com 會傳回與資料管理員符合 alex@example.com 的字詞相關聯的項目。

REST

如要使用 REST API 尋找詞彙表、術語和連結的資料資產，請註冊加入搶先體驗計畫。

搜尋與字詞相關聯的資料資產

控制台

在 Google Cloud 控制台中，前往 Dataplex Universal Catalog 的「Glossaries」(詞彙表) 頁面。

前往「Glossaries」(詞彙表)
在「字彙表」頁面中，使用篩選列輸入任意文字搜尋查詢。這會傳回字彙表、類別和字詞名稱中相符的項目清單。
按一下相符的字詞。
在「字詞詳細資料」頁面中，查看連結至這個字詞的字詞 (同義字和相關字詞) 和連結的項目 (資料資產)。
如要查看 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 bucket。這些檔案的格式如下：

詞彙表字詞和類別的範例格式

 {"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

尋找詞彙表、字詞和連結的資料資產

控制台

管理商務詞彙表