查看和订阅列表
作为 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
),具体取决于哪个范围最适合您的应用场景。
- 如需订阅列表,您还必须要求列表发布者为您授予列表、交换或项目的 Analytics Hub 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 控制台中,转到 BigQuery 页面。
在浏览器窗格中,点击
添加数据。在添加数据对话框中,点击 Analytics Hub。此时系统会显示 Analytics Hub 对话框,其中包含您可以访问的列表。 对于 Salesforce Data Cloud 列表,探索器窗格中有一个按钮,可自动过滤相关列表。
或者,要打开 Analytics Hub 对话框,您也可以前往 Analytics Hub,然后点击搜索列表。
如需按名称或说明过滤列表,请在搜索列表字段中输入列表的名称或说明。
在过滤条件部分,您可以根据以下字段过滤列表:
浏览过滤后的列表。
订阅列表
如果订阅列表,则系统会通过在项目中创建关联的数据集向您授予对列表数据的只读权限。
如需订阅列表,请按以下步骤操作:
控制台
如需查看您有权访问的列表,请按照查看列表中的步骤操作。
浏览列表,然后点击要订阅的列表。随即将出现一个包含该列表详细信息的对话框。
如果您无权订阅列表(例如引用商业数据集的列表),请点击申请访问权限。如果您点击了可以订阅的数据集,请点击将数据集添加到项目以打开创建关联的数据集对话框。
如果您的项目中未启用 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。
在请求正文中,指定要在其中创建关联数据集的数据集。如果成功,则响应正文为空。
查看关联的数据集
关联的数据集会与其他数据集一起显示在 Google Cloud 控制台中。
如需查看项目中关联的数据集,请按照以下步骤操作:
控制台
在 Google Cloud 控制台中,转到 BigQuery 页面。
在探索器面板中,点击包含 关联数据集的项目名称。
或者,您也可以使用 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 表相同的方式查询关联的数据集中的表和视图。
更新关联的数据集
关联的数据集中的资源处于只读状态。您无法修改关联数据集中资源的数据或元数据,也无法指定个别资源的权限。
您只能更新关联数据集的说明和标签。更改关联的数据集不会影响源数据集或共享数据集。
如需更新关联数据集的说明和标签,请按以下步骤操作:
在 Google Cloud 控制台中,转到 BigQuery 页面。
在浏览器面板中,点击您的项目的名称,然后点击关联的数据集。
展开
操作选项,然后点击打开。在详细信息面板中,点击
修改详细信息,然后指定以下详细信息:点击保存。
查看表元数据
如需查看底层表元数据,请查询 INFORMATION_SCHEMA.TABLES
视图:
SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`
将 LINKED-DATASET 替换为关联数据集的名称。
删除关联的数据集
如果 Analytics Hub 发布方移除了订阅,则关联的数据集会与共享数据集解除关联。您可以删除已解除关联的数据集,因为无法查询已解除关联的数据集。
删除关联的数据集不会删除源数据集。您无法检索已删除的关联数据集。但是,您可以通过再次订阅列表并将数据集添加到项目中来重新创建该数据集。
如需删除关联的数据集,请执行以下操作:
在 Google Cloud 控制台中,转到 BigQuery 页面。
在浏览器面板中,点击您的项目的名称,然后点击关联的数据集。
展开
操作选项,然后点击删除。在要删除关联的数据集吗?对话框中,输入 delete 以确认删除。
点击删除。
后续步骤
- 了解 Analytics Hub。
- 了解如何管理清单。
- 了解如何管理数据交换。
- 了解 Analytics Hub 审核日志记录。