查看和订阅列表 | BigQuery

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

所需的角色

如需获得使用列表所需的权限，请让您的管理员向您授予订阅者项目的以下 Identity and Access Management (IAM) 角色：

发现列表：Analytics Hub Viewer (roles/analyticshub.viewer)
订阅列表：BigQuery User (roles/bigquery.user)
- 如需订阅列表，您还必须要求列表发布者为您授予列表、交换或项目的 Analytics Hub Subscriber 角色 (roles/analyticshub.subscriber)，具体取决于哪个范围最适合您的应用场景。
查看关联的数据集：BigQuery Data Viewer (roles/bigquery.dataViewer)
查询关联的数据集：BigQuery Data Viewer (roles/bigquery.dataViewer)
更新关联的数据集：BigQuery Data Owner (roles/bigquery.dataOwner)
查看表元数据：BigQuery Data Viewer (roles/bigquery.dataViewer)
删除关联的数据集：BigQuery Admin (roles/bigquery.admin)

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

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

所需权限

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

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

发现列表

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

在 Google Cloud 控制台中，前往 Sharing (Analytics Hub) 页面。

前往“Sharing (Analytics Hub)”
点击搜索列表。系统随即会显示一个对话框，其中包含您可以访问的列表。
如需按名称或说明过滤列表，请在搜索列表字段中输入列表的名称或说明。
在过滤条件部分，您可以根据以下字段过滤列表：
- 清单：选择要查看组织中的非公开清单、公开清单还是清单。
- 类别：选择一个或多个类别。
- 位置：选择一个位置。如需了解详情，请参阅支持的区域。
- 提供方：选择数据提供方。某些数据提供方要求您申请访问其商业数据集。申请访问权限后，该数据提供方会与您联系以共享其数据集。
浏览过滤后的列表。

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

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

控制台

如需查看您有权访问的清单列表，请按照发现清单中的步骤操作。
浏览列表，然后点击要订阅的列表。随即将出现一个包含该列表详细信息的对话框。在此对话框中，您还可以查看提供方是否已启用订阅方邮件日志记录。
如果您无权订阅清单（例如引用商业数据集的清单），请点击申请访问权限或通过 Marketplace 购买。如果您点击可以订阅的数据集，请点击订阅以打开创建关联的数据集对话框。
如果您的项目中未启用 Analytics Hub API，则系统会显示一条错误消息，其中包含启用该 API 的链接。点击启用 Analytics Hub API。
在创建关联的数据集对话框中，指定以下详细信息：
- 项目：指定要在其中添加数据集的项目的名称。
- 关联的数据集名称：指定关联的数据集的名称。
要保存更改，请点击保存。关联的数据集将在您的项目中列出。

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。

在请求正文中，指定要在其中创建关联数据集的数据集。如果请求成功，响应正文将包含订阅对象。如果您已为数据交换或列表启用订阅方邮件日志记录功能（预览版），订阅响应中会包含 log_linked_dataset_query_user_email: true。

查看关联的数据集

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

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

控制台

在 Google Cloud 控制台中，前往 BigQuery 页面。

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

或者，您也可以使用 Data Catalog（已弃用）或 Dataplex Universal Catalog 搜索和查看关联的数据集。如需匹配所有通过共享功能关联的数据集，请使用 type=dataset.linked 谓词。如需了解详情，请参阅 Data Catalog 搜索语法或 Dataplex Universal 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 表相同的方式查询关联的数据集中的表和视图。

更新关联的数据集

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

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

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

在 Google Cloud 控制台中，前往 BigQuery 页面。

转到 BigQuery
在浏览器面板中，点击您的项目的名称，然后点击关联的数据集。
展开操作选项，然后点击打开。
在详细信息面板中，点击 修改详细信息，然后指定以下详细信息：
1. 如需添加标签，请参阅为数据集添加标签。
2. 如需启用排序规则，请展开高级选项部分，然后按照以下步骤操作：
  1. 选择启用默认排序规则。
  2. 从默认排序规则列表中，选择一个选项。
点击保存。

查看表元数据

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

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

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

退订或删除关联的数据集

如需退订数据集，您必须删除其关联的数据集。

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

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

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

在 Google Cloud 控制台中，前往 BigQuery 页面。

转到 BigQuery
在浏览器面板中，点击您的项目的名称，然后点击关联的数据集。
展开操作选项，然后点击删除。
在要删除关联的数据集吗？对话框中，输入 delete 以确认删除。
点击删除。

后续步骤

了解 Sharing。
了解如何管理清单。
了解如何管理数据交换。
了解 Sharing 审核日志记录。