管理資料產品

預先發布版

這項產品或功能 適用《服務專屬條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

本文適用於想要在 Dataplex Universal Catalog 中更新、刪除及授予資料產品存取權的資料產品擁有者。

如要進一步瞭解資料產品的架構和重要概念，請參閱「關於資料產品」。

事前準備

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

注意： 本指南假設您已有要管理的資料產品。如要進一步瞭解如何建立及設定資料產品，請參閱「建立資料產品」一文。

必要的角色

如要取得管理資料產品所需的權限，請要求管理員在專案中授予下列 IAM 角色：

• 擁有建立、更新、刪除及管理資料產品權限的完整權限： Dataplex 資料產品管理員 (roles/dataplex.dataProductsAdmin)
• 更新及管理現有資料產品： Dataplex 資料產品編輯者 (roles/dataplex.dataProductsEditor)
• 新增 schema、overview 和 contacts 等層面： Dataplex 項目和 EntryLink 擁有者 (roles/dataplex.entryOwner)
• 搜尋及新增資產： Dataplex Catalog 檢視者 (roles/dataplex.catalogViewer)
• 編輯系統切面類型，例如文件和合約切面 (更新頻率)： Dataplex Catalog 編輯者 (roles/dataplex.catalogEditor)

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

這些預先定義的角色具備管理資料產品所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要管理資料產品，必須具備下列權限：

• 編輯 overview 系統切面類型： dataplex.entryGroups.useOverviewAspect
• 編輯 refresh cadence 系統切面類型： dataplex.entryGroups.useRefreshCadenceAspect

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

授予資料產品存取權

資料產品擁有者必須讓產品可供探索，並授予必要角色，允許消費者搜尋、查看及要求存取資料產品。

如要授予資料產品消費者與資料產品互動所需的權限，請在資料產品資源中授予下列 IAM 角色：

• 在 Dataplex Universal Catalog 搜尋中搜尋及存取資料產品： Dataplex 資料產品消費者 (dataplex.dataProductsConsumer)
• 唯讀存取權，可查看資料產品定義和中繼資料： Dataplex 資料產品檢視者 (dataplex.dataProductsViewer)
• 要求資料產品的存取權：Dataplex 資料產品消費者 (dataplex.dataProductsConsumer)

資料產品消費者要求存取資料產品時，資料產品擁有者會收到電子郵件通知。

如要授予存取權，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Groups」(群組) 頁面。

   前往「群組」頁面

2. 搜尋與所要求權限層級相關聯的群組，然後選取該群組。

3. 按一下「新增成員」。

4. 新增主體。

5. 按一下 [儲存]。

詳情請參閱「在 Google Cloud 控制台中建立及管理 Google 群組」。

更新資料產品

您可以更新現有資料產品的基本詳細資料 (例如資料產品名稱、說明、擁有者詳細資料)、資產、存取群組、權限、合約、層面和額外說明文件。

更新資料產品的基本詳細資料

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新的資料產品。

3. 按一下「編輯資料產品」。

4. 視需要更新「資料產品名稱」、「圖示」、「說明」、「擁有者聯絡人」和「標籤」。

5. 按一下「更新資料產品」。

REST

如要更新資料產品的基本詳細資料，請使用 dataProducts.patch 方法。

舉例來說，如要更新資料產品的說明，請傳送下列 PATCH 要求：

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

更改下列內容：

• NEW_DESCRIPTION：資料產品的新說明
• PROJECT_ID：您 Google Cloud專案的 ID
• LOCATION：資料產品所在的區域
• DATA_PRODUCT_ID：資料產品的 ID

更新資料產品的資產

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新資產的資料產品。

3. 按一下「資產」分頁標籤。

4. 如要新增素材資源，請按照下列步驟操作：

   1. 按一下 +Add。

   2. 搜尋並選取要新增至資料產品的資產。所選資產必須與資料產品位於相同區域。

      如果您擁有必要權限，點選資產即可查看資產的中繼資料。

   3. 如要縮小搜尋結果範圍，請使用「篩選器」。

   4. 選取素材資源後，按一下「新增」。

5. 如要從資料產品中移除資產，請按照下列步驟操作：

   1. 找到要移除的素材資源，然後依序按一下 >「移除」。

   2. 按一下「移除」確認這項操作。

REST

如要將新的資料資產新增至資料產品，請使用 dataAssets.create 方法。如需程式碼範例，請參閱「選用：新增素材資源」。

如要從資料產品中刪除資料資產，請使用 dataAssets.delete 方法。舉例來說，請傳送下列 DELETE 要求：

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

更改下列內容：

• PROJECT_ID：您 Google Cloud專案的 ID
• LOCATION：要建立資料產品的區域
• DATA_PRODUCT_ID：資料產品的專屬 ID
• DATA_ASSET_ID：要從資料產品中移除的資料資產 ID

更新存取權群組和資產權限

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新存取群組和權限的資料產品。

3. 按一下「存取權群組和權限」分頁標籤。

4. 如要更新存取群組，請按照下列步驟操作：

   1. 按一下「Edit」(編輯)。

   2. 視需要更新存取權群組名稱、說明和 ID。

   3. 如要新增存取群組，請按一下「新增存取群組」，然後按照下列步驟操作：

      1. 在「存取群組名稱」欄位中，輸入新存取群組的名稱。例如：Analyst。

      2. 在「存取權群組說明」欄位中，輸入存取權群組的說明。

      3. 在「存取權群組 ID」欄位中，輸入要指派給這個存取權群組的 Google 群組電子郵件地址。要求存取這個存取權群組的資料產品消費者，可以新增為對應 Google 群組的成員。

         每個資料產品最多可新增三個存取群組。

   4. 按一下「新增」。

5. 如要移除存取群組，請按照下列步驟操作：

   1. 找到要移除的存取群組，然後依序按一下 >「移除」。

   2. 按一下「移除」確認這項操作。

6. 如果所選資料產品未設定任何存取群組，您可以點選「新增存取群組」，新增存取群組。

7. 如要更新素材資源權限，請按照下列步驟操作：

   1. 如要更新資產的權限，請依序點選 >「權限」。

   2. 更新必要的存取群組和 IAM 角色。

   3. 按一下 [設定]。

REST

如要更新與資料產品相關聯的存取群組，請使用 dataProducts.patch 方法。如需程式碼範例，請參閱「設定存取群組」。

如要更新資產權限，請使用 dataAssets.patch 方法。如需程式碼範例，請參閱「設定資產權限」。

更新資料產品合約

注意： 將重新整理頻率新增至合約後，就無法再編輯。 如果嘗試修改這個值，系統會顯示以下錯誤訊息： You don't have permission to change contract values。

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新合約的資料產品。

3. 按一下「合約」分頁標籤。

4. 如要更新現有合約，請按照下列步驟操作：

   1. 按一下「Edit」(編輯)。

   2. 更新必要欄位。

   3. 按一下 [儲存]。

5. 如果所選資料產品未附加合約，請按一下「新增合約」新增合約。

REST

如要更新合約，請使用 entries.patch 方法。如需程式碼範例，請參閱「新增合約」。

更新資料產品的各個層面

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新切面的資料產品。

3. 按一下「Aspects」(層面) 分頁標籤。

4. 如要更新層面，請按照下列步驟操作：

   1. 按一下要更新的層面。

   2. 按一下「Edit」(編輯)。

   3. 視需要更新切面類型、國家/地區和區域。

   4. 按一下 [儲存]。

5. 如要為資料產品新增層面，請按照下列步驟操作：

   1. 按一下「+ 新增面向」。

   2. 在「選取層面類型」欄位中，搜尋並從清單中選取層面類型。例如：Geo context。

   3. 在「國家/地區」欄位中，選取資產所屬的國家/地區。

   4. 在「Region」(區域) 欄位中，選取資產所屬的業務區域。

   5. 按一下 [儲存]。

6. 如要刪除層面，請按照下列步驟操作：

   1. 按一下要刪除的面向。

   2. 按一下「」。

   3. 如要確認操作，請按一下「確認」。

REST

如要更新資料產品項目的任何方面，請使用 entries.patch 方法。

更新資料產品說明文件

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要更新說明文件的資料產品。

3. 按一下「總覽」分頁標籤。

4. 按一下「Documentation」(文件) 旁的 「Edit」(編輯)。

5. 視需要更新使用手冊、查詢範例和其他說明文件。

6. 按一下 [儲存]。

REST

文件屬於 overview 方面。如要更新資料產品說明文件，請使用 entries.patch 方法。

刪除資料產品

如要刪除資料產品，請先從資料產品中移除所有資產。

控制台

1. 在 Google Cloud 控制台，前往 Dataplex Universal Catalog 的「資料產品」頁面。

   前往「資料產品」

2. 按一下要刪除的資料產品。

3. 按一下「資產」分頁標籤。

4. 針對列出的每項素材資源，依序點按 >「移除」。 按一下「移除」確認操作。

5. 移除所有資產後，按一下「刪除」，即可刪除資料產品。

6. 在確認對話方塊中輸入 delete，然後按一下「刪除」。

REST

如要刪除資料產品，請使用 dataProducts.delete 方法。

舉例來說，請傳送下列 DELETE 要求：

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

更改下列內容：

• PROJECT_ID：您 Google Cloud專案的 ID
• LOCATION：資料產品所在的區域
• DATA_PRODUCT_ID：要刪除的資料產品 ID

後續步驟

• 瞭解如何搜尋資料產品。
• 瞭解如何要求資料產品的存取權。