查看和订阅列表

作为 Analytics Hub Subscriber，您可以查看和订阅您有权访问的列表。如果订阅列表，系统会在您的项目中创建一个关联的数据集。

所需的角色

如需获得使用列表所需的权限，请让您的管理员为您授予以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

这些预定义角色包含执行本文档中的任务所需的权限。如需查看创建和查询数据集所需的确切权限，请展开所需权限部分：

所需权限

  • 创建新数据集：bigquery.datasets.create 或 bigquery.datasets.*，用于对数据集执行其他操作。
  • 查询数据集：bigquery.jobs.create 或 bigquery.jobs.*，用于对作业执行其他操作。

您也可以使用自定义角色或其他预定义角色来获取这些权限。

查看列表

如需查看公开和非公开列表，请按以下步骤操作：

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

    转到 BigQuery

  2. 在浏览器窗格中，点击 添加数据。

  3. 在添加数据对话框中，点击 Analytics Hub。此时系统会显示 Analytics Hub 对话框，其中包含您可以访问的列表。

    或者，要打开 Analytics Hub 对话框，您也可以前往 Analytics Hub，然后点击搜索列表。

  4. 如需按名称或说明过滤列表，请在搜索列表字段中输入列表的名称或说明。

  5. 在过滤条件部分，您可以根据以下字段过滤列表：

    • 列表：选择要查看组织内的非公开列表、公开列表还是列表。

    • 类别：选择所需的类别。

    • 位置：选择所需的位置。如需了解详情，请参阅支持的区域。

    • 提供方：选择数据提供方。某些数据提供方要求您申请访问其商业数据集。申请访问权限后，该数据提供方会与您联系以共享其数据集。

  6. 浏览过滤后的列表。

订阅列表

如果订阅列表，则系统会通过在项目中创建关联的数据集向您授予对列表数据的只读权限。

如需订阅列表，请按以下步骤操作：

控制台

  1. 如需查看您有权访问的列表，请按照查看列表中的步骤操作。

  2. 浏览列表，然后点击要订阅的列表。随即将出现一个包含该列表详细信息的对话框。

  3. 如果您无权订阅列表（例如引用商业数据集的列表），请点击申请访问权限。如果您点击了可以订阅的数据集，请点击将数据集添加到项目以打开创建关联的数据集对话框。

  4. 如果您的项目中未启用 Analytics Hub API，则系统会显示一条错误消息，其中包含启用该 API 的链接。点击启用 Analytics Hub API。

  5. 在创建关联的数据集对话框中，指定以下详细信息：

    • 项目：指定要在其中添加数据集的项目的名称。
    • 关联的数据集名称：指定关联的数据集的名称。

  6. 要保存更改，请点击保存。 关联的数据集将在您的项目中列出。

API

使用 projects.locations.dataExchanges.listings.subscribe 方法。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

替换以下内容：

  • PROJECT_ID：您要订阅的列表的项目 ID。
  • LOCATION：您要订阅的列表所在的位置。
  • DATAEXCHANGE_ID：您要订阅的列表的数据交换 ID。
  • LISTING_ID：您要订阅的列表的 ID。

在请求正文中，指定要在其中创建关联数据集的数据集。如果成功，则响应正文为空。

查看关联的数据集

关联的数据集会与其他数据集一起显示在 Google Cloud 控制台中。

如需查看项目中关联的数据集，请按照以下步骤操作：

控制台

  1. 在 Google Cloud 控制台中，进入 BigQuery 页面。

    转到 BigQuery

  2. 在探索器面板中，点击包含 关联数据集的项目名称。

或者，您也可以使用 Data Catalog 搜索和查看关联的数据集。如需匹配所有 Analytics Hub 关联数据集，请使用 type=dataset.linked 谓词。如需了解详情，请参阅 Data Catalog 搜索语法。

Cloud Shell

运行以下命令：

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

查询关联的数据集

您可以按照与查询任何其他 BigQuery 表相同的方式查询关联的数据集中的表和视图。

更新关联的数据集

关联的数据集中的资源处于只读状态。您无法修改关联数据集中资源的数据或元数据，也无法指定个别资源的权限。

您只能更新关联数据集的说明和标签。更改关联的数据集不会影响源数据集或共享数据集。

如需更新关联数据集的说明和标签，请按以下步骤操作：

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

    转到 BigQuery

  2. 在浏览器面板中，点击您的项目的名称，然后点击关联的数据集。

  3. 展开 操作选项，然后点击打开。

  4. 在详细信息面板中，点击 修改详细信息，然后指定以下详细信息：

    1. 如需添加标签，请参阅为数据集添加标签。

    2. 如需启用排序规则，请展开高级选项部分，然后按照以下步骤操作：

      1. 选择启用默认排序规则。
      2. 从默认排序规则列表中选择一个选项。

  5. 点击保存。

查看表元数据

如需查看底层表元数据，请查询 INFORMATION_SCHEMA.TABLES 视图：

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

将 LINKED-DATASET 替换为关联数据集的名称。

删除关联的数据集

如果 Analytics Hub 发布方移除了订阅，则关联的数据集会与共享数据集解除关联。您可以删除已解除关联的数据集，因为无法查询已解除关联的数据集。

删除关联的数据集不会删除源数据集。您无法检索已删除的关联数据集。但是，您可以通过再次订阅列表并将数据集添加到项目中来重新创建该数据集。

如需删除关联的数据集，请执行以下操作：

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

    转到 BigQuery

  2. 在浏览器面板中，点击您的项目的名称，然后点击关联的数据集。

  3. 展开 操作选项，然后点击删除。

  4. 在要删除关联的数据集吗？对话框中，输入 delete 以确认删除。

  5. 点击删除。

后续步骤