管理訂閱項目

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

事前準備

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

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

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

以下是具有啟用 Analytics Hub API 所需權限的預先定義 IAM 角色：

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

控制台

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

啟用 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：要列出訂閱項目的位置。如要進一步瞭解支援分享功能的地區，請參閱「支援的區域」。

刪除訂閱項目

如要刪除訂閱項目，請呼叫 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)

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

  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)

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

  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。

後續步驟