管理訂閱項目

您可以在 BigQuery sharing (舊稱 Analytics Hub) 管理訂閱項目，控管資料存取和共用權限。訂閱者可以訂閱、查看及刪除清單。發布者可以監控誰有權存取自己的產品資訊，並視需要撤銷訂閱。BigQuery sharing 訂閱項目是區域性資源，位於訂閱者的專案中。訂閱項目會儲存訂閱者的資訊，並代表發布者與訂閱者之間的合約。

事前準備

如要開始使用 BigQuery sharing (舊稱 Analytics Hub)，請在 Google Cloud 專案中啟用 Analytics Hub API。

如要啟用 Analytics Hub API，您必須具備下列 Identity and Access Management (IAM) 權限：

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

下列預先定義的 IAM 角色包含啟用 Analytics Hub API 所需的權限：

如要啟用 Analytics Hub API，請選取下列其中一個選項：

控制台

前往「Analytics Hub API」頁面，為 Google Cloud 專案啟用 Analytics Hub API。

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

必要的角色

如要取得管理訂閱項目所需的權限，請要求管理員授予您專案的 Analytics Hub 訂閱項目擁有者 (roles/analyticshub.subscriptionOwner) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

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

限制

訂閱項目有下列限制：

  • 您只能使用 Analytics Hub API 管理 2023 年 7 月 25 日之後建立的訂閱項目。在此日期之前建立的連結資料集不支援，因為缺少必要的訂閱資源。

以訂閱者身分管理訂閱項目

以下各節說明 BigQuery 共用訂閱者如何管理訂閱項目。

訂閱產品資訊

如要訂閱清單項目，請按照「查看及訂閱清單項目和資料交換庫」中的步驟操作。

可列出訂閱項目

如要列出專案中的訂閱項目，請呼叫 projects.locations.subscriptions.list 方法：

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions

更改下列內容：

  • PROJECT_ID： Google Cloud 專案 ID，用於存放您要列出的訂閱項目。
  • LOCATION：要列出的訂閱項目位置。如要進一步瞭解支援共用的位置，請參閱「支援的區域」。

重新整理訂閱

當發布商或資料提供者新增或移除資料時，資料交換或資料無塵室可能會過時。發生這種情況時，現有的連結資料集不會自動更新，您必須重新整理訂閱項目，才能存取新資源。

如要重新整理訂閱項目，請選取下列其中一個選項：

控制台

  1. 前往 Google Cloud 控制台的「BigQuery」頁面。

    前往「BigQuery」

  2. 在「Explorer」窗格中，點選「 新增資料」。

  3. 選取「Sharing (Analytics Hub)」。探索頁面隨即開啟。

  4. 找出並點選您訂閱的資料無塵室或資料交換。

  5. 點選「訂閱」。由於您已有使用中的訂閱項目，控制台會顯示「Refresh」(重新整理) 選項。

  6. 按一下「重新整理」，即可使用最新資源更新連結的資料集。

API

如要重新整理訂閱項目，請使用 projects.locations.subscriptions.refresh 方法：

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:refresh

更改下列內容：

  • PROJECT_ID：要重新整理的訂閱項目專案 ID。
  • LOCATION：要重新整理的訂閱項目位置。
  • SUBSCRIPTION_ID：要重新整理的訂閱項目 ID。

要求主體必須為空白。如果成功，回應主體會包含作業執行個體。

刪除訂閱項目

如要刪除訂閱項目，請呼叫 projects.locations.subscriptions.delete 方法：

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID

更改下列內容：

  • PROJECT_ID： Google Cloud 專案 ID，用於存放您要刪除的訂閱項目。
  • LOCATION：要刪除的訂閱項目位置。
  • SUBSCRIPTION_ID：要刪除的訂閱項目 ID。

要求主體必須為空白。如果成功，回應主體會包含作業執行個體。

刪除訂閱項目時，連結的資料集也會從專案中刪除。

從多區域產品資訊中刪除訂閱項目時，所有主要和次要連結資料集副本也會從專案中刪除。

如要進一步瞭解如何使用 Analytics Hub API 管理訂閱項目，請參閱 projects.locations.subscriptions 方法。

以發布商身分管理訂閱項目

以下各節說明 BigQuery sharing 發布端如何管理訂閱項目。如要進一步瞭解如何管理產品資訊訂閱項目，請參閱「管理產品資訊」。

可列出訂閱項目

如要列出所有訂閱項目，請選取下列其中一個選項：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」(共用 (Analytics Hub)) 頁面。

    前往「共用 (Analytics Hub)」

    頁面會列出您可存取的所有資料交換。

  2. 在資料交換清單中，按一下資料交換名稱，其中包含要列出的訂閱項目。

  3. 按一下「Subscriptions」(訂閱項目) 分頁標籤。

API

如要列出特定資料交換中產品資訊的訂閱項目，請呼叫 projects.locations.dataExchanges.listSubscriptions 方法：

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

更改下列內容：

  • PROJECT_ID：資料交換所在專案的 Google Cloud 專案 ID。
  • LOCATION：資料交換的位置，其中包含要列出的訂閱項目。
  • DATAEXCHANGE_ID：要列出訂閱項目的資料交換 ID。

撤銷訂閱項目

如果您以 BigQuery sharing 發布端的身分撤銷訂閱，訂閱端就無法再查詢連結的資料集。由於您是在訂閱者擁有的資源上啟動這項動作，因此連結的資料集會保留在訂閱者的專案中。訂閱者可以刪除資料集。

撤銷多區域產品資訊的訂閱項目後，訂閱者就無法再查詢任何主要或次要連結資料集副本。

如要撤銷訂閱，請選取下列其中一個選項：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」(共用 (Analytics Hub)) 頁面。

    前往「共用 (Analytics Hub)」

    頁面會列出您可存取的所有資料交換。

  2. 在資料交換清單中，按一下資料交換名稱，找出要撤銷的訂閱項目。

  3. 按一下「Subscriptions」(訂閱項目) 分頁標籤。

  4. 找出要撤銷的訂閱項目，逐一勾選旁邊的核取方塊。

  5. 按一下「撤銷訂閱項目」。

API

如要撤銷訂閱項目，請呼叫 projects.locations.subscriptions.revoke 方法：

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

更改下列內容：

  • PROJECT_ID： Google Cloud 專案 ID，用於存放您要撤銷的訂閱項目。
  • LOCATION：要撤銷的訂閱項目位置。
  • SUBSCRIPTION_ID：要撤銷的訂閱項目 ID。

後續步驟