管理清单

控制台

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

启用 Analytics Hub API

gcloud

运行 gcloud services enable 命令：

gcloud services enable analyticshub.googleapis.com

控制台

1. 前往 Sharing (Analytics Hub) 页面。

   前往 Sharing (Analytics Hub)

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

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

3. 点击 add_box 创建清单。

4. 在配置数据部分的资源类型菜单中，选择 BigQuery 数据集或 Pub/Sub 主题。

   • 如果您选择 BigQuery 数据集，请执行以下操作：

     1. 在共享数据集菜单中，选择现有数据集，或点击创建数据集以创建新数据集。选择要在数据交换中列出的数据集。该数据集必须与数据交换位于同一区域。创建清单后，无法更新此字段。当订阅方查看关联数据集的元数据时，系统会返回源数据集名称和包含该数据集的项目的 ID。

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

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

   • 如果您选择 Pub/Sub 主题，则可以在共享主题菜单中选择现有的 Pub/Sub 主题，也可以点击创建主题以创建新主题。

5. 在清单详细信息部分的显示名称中，输入清单的名称。

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

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

   • 数据亲和性：发布方用于发布数据的区域。订阅方可以通过从同一区域读取数据，最大限度地降低或避免 Pub/Sub 网络出站费用，此信息对订阅方非常有用。如需详细了解出站费用，请参阅数据传输费用。

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

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

   • 公开可检测性：在 BigQuery Sharing 目录中启用清单的公开可检测性。如果您启用了此选项，请向 allUsers 或 allAuthenticatedUsers 授予 Analytics Hub Viewer 角色 (roles/analyticshub.viewer)。如需了解详情，请参阅为清单授予角色。如果交换已公开，则已继承清单详情权限，无需采取任何进一步操作。

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

   • 文档 > Markdown：其他信息，例如任何相关文档的链接以及任何有助于订阅方使用您的主题的其他信息。

7. 在清单联系信息部分中，输入以下可选详细信息：

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

   • 申请访问权限联系人：输入登记表的电子邮件 ID 或网址，以便订阅方与您联系。

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

     • 提供方名称：主题提供方的名称。
     • 提供方的主要联系人：主题提供方的主要联系人的电子邮件 ID 或网址。

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

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

     • 发布者名称：创建清单的发布者的名称。
     • 发布方主要联系人：主题发布方主要联系人的电子邮件 ID 或网址。

8. 查看清单预览部分。

9. 点击发布。

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：数据交换的位置。如需详细了解有哪些位置支持 Sharing，请参阅支持的区域。
• DATAEXCHANGE_ID：数据交换 ID。
• LISTING_ID：清单 ID。

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

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

控制台

1. 前往 Sharing (Analytics Hub) 页面。

   前往 Sharing (Analytics Hub)

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

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

4. 点击 person 设置权限。

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

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

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

   • 对于公开清单，请添加 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。

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

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. 前往 Sharing (Analytics Hub) 页面。

   前往 Sharing (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. 前往 Sharing (Analytics Hub) 页面。

   前往 Sharing (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. 前往 Sharing (Analytics Hub) 页面。

   前往 Sharing (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 方法。