管理订阅

作为 Analytics Hub 订阅者，您可以执行以下任务：

  • 订阅清单。
  • 列出给定项目中的当前订阅。
  • 删除订阅。

作为 Analytics Hub 发布者，您可以执行以下任务：

  • 查看清单的所有订阅。
  • 撤销对特定订阅的访问权限。

订阅是位于订阅者项目中的区域化资源。订阅存储有关订阅者的信息，并代表发布者和订阅者之间的合约。

须知事项

要开始使用 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 所需的权限：

  • roles/serviceusage.serviceUsageAdmin

如需详细了解 BigQuery 中的 IAM 角色，请参阅预定义的角色和权限。

启用 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 角色之一：

  • Analytics Hub Subscription Owner 角色 (roles/analyticshub.subscriptionOwner)，该角色允许您管理您创建的订阅。

如需了解详情，请参阅 Analytics Hub 用户角色。

订阅者工作流

订阅者可以对订阅执行以下操作。

订阅清单

如需订阅清单，请按照订阅清单中的步骤操作。

列出订阅

如需列出所有订阅，请按照以下步骤操作。

API

如需查看给定项目中的当前订阅，请使用 projects.locations.subscriptions.list 方法。

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

请替换以下内容：

  • PROJECT_ID：包含您要列出的订阅的项目 ID。

  • LOCATION：您要列出现有订阅的位置。

发布者工作流

发布者可以对订阅执行以下操作。如需详细了解如何管理清单的订阅，请参阅管理清单。

列出订阅

如需列出所有订阅，请按照以下步骤操作。

  1. 在 Google Cloud 控制台中，转到 Analytics Hub 页面。

    转到 Analytics Hub

    此时会显示一个页面，其中列出了您可以访问的所有数据交换。

  2. 点击要列出订阅的数据交换名称。

  3. 点击订阅标签页，以查看数据交换中清单的所有订阅。

移除订阅

控制台

  1. 在 Google Cloud 控制台中，转到 Analytics Hub 页面。

    转到 Analytics Hub

    此时会显示一个页面，其中列出了您可以访问的所有数据交换。

  2. 点击要在其中创建清单的数据交换名称。

  3. 点击订阅标签页，以查看数据交换的所有订阅。

  4. 选中要移除的订阅旁边的复选框，或选择所有订阅。

  5. 点击移除订阅。

API

如需删除订阅，请使用 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。

限制

订阅受限于以下限制：

  • 2023 年 7 月 25 日之前创建的关联数据集不会回填。只有在 2023 年 7 月 25 日之后创建的订阅才适用 API 方法。

后续步骤