透過管理工作流程要求變更中繼資料

本文說明如何使用治理工作流程,針對組織詞彙類別和詞彙,以及 Knowledge Catalog (原稱 Dataplex Universal Catalog) 項目,提出單一資源變更。

事前準備

如要使用管理工作流程變更中繼資料,請務必啟用必要 API,並具備必要 Identity and Access Management (IAM) 角色和權限。

啟用 Dataplex API (如果尚未啟用)。

啟用 API 所需的角色

您必須具備 serviceusage.services.enable 權限,才能啟用 API。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

必要的角色

如要取得要求變更中繼資料所需的權限,請要求管理員在專案、詞彙表或項目群組中,授予您下列 IAM 角色:

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

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如要進一步瞭解角色和權限,請參閱「Knowledge Catalog IAM 角色」。

要求變更詞彙表類別

如果您沒有直接寫入權限,無法建立、更新或刪除詞彙表類別,可以使用管理工作流程要求這類變更。提交中繼資料變更要求後,要求者、核准者和工作流程管理員可以在要求的整個生命週期中監控及管理要求。

建立類別

控制台

如要要求新增類別,請按照下列步驟操作:

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

    前往「Glossaries」(詞彙表)

  2. 選取要建立類別的詞彙表,然後按一下「Create category」(建立類別)。

  3. 輸入類別的顯示名稱。

  4. 選用:在「Labels」(標籤) 專區中,新增詞彙表的標籤。

  5. 選用:在「Justification」(理由) 部分,向核准者說明變更原因。

  6. 在「進階設定」部分,您可以編輯「類別 ID」,變更自動產生的 ID。

  7. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求建立類別,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:父項詞彙表的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

更新類別

控制台

如要建議變更類別,請按照下列步驟操作:

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

    前往「Glossaries」(詞彙表)

  2. 選取要更新類別的詞彙表。

  3. 按一下類別名稱,開啟「Category details」(類別詳細資料) 窗格。

  4. 如要新增或更新類別詳細資料,請按一下要更新的區段旁邊的 「Add」(新增) 或 「Edit」(編輯)。

  5. 按一下「送交審查」。部分項目可能需要額外說明變更理由。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求更新類別顯示名稱和說明,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:父項詞彙表的 ID。
  • CATEGORY_ID:要更新的目標類別 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

刪除類別

控制台

如要要求刪除類別,請按照下列步驟操作:

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

    前往「Glossaries」(詞彙表)

  2. 展開詞彙表,然後按一下要刪除的類別。

  3. 在「Category details」(類別詳細資料) 窗格中,選取選單中的 「Delete」(刪除)。

  4. 選用:在「Justification」(理由) 部分,向核准者說明變更原因。

  5. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求刪除類別,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:上層詞彙表的 ID。
  • CATEGORY_ID:要刪除的目標類別 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

要求變更詞彙表字詞

如果您沒有直接寫入權限,無法建立、更新或刪除詞彙,可以使用管理工作流程要求這類變更。

建立詞彙表字詞

控制台

請按照下列步驟要求建立詞彙:

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

    前往「Glossaries」(詞彙表)

  2. 選取要建立字詞的詞彙表或類別,開啟詳細資料窗格。

    • 如要從詞彙表詳細資料頁面建立字詞,請選取選單中的「建立字詞」。
    • 如要從類別詳細資料頁面建立字詞,請選取選單中的「新增字詞」。
  3. 輸入類別的顯示名稱。

  4. 選用:在「標籤」部分,新增字詞標籤。

  5. 選用:在「Justification」(理由) 部分,向核准者說明變更原因。

  6. 在「進階設定」部分,您可以編輯「字詞 ID」,變更自動產生的 ID。

  7. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求建立詞彙表字詞,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:父項詞彙表的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

更新詞彙表字詞

控制台

如要要求變更詞彙,請按照下列步驟操作:

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

    前往「Glossaries」(詞彙表)

  2. 選取包含要更新字詞的詞彙表。

  3. 按一下字詞名稱,開啟「Term details」(字詞詳細資料) 窗格。

  4. 按一下要更新部分旁邊的「新增」圖示 或「編輯」圖示 ,即可新增或更新字詞詳細資料。

  5. 按一下「送交審查」。部分區段可能需要您提供額外理由,才能提交要求。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求更新詞彙表字詞的顯示名稱和說明,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:上層詞彙表的 ID。
  • TERM_ID:要更新的目標字詞 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

刪除詞彙表字詞

控制台

如要要求刪除字詞,請按照下列步驟操作:

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

    前往「Glossaries」(詞彙表)

  2. 選取要刪除詞彙的詞彙表。

  3. 按一下字詞名稱,開啟「Term details」(字詞詳細資料) 窗格。

  4. 點選「刪除」。

  5. 按一下「送交審查」。部分區段可能需要您提供額外理由,才能提交要求。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求刪除詞彙表字詞,請使用 glossaries.requestGlossaryChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:詞彙表所在的區域,例如 us-central1。
  • GLOSSARY_ID:上層詞彙表的 ID。
  • TERM_ID:要刪除的目標字詞 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含 ChangeRequest 資源名稱的 RequestGlossaryChangeResponse。系統會記錄新的變更要求,並通知核准者。

要求變更項目

如果您沒有直接寫入權限,無法建立、修改或刪除 Knowledge Catalog 項目,可以使用管理工作流程要求這類變更。

建立項目

控制台

請按照下列步驟要求建立項目:

  1. 前往 Google Cloud 控制台的 Knowledge Catalog「Metadata types」(中繼資料類型) 頁面。

    前往「Metadata types」(中繼資料類型) 頁面

  2. 按一下「Entry groups」(項目群組) 分頁標籤。

  3. 選取要建立項目的項目群組,然後按一下「Create entry」(建立項目)。

  4. 輸入項目的 ID 和顯示名稱。

  5. 選取項目類型。

  6. 選用:提供面向詳細資料或新增說明。

  7. 按一下「送交審查」。部分區段可能需要您提供額外理由,才能提交要求。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求建立項目,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_TYPE_ID:項目類型的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

更新項目

控制台

如要要求更新項目,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 或「Catalog」(目錄) 頁面。

前往「Search」(搜尋) 頁面

  1. 搜尋並選取要更新的項目。
  2. 按一下項目,開啟「Entry details」(項目詳細資料) 頁面。
  3. 按一下要更新的部分旁邊的「 新增」。
  4. 更新區段。
  5. 按一下「送交審查」。部分區段可能需要您提供額外理由,才能提交要求。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求更新項目來源顯示名稱和說明,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_ID:目標項目的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

刪除項目

控制台

如要要求刪除項目,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 或「Catalog」(目錄) 頁面。

前往「Search」(搜尋) 頁面

  1. 搜尋並選取要刪除的項目。
  2. 按一下項目,開啟「Entry details」(項目詳細資料) 頁面。
  3. 點選「刪除」。
  4. 按一下「送交審查」。部分區段可能需要您提供額外理由,才能提交要求。提供理由,然後按一下「Proceed to Submit Changes」(繼續提交變更)。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求刪除項目,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_ID:要刪除的目標項目 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

更新切面

控制台

如要要求更新某個面向,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

前往「Search」(搜尋) 頁面

  1. 搜尋並選取要申請變更的項目。
  2. 按一下項目,開啟「Entry details」(項目詳細資料) 頁面。
  3. 前往「切面」部分,然後點選「 新增」。
  4. 提供切面詳細資料。
  5. 選用:提供變更原因。
  6. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求附加或更新項目的聯絡人切面,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_ID:目標項目的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

建立項目連結

控制台

請按照下列步驟要求建立項目連結,例如附加詞彙表字詞:

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

    前往「Search」(搜尋) 頁面

  2. 搜尋並選取要連結詞彙的資料資產項目。

  3. 在項目詳細資料頁面,執行下列任一操作:

    • 如要將字詞連結至項目,請在「Details」(詳細資料) 分頁的「Glossary terms」(詞彙表字詞) 區段中,按一下「Add」(新增)。
    • 如要將字詞連結至資料欄,請在「Schema」(結構定義) 分頁中選取資料欄,然後按一下「Add business term」(新增業務字詞)。
  4. 搜尋並選取要連結的字詞。

  5. 選用:提供變更原因。

  6. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求在詞彙表字詞和資料資產項目之間建立定義連結,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_ID:目標項目的 ID。
  • GLOSSARY_ID:包含該字詞的詞彙表 ID。
  • TERM_ID:詞彙表字詞的 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

刪除項目連結

控制台

如要要求刪除項目連結 (例如移除附加的詞彙表字詞),請按照下列步驟操作:

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

    前往「Search」(搜尋) 頁面

  2. 搜尋並選取要移除連結字詞的資料資產項目。

  3. 在項目詳細資料頁面,執行下列任一操作:

    • 如要從項目中移除字詞,請在「Details」(詳細資料) 分頁的「Glossary terms」(詞彙表字詞) 區段中,按一下該字詞,然後點選 「Remove」(移除)。
    • 如要從資料欄中移除字詞,請在「Schema」(結構定義) 分頁中,按一下字詞旁的 「Remove」(移除)。
  4. 選用:提供變更原因。

  5. 按一下「送交審查」。

系統會記錄新的變更要求,並通知核准者。您可以在「Governance Workflows」(管理工作流程) 頁面的「My Requests」(我的要求) 分頁追蹤要求進度。

REST

如要要求刪除詞彙表字詞與資料資產項目之間的項目連結,請使用 entryGroups.requestCatalogChange 方法:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

更改下列內容:

  • PROJECT_ID:Google Cloud 專案的 ID。
  • LOCATION:項目群組所在的區域,例如 us-central1。
  • ENTRY_GROUP_ID:父項項目群組的 ID。
  • ENTRY_LINK_ID:要刪除的目標項目連結 ID。
  • JUSTIFICATION:說明提議變更的原因。

服務會傳回包含變更要求資源名稱的回應。系統會記錄新的變更要求,並通知核准者。

後續步驟