管理訂閱項目

本文說明如何管理 BigQuery 共用訂閱項目，涵蓋訂閱者和發布者的工作。

BigQuery 共用訂閱者可以執行下列操作：

  • 訂閱房源資訊。
  • 列出指定 Google Cloud 專案中的目前訂閱項目。
  • 刪除訂閱項目。

身為 BigQuery 共用發布者，您可以執行下列操作：

  • 查看商家資訊的所有訂閱項目。
  • 撤銷特定訂閱項目的存取權。

BigQuery 共用訂閱項目是區域性資源，位於訂閱者的專案中。訂閱項目會儲存訂閱者的相關資訊，並代表發布商與訂閱者之間的合約。

事前準備

如要開始使用 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 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

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

訂閱者管理訂閱項目的工作流程

以下各節說明 BigQuery 共用訂閱者可透過訂閱項目執行的操作。

訂閱產品資訊

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

可列出訂閱項目

如要列出特定專案中的目前訂閱項目，請使用 projects.locations.subscriptions.list 方法：

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

更改下列內容：

  • PROJECT_ID：您要列出訂閱項目的 Google Cloud 專案 ID。
  • LOCATION：要列出訂閱項目的位置。

刪除訂閱項目

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

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

更改下列內容：

  • PROJECT_ID：要刪除的訂閱項目專案 ID。
  • LOCATION：要刪除的訂閱項目位置。 如要進一步瞭解支援分享功能的地區，請參閱「支援的區域」。
  • SUBSCRIPTION_ID：要刪除的訂閱項目 ID。

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

BigQuery 共用訂閱者刪除訂閱項目時，系統也會從訂閱者的專案中刪除連結的資料集。

從多區域房源資訊 (搶先版) 刪除訂閱項目時，所有主要和次要連結的資料集副本也會從訂閱者的專案中刪除。

如要進一步瞭解如何使用 API 透過訂閱項目執行工作，請參閱 projects.locations.subscriptions 方法。

發布商管理訂閱項目的工作流程

以下各節說明 BigQuery 共用發布者可對訂閱項目執行的操作。如要進一步瞭解如何管理房源訂閱項目，請參閱「管理房源」。

可列出訂閱項目

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

控制台

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

    前往「共用」(Analytics Hub)

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

  2. 按一下要列出訂閱項目的資料交易所名稱。

  3. 按一下「訂閱」分頁標籤，查看資料交易所內所有刊登的訂閱項目。

API

如要列出特定資料交換庫中清單的訂閱項目，請使用 projects.locations.dataExchanges.listSubscriptions 方法。

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

更改下列內容：

  • PROJECT_ID：要列出訂閱項目的資料交換專案 ID。
  • LOCATION：要列出訂閱項目的資料交易所位置。
  • DATAEXCHANGE_ID：要列出訂閱項目的資料交易所 ID。

撤銷訂閱

BigQuery 分享發布者撤銷訂閱項目後，訂閱者就無法再查詢連結的資料集。由於這項動作是由發布者在訂閱者擁有的資源上發起，因此連結的資料集仍會保留在訂閱者的專案中。訂閱者可以刪除資料集來移除。

如果發布者從多區域刊登資訊 (預覽版) 撤銷訂閱，訂閱者就無法再查詢任何主要或次要連結資料集副本。

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

控制台

  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/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

更改下列內容：

  • PROJECT_ID：要撤銷的訂閱項目專案 ID。
  • LOCATION：訂閱方案的適用地區。
  • SUBSCRIPTION_ID：要撤銷的訂閱項目 ID。

限制

訂閱方案有下列限制：

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

後續步驟