自 2026 年 4 月 10 日起，Dataplex Universal Catalog 將更名為 Knowledge Catalog。API、用戶端程式庫、CLI 和 IAM 名稱維持不變。詳情請參閱「隆重推出 Google Cloud Knowledge Catalog」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

管理商務詞彙表

本文說明如何在 Knowledge Catalog (舊稱 Dataplex Universal Catalog) 中建立及管理業務詞彙表。使用業務詞彙表為資料資產建立標準化詞彙，減少模糊不清之處，並提升整個機構的資料探索和控管作業。

Knowledge Catalog 組織詞彙應用實例

使用 Knowledge Catalog 組織詞彙建立資料通用語言，可達成下列目標：

明確定義業務類別和字詞的階層。
使用同義字連結概念，並顯示字詞之間的關係。
根據業務概念 (而非僅限技術名稱) 搜尋資料資源。

Knowledge Catalog 業務詞彙表可簡化資料探索作業並減少模糊不清之處，進而提升管理成效、提高分析準確度，並加快取得洞察資料的速度。

業務詞彙表的要素

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

詞彙

字彙表具有下列屬性：

總覽。說明業務字彙表的用途和內容。你可以新增圖片、連結和表格。雖然不支援 HTML 格式，但您可以加入格式為程式碼的 HTML 程式碼，或新增 HTML 網頁的連結。你也可以使用 RTF 格式選項，例如粗體、斜體、底線、項目符號清單、段落、標題和程式碼區塊。大小上限為 120 KB。
說明。說明詞彙表。系統會為這個欄位的文字建立索引，方便搜尋。支援的大小上限為 1 KB。
區域。指定詞彙表所在的區域。

類別

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

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

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

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

字詞

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

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

同義字：指定同義字詞之間的連結。請參閱同義字詞。
相關條款。指定概念相關但意義不同的字詞之間的連結。請參閱相關條款。
相關項目。指定字詞與資料資產之間的連結，或字詞與資料資產內欄之間的連結。
資料品質規則。指定該字詞的資料品質規定。詳情請參閱「重複使用資料品質規則」。
聯絡人。指定負責維護字詞的人員。字詞不會沿用類別中定義的聯絡人。

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

同義詞

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

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

限制

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

必要的角色

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

資料管理員可透過以下角色，取得詞彙表、類別、字詞、同義詞和相關字詞的完整存取權，並設定 IAM 政策： Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin)
資料管理員或資料擁有者可透過 Dataplex Catalog 編輯器 (roles/dataplex.catalogEditor) 建立、編輯或刪除詞彙表、類別、字詞、字詞間的連結、字詞與資料資產間的連結，以及進行搜尋：
資料分析師或資料消費者可取得詞彙表、類別、字詞、字詞之間和字詞與資料資產之間的連結，以及搜尋功能的唯讀權限： Dataplex Catalog 檢視者 (roles/dataplex.catalogViewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備建立及管理術語表所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要建立及管理字彙表，必須具備下列權限：

在專案中建立、讀取、更新及刪除組織詞彙、類別和字詞：
- 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 在專案的 Knowledge Catalog 項目群組中，其中一個術語存在於該專案中。連結會建立在已授予權限的項目群組中。
- 在專案中，如果 Knowledge Catalog 項目群組含有任一詞彙表字詞，您必須具備該項目群組的 dataplex.entryGroups.useSynonymEntryLink 權限。連結會建立在已授予權限的項目群組中。
- dataplex.glossaryTerms.use 在需要關聯字詞的詞彙表上。
- dataplex.glossaryTerms.get ，找出要查詢同義詞連結的字詞。如果缺少這些字詞的 dataplex.glossaryTerms.get 權限，Knowledge Catalog 會在回應中隱藏同義字詞。
- 在連結所在的專案中，對 Knowledge Catalog 項目群組執行 dataplex.entryLinks.delete。
在專案中建立、查詢及刪除相關的字詞對應連結：
- dataplex.entryLinks.create 在專案的 Knowledge Catalog 項目群組中，其中一個術語存在於該專案中。連結會建立在已授予權限的項目群組中。
- dataplex.entryGroups.useRelatedEntryLink 在專案的 Knowledge Catalog 項目群組中，其中一個術語存在於該專案中。連結會建立在已授予權限的項目群組中。
- 在含有對應詞彙表字詞項目的專案中，對 Knowledge Catalog 項目群組執行 dataplex.entries.link。
- dataplex.glossaryTerms.get 查詢相關連結的字詞。如果您沒有這些字詞的 dataplex.glossaryTerms.get 權限，Knowledge Catalog 會在回覆中隱藏相關字詞。
- 在連結所在的專案中，對 Knowledge Catalog 項目群組執行 dataplex.entryLinks.delete。
在專案中建立、查詢及刪除字詞與資料資產或資料欄之間的連結：
- dataplex.entryLinks.create 在專案中對應於資料資產或資料欄的系統項目群組上。連結會在授予權限的專案中建立。
- dataplex.entryGroups.useDefinitionEntryLink ，適用於專案中與資料資產或資料欄對應的系統項目群組。連結會在授予權限的專案中建立。
- dataplex.entries.link 在對應至專案中資料資產或資料欄的系統項目群組上。連結會在授予權限的專案中建立。
- dataplex.glossaryTerms.use on the glossary whose term needs to be associated.
- 您要查詢連結的項目，必須具備來源系統讀取權限 (例如 bigquery.tables.get 或 dataplex.glossaryTerms.get)。如果您沒有這些資產的來源系統讀取權限，Knowledge Catalog 會在回應中遮蓋資料資產。
- dataplex.entryLinks.delete on the system entry group in which the link is present.

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

詳情請參閱「Knowledge Catalog IAM 角色」。

建立及管理商務詞彙表

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

建立組織詞彙

控制台

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

前往「字彙表」
按一下「建立組織詞彙」。
在「建立組織詞彙」頁面中，指定組織詞彙的名稱和位置。建立字彙表後，您就無法變更位置。
點按「Create」(建立)。詞彙表會在目前的專案下建立。
選用：在「說明」Description中新增簡短說明 (最多 1,024 個字元)，或在「總覽」Overview中新增詳細說明 (最多 120 KB)。

REST

建立詞彙表時，Knowledge 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 個字元

選用：在詞彙表中新增總覽。

查詢 Look 圖表項目：

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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「Glossaries」(詞彙表) 頁面。

前往「字彙表」
選取要建立類別的字彙表，然後按一下「建立類別」。
輸入類別名稱。
點選「建立」。
選用：在「說明」Description中新增簡短說明 (最多 1,024 個字元)，或在「總覽」Overview中新增詳細說明 (最多 120 KB)。

REST

建立類別時，Knowledge 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 控制台，前往 Knowledge Catalog 的「Glossaries」(詞彙表) 頁面。

前往「字彙表」
展開要建立類別的字彙表。
選取要建立其他類別的父類別，然後按一下「建立類別」。
輸入類別名稱。
點選「建立」。
選用：在「說明」Description中新增簡短說明 (最多 1,024 個字元)，或在「總覽」Overview中新增詳細說明 (最多 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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「Glossaries」(詞彙表) 頁面。

前往「字彙表」
如要在術語表層級建立術語，請選取要建立術語的術語表，然後按一下「建立術語」。
輸入字詞名稱。
點選「建立」。
選用：在「說明」Description中新增簡短說明 (最多 1,024 個字元)，或在「總覽」Overview中新增詳細說明 (最多 120 KB)。
選用：如要新增聯絡人，請按一下「編輯」，然後提供資料管理員、資料擁有者或資料網域擁有者的電子郵件地址清單。選擇這個選項後，按一下 [儲存]。

REST

建立字詞時，Knowledge 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 控制台，前往 Knowledge Catalog 的「Glossaries」(詞彙表) 頁面。

前往「字彙表」
如要在類別中建立字詞，請選取要建立字詞的類別，然後按一下「新增字詞」。
輸入字詞名稱。
點選「建立」。
選用：在「說明」Description中新增簡短說明 (最多 1,024 個字元)，或在「總覽」Overview中新增詳細說明 (最多 120 KB)。
選用：如要新增聯絡人，請按一下「編輯」，然後提供資料管理員、資料擁有者或資料網域擁有者的電子郵件地址清單。選擇這個選項後，按一下 [儲存]。

REST

建立字詞時，Knowledge 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 控制台的 Knowledge Catalog「Glossaries」(詞彙表) 頁面。

前往「字彙表」
展開字彙表，然後按一下要新增層面的字詞。
在「層面」部分中，按一下「新增」。
搜尋該層面，提供該層面的詳細資料，然後按一下「儲存」。

REST

詞彙表字詞就是詞彙表項目。如要附加切面，請修補項目資源。詞彙表的項目群組為 @dataplex。

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_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "achalg@google.com"
     }
   }
 }
}
EOF

更改下列內容：

PROJECT_NUMBER：包含詞彙表字詞的專案編號。
LOCATION_ID：詞彙表字詞的位置。
GLOSSARY_ID：包含字詞的詞彙表 ID。
TERM_ID：要附加層面的字詞 ID。
ASPECT_PROJECT_ID：包含構面類型的專案 ID。
ASPECT_LOCATION_ID：構面類型的位置。
ASPECT_TYPE_ID：切面類型 ID。

查看詞彙表或類別中的字詞

控制台

在 Google Cloud 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「Glossaries」(詞彙表) 頁面。

為字詞新增切面

您可以為字詞新增切面，提供額外背景資訊或中繼資料。

控制台

前往 Google Cloud 控制台的 Knowledge Catalog「Glossaries」(詞彙表) 頁面。

前往「字彙表」
展開字彙表，然後按一下要新增層面的字詞。
在「層面」部分中，按一下「新增」。
搜尋該層面，提供該層面的詳細資料，然後按一下「儲存」。

REST

詞彙表字詞就是詞彙表項目。如要附加切面，請修補項目資源。詞彙表的項目群組為 @dataplex。

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_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "achalg@google.com"
     }
   }
 }
}
EOF

更改下列內容：

PROJECT_NUMBER：包含詞彙表字詞的專案編號。
LOCATION_ID：詞彙表字詞的位置。
GLOSSARY_ID：包含字詞的詞彙表 ID。
TERM_ID：要附加層面的字詞 ID。
ASPECT_PROJECT_ID：包含構面類型的專案 ID。
ASPECT_LOCATION_ID：構面類型的位置。
ASPECT_TYPE_ID：切面類型 ID。前往「字彙表」

展開字彙表，然後按一下要編輯的字詞。
按一下 [編輯]。
編輯任何欄位，然後按一下「儲存」。

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 控制台，前往 Knowledge Catalog 的「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 控制台，前往 Knowledge Catalog 的「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。每個字詞都以 Knowledge Catalog 項目表示。項目連結是同義字詞之間的關係。

控制台

在 Google Cloud 控制台，前往 Knowledge Catalog 的「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。每個字詞都以 Knowledge 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/TERM_PROJECT_ID/locations/SYNONYM_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/synonym&page_size=10

更改下列內容：

TERM_PROJECT_ID：您要查詢同義字連結的字詞專案 ID。
TERM_PROJECT_NUMBER：您要查詢同義字連結的字詞專案編號。
SYNONYM_LINKS_LOCATION_ID：您要查詢同義字連結的位置 ID。
TERM_LOCATION_ID：地區 ID。
TERM_GLOSSARY_ID：包含該字詞的詞彙表 ID。
TERM_ID：字詞的 ID。

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/TERM_PROJECT_ID/locations/RELATED_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/related&page_size=10

更改下列內容：

TERM_PROJECT_ID：您要查詢相關連結的字詞專案 ID。
TERM_PROJECT_NUMBER：要查詢相關連結的字詞專案編號。
RELATED_LINKS_LOCATION_ID：您要查詢相關連結的地區 ID。
TERM_LOCATION_ID：地區 ID。
TERM_GLOSSARY_ID：包含該字詞的詞彙表 ID。
TERM_ID：字詞的 ID。

移除同義詞和相關字詞之間的連結

控制台

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

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

REST

查詢項目連結，找出要刪除的連結項目連結 ID。詳情請參閱「查詢字詞的同義字連結」或「查詢字詞的相關連結」。

傳送下列 DELETE 要求，刪除連結：

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 資料集和 Iceberg REST 目錄資料表。

將字詞附加至資料資產

控制台

在 Google Cloud 控制台，前往 Knowledge 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：術語與代表資料資產的 Knowledge Catalog 項目之間的連結 ID。
TERM_PROJECT_NUMBER：要連結的字詞專案編號。

將字詞附加至項目結構定義中的資料欄

控制台

在 Google Cloud 控制台，前往 Knowledge 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",
  "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：術語與代表資料資產的 Knowledge Catalog 項目之間的連結 ID
TERM_PROJECT_NUMBER：要連結的字詞專案編號
COLUMN_NAME：要附加字詞的資料欄

將詞彙附加至多個資料資產或資料欄

您可以同時將單一詞彙附加至多個資料資產或資料欄。單一作業最多可選取 20 個資源或資料欄。

控制台

如要將字詞附加至多項資源，請按照下列步驟操作：

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

前往「字彙表」
在「字彙表」清單中，展開含有要連結字詞的字彙表。
按一下學期。
在「相關項目」部分中，按一下「新增」。
在「Attach related entries」(附加相關項目) 對話方塊中，完成下列步驟：
1. 找出要連結的資源或資料欄。如要縮小搜尋結果範圍，請使用「篩選器」，依資源名稱、資源類型或資料欄名稱搜尋。
  
  舉例來說，如要在 ID 為 sample-project 的專案中，尋找名為 sample-table 的 BigQuery 資料表內名為 sample-column 的資料欄，請使用下列查詢：
```
project id:sample-project
Resource Name:sample-table
Column Name:sample-column
```
  您可以輸入部分字串，找出相符的資產。
2. 選取要附加的資料資產和資料欄。
3. 如要在新增前查看所選資源，請按一下「顯示所選資源」切換按鈕。
4. 按一下「新增」。
如要驗證新附加的資源和資料欄，請前往詞彙詳細資料頁面的「相關項目」部分。

查詢連結至字詞的資料資產

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/TERM_PROJECT_ID/locations/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=TARGET&page_size=10

更改下列內容：

TERM_PROJECT_ID：您要查詢定義連結的字詞專案 ID。
TERM_PROJECT_NUMBER：您要查詢定義連結的字詞專案編號。
DEFINITION_LINKS_LOCATION_ID：您要查詢定義連結的位置 ID。
TERM_LOCATION_ID：地區 ID。
TERM_GLOSSARY_ID：包含該字詞的詞彙表 ID。
TERM_ID：字詞的 ID。

與資料資產相關聯的查詢字詞

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/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=SOURCE&page_size=10

更改下列內容：

PROJECT_ID：您要查詢定義連結的資料資產專案 ID。
PROJECT_NUMBER：資料資產的專案編號，您要查詢該資產的定義連結。
DEFINITION_LINKS_LOCATION_ID：您要查詢定義連結的位置 ID。
ENTRY_LOCATION_ID：資料資產的位置 ID。
ENTRY_GROUP_ID：資料資產的項目群組 ID。
ENTRY_ID：資料資產的 ID。

從資料資產中移除字詞

控制台

在 Google Cloud 控制台，前往 Knowledge 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 控制台的 Knowledge Catalog「Glossaries」(詞彙表) 頁面。

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

REST

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

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

控制台

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

前往「字彙表」
在「字彙表」頁面，使用篩選列輸入任意文字搜尋查詢。這會傳回字彙表、類別和字詞名稱中相應的相符項目清單。
按一下相符的字詞。
在「字詞詳細資料」頁面中，查看連結至這個字詞的字詞 (同義字和相關字詞) 和連結的項目 (資料資產)。
如要查看 Knowledge Catalog 中項目的詳細資料，請按一下該項目。

REST

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

定價

2026 年 7 月起，Knowledge Catalog 組織詞彙的計費方式將與中繼資料儲存空間定價相同。請參閱「Knowledge Catalog 中繼資料儲存空間定價」。

後續步驟

如果您使用的是 Data Catalog 組織詞彙的預先發布版，請參閱「轉移至 Knowledge Catalog 組織詞彙」。
瞭解如何建構基礎資料治理。

管理商務詞彙表 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Knowledge Catalog 組織詞彙應用實例

業務詞彙表的要素

詞彙

類別

字詞

同義詞

相關字詞

限制

必要的角色

所需權限

建立及管理商務詞彙表

建立組織詞彙

控制台

REST

查看可用的字彙表

控制台

REST

編輯詞彙表

控制台

REST

刪除詞彙表

控制台

REST

建立及管理類別

在詞彙表下建立類別

控制台

REST

建立巢狀類別

控制台

REST

查看術語表所屬的類別

控制台

REST

編輯類別

控制台

REST

刪除類別

控制台

REST

建立及管理字詞

在商務詞彙表下建立字詞

控制台

REST

在類別下建立字詞

控制台

REST

為字詞新增切面

控制台

REST

查看詞彙表或類別中的字詞

控制台

REST

查看字詞詳細資料

控制台

REST

編輯字詞

控制台

為字詞新增切面

控制台

REST

REST

刪除字詞

控制台

REST

管理同義字和相關字詞

在字詞之間建立同義字連結

控制台

REST

在字詞之間建立相關連結

控制台

REST

查詢字詞的同義詞連結

REST

查詢字詞的相關連結

REST

移除同義詞和相關字詞之間的連結

控制台

REST

管理字詞與資料資產之間的連結

管理商務詞彙表