管理清单

控制台

前往 Google Cloud 项目的 Analytics Hub API 页面，然后启用该 API。

启用 Analytics Hub API

gcloud

运行 gcloud services enable 命令：

gcloud services enable analyticshub.googleapis.com

控制台

1. 转到 Analytics Hub 页面。

   转到 Analytics Hub

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

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

3. 点击 add_box 创建清单。

4. 在创建清单页面上的显示名称中，输入清单名称。

5. 如果您要创建商业清单，请在申请访问权限的联系方式字段中填写登记表的电子邮件地址或网址，以便订阅者与您联系。或者，您也可以按照以下步骤创建标准商品详情，然后按照说明将商品详情发布到 Cloud Marketplace，以创建集成了 Cloud Marketplace 的商品详情。

6. 可选：输入以下详细信息：

   • 主要联系人：输入用于清单的主要联系人的电子邮件地址或网址。

   • 类别：最多选择两个最符合您的清单的类别。订阅者可以根据这些类别过滤清单。

   • 提供商：展开提供商部分，并在以下字段中指定详细信息：

     • 提供商名称：数据集提供商的名称。
     • 提供商的主要联系人：数据集提供商的主要联系人的电子邮件地址或网址。

     订阅者可以根据数据提供商过滤清单。

   • 发布者：展开发布者部分，并在以下字段中指定详细信息：

     • 发布者名称：创建清单的发布者的名称。
     • 发布者主要联系人：数据集发布者主要联系人的电子邮件地址或网址。

   • 图标：产品详情的图标。 支持 PNG 和 JPEG 文件格式。图标的文件大小必须小于 512 KiB，尺寸不得超过 512 x 512 像素。

   • 说明：有关清单的简要说明。订阅者可以根据说明搜索清单。

7. 在源数据集中，选择要在数据交换中列出的数据集。源数据集必须与数据交换位于同一区域。创建清单后，无法更新此字段。

8. 在数据出站流量中，选择相应的数据出站流量选项。

   • 如需对共享数据集应用数据出站流量限制，但不对共享数据集的查询结果应用该限制，请选择禁止复制和导出共享数据。
   • 如需对共享数据集和共享数据集的查询结果应用数据出站流量限制，请选择禁止复制和导出查询结果，这将会同时自动设置禁止复制和导出共享数据。
   • 如需对共享数据集应用数据 API 复制和导出出站流量限制，请选择禁止通过 API 复制和导出表，这将会同时自动设置禁止复制和导出共享数据。

9. 可选：在商品详情部分，点击公开可检测性切换开关以启用公开可检测性。您必须向 allUsers 或 allAuthenticatedUsers 授予 Analytics Hub Viewer 角色 (roles/analyticshub.viewer)。如需了解详情，请参阅为清单授予角色。如果交换已公开，则已继承清单详情权限，无需采取任何进一步操作。

   公开可检测的交换因权限继承而不能包含非公开清单，但非公开交换可以包含公开清单。如需创建公开清单，数据清单所在的项目必须具有关联的组织和结算账号。如果您要创建与 Cloud Marketplace 集成的商家信息，我们建议您将其设为可供公开查找。

10. 可选：在商家信息详情部分，点击订阅方电子邮件记录切换开关 (Preview)，以记录对关联数据集执行作业和查询的用户的所有主要标识符。

11. 可选：在文档 > Markdown 部分中，您可以输入其他信息，例如您可以在数据集上运行的示例查询、任何相关链接文档以及其他任何有助于订阅者使用数据集的信息。

12. 点击保存。

API

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

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

替换以下内容：

• PROJECT_ID：包含要在其中创建清单的数据交换的项目 ID。
• LOCATION：数据交换的位置。如需详细了解有哪些位置支持分享功能，请参阅支持的区域。
• DATAEXCHANGE_ID：数据交换 ID。
• LISTING_ID：清单 ID。

在请求正文中，提供商品详情。如果请求成功，则响应正文包含商家信息的详细信息。如果您启用了订阅者电子邮件日志记录（预览版），则商品详情响应中会包含 log_linked_dataset_query_user_email: true。

如需详细了解您可以使用 API 针对清单执行的任务，请参阅 projects.locations.dataExchanges.listings 方法。

控制台

1. 转到 Analytics Hub 页面。

   转到 Analytics Hub

2. 点击包含清单的数据交换名称。

3. 点击您要为其添加订阅者的清单。

4. 点击 person 设置权限。

5. 如需添加主账号，请点击 person_add 添加主账号。

6. 在新建主账号字段中，根据清单类型添加以下详细信息：

   • 对于非公开清单，请输入要授予访问权限的身份的电子邮件。

   • 对于公开清单，请添加 allAuthenticatedUsers。

   • 对于可供所有人（包括非Google Cloud用户）检测到的公开清单，请添加 allUsers。

7. 对于选择角色，请将指针悬停在 Analytics Hub 上，然后根据清单类型选择以下角色之一：

   • 对于商业清单，请选择 Analytics Hub Viewer 角色。此角色允许用户查看清单和请求访问权限。

   • 对于不公开或非商业的公开清单，请选择 Analytics Hub Subscriber 角色。此角色允许用户订阅清单。

   如需了解详情，请参阅 Analytics Hub Subscriber 和 Viewer 角色。

8. 点击保存。

API

1. 使用 projects.locations.dataExchanges.listings.getIamPolicy 方法通过清单 getIamPolicy 方法读取现有政策。

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

   替换以下内容：

   • PROJECT_ID：项目 ID，例如 my-project-1。
   • LOCATION：包含清单的数据交换的位置。
   • DATAEXCHANGE_ID：数据交换 ID。
   • LISTING_ID：清单 ID。

   共享会在响应中返回当前政策。

2. 如需添加或移除成员及其关联的角色，请使用文本编辑器修改该政策。请按以下格式添加成员：

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   例如，如需向 group:subscribers@example.com 授予 roles/analyticshub.subscriber 角色，请将以下绑定添加到政策中：

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. 使用 projects.locations.dataExchanges.listings.setIamPolicy 方法写入更新后的政策。在请求正文中，提供上一步中写入的更新后 IAM 政策。

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

   在请求正文中，提供清单详细信息。如果请求成功，则响应正文包含清单的详细信息。

如需详细了解您可以使用 API 针对清单执行的任务，请参阅 projects.locations.dataExchanges.listings 方法。

控制台

1. 转到 Analytics Hub 页面。

   转到 Analytics Hub

2. 点击要管理其订阅的清单所在的数据交换名称。

3. 点击要列出其所有订阅者的清单。

4. 如需查看清单的所有订阅者，请点击管理订阅。

   

5. 可选：您可以按订阅者详细信息过滤结果。

或者，如果您有权访问共享的数据集，则可以按照以下步骤列出订阅者：

1. 转到 BigQuery 页面。

   转到 BigQuery

2. 在浏览器窗格中，展开您的项目并选择共享数据集。

3. 在 person_add 共享列表中，选择管理订阅。

SQL

以下示例使用 INFORMATION_SCHEMA.SCHEMATA_LINKS 视图列出 myproject 中位于 us 区域的共享数据集的所有关联数据集：

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

输出类似于以下内容：为简化输出，省略了某些列。

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

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

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

替换以下内容：

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

控制台

1. 如需列出清单的所有订阅者，请按照查看所有订阅中的 Google Cloud 控制台说明执行操作。

2. 点击订阅标签页。

3. 如需从清单中移除订阅者，请选择要移除的订阅，然后点击 delete 移除订阅。

4. 在“移除订阅？”对话框中，输入 remove 以确认。

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。

控制台

1. 转到 Analytics Hub 页面。

   转到 Analytics Hub

2. 点击包含清单的数据交换名称。

3. 点击要更新的清单。

4. 点击 mode_edit 修改清单。

5. 修改字段中的值。您可以修改除清单的来源数据集之外的所有值。

6. 可选：

   • 如果您启用了公开可检测性，请向 allUsers 或 allAuthenticatedUsers 授予 Analytics Hub Viewer 角色 (roles/analyticshub.viewer)。如需了解详情，请参阅为清单授予角色
   • 如果您停用公开可检测性，请从 allUsers 和 allAuthenticatedUsers 中移除 Analytics Hub Viewer 角色。公开交换不能包含非公开清单，但非公开交换可以包含公开清单。
   • 电子邮件日志记录功能一旦启用并保存，便将无法修改。 如需停用电子邮件日志记录，请删除并重新创建列表，而不点击订阅方电子邮件日志记录切换开关（预览）。

7. 要预览更改，请点击预览。

8. 要保存更改，请点击保存。

API

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

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

将 UPDATEMASK 替换为您要更新的字段列表。如需更新多个值，请使用英文逗号分隔列表。在请求正文中，指定更新后的值。

在请求正文中，为以下字段指定更新后的值：

• 显示名称
• 说明
• 类别
• 文档
• 图标
• 主要联系人
• 公开可检测性
• 订阅方电子邮件日志记录（预览版）

如需详细了解这些字段，请参阅资源：商品详情。

如需详细了解您可以使用 API 针对清单执行的任务，请参阅 projects.locations.dataExchanges.listings 方法。

控制台

1. 转到 Analytics Hub 页面。

   转到 Analytics Hub

2. 点击包含清单的数据交换名称。

3. 点击要删除的清单。

4. 点击 delete 删除。

5. 在“是否要删除清单？”对话框中，输入 delete 以确认删除。

6. 点击删除。

API

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

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

如需详细了解您可以使用 API 针对清单执行的任务，请参阅 projects.locations.dataExchanges.listings 方法。