[Ultimate]{class="badge positive"}

在用户界面中创建Google PubSub源连接

IMPORTANT
Google PubSub源在源目录中可供已购买Real-time Customer Data Platform Ultimate的用户使用。

本教程提供了使用Platform用户界面创建Google PubSub(以下称为“PubSub”)的步骤。

快速入门

本教程需要对以下Adobe Experience Platform组件有一定的了解:

  • :Experience Platform允许从各种源摄取数据,同时允许您使用Platform服务来构建、标记和增强传入数据。
  • 沙盒:Experience Platform提供了将单个Platform实例划分为多个单独的虚拟环境的虚拟沙盒,以帮助开发和改进数字体验应用程序。

如果您已经拥有有效的PubSub连接,则可以跳过本文档的其余部分,并转到有关配置数据流的教程。

收集所需的凭据

您必须提供下面列出的连接属性的值,才能将您的PubSub帐户连接到Experience Platform。 有关身份验证和先决条件设置的详细信息,请阅读PubSub source 概述

基于项目的身份验证
table 0-row-2 1-row-2 2-row-2
凭据 描述
项目编号 验证PubSub时需要项目ID。
凭据 验证PubSub所需的凭据。 您必须确保从凭据中删除空格后放入完整的JSON文件。
基于主题和订阅的身份验证
table 0-row-2 1-row-2 2-row-2 3-row-2
凭据 描述
凭据 验证PubSub所需的凭据。 您必须确保从凭据中删除空格后放入完整的JSON文件。
主题名称 PubSub订阅的名称。 在PubSub中,订阅允许您通过订阅消息已发布到的主题来接收消息。 注意:单个PubSub订阅只能用于一个数据流。 要创建多个数据流,您必须有多个订阅。
订阅名称 PubSub订阅的名称。 在PubSub中,订阅允许您通过订阅消息已发布到的主题来接收消息。

有关这些值的详细信息,请参阅以下PubSub身份验证文档。 如果您使用基于服务帐户的身份验证,请参阅以下PubSub指南以了解如何生成凭据的步骤。

TIP
如果您使用的是基于服务帐户的身份验证,请确保在复制和粘贴凭据时,您已经向服务帐户授予了足够的用户访问权限,并且JSON中没有额外的空格。

收集所需的凭据后,您可以按照以下步骤将您的PubSub帐户关联到Platform。

连接您的PubSub帐户

在Platform UI中,从左侧导航中选择​ ​以访问源工作区。 目录屏幕显示您可以用来创建帐户的各种来源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项查找您要使用的特定源。

在Cloud Storage类别下,选择​ Google PubSub,然后选择​ 添加数据

Experience PlatformUI上的源目录。

此时会显示​ 连接到Google PubSub ​页。 在此页上,您可以使用新凭据或现有凭据。

现有账户

要使用现有帐户,请选择要用于创建新数据流的PubSub帐户,然后选择​ 下一步 ​以继续。

源工作流中的现有帐户选择。

新帐户

TIP
  • 在创建具有受限访问权限的帐户时,您必须至少提供一个主题名称或订阅名称。 如果缺少这两个值,身份验证将失败。
  • 创建后,无法更改Google PubSub基本连接的身份验证类型。 要更改身份验证类型,必须创建新的基本连接。

如果要创建新帐户,请选择​ 新帐户,然后为您的新PubSub帐户提供名称和可选描述。

源工作流中Google PubSub源的新帐户接口

PubSub源允许您指定身份验证期间允许的访问类型。 您可以将帐户设置为使用基于项目的身份验证或基于主题和基于订阅的身份验证。 基于项目的身份验证允许您授予对帐户中根级别项目的访问权限,而基于主题和订阅的身份验证允许您限制对特定PubSub主题和订阅的访问权限。

基于项目的身份验证

创建有权访问您的根PubSub项目文件夹的帐户。 选择​ Google PubSub身份验证凭据 ​作为您的身份验证类型,并提供项目ID和凭据。 完成后,选择​ 连接到源,然后留出一些时间来建立新连接。

已选择根访问权限的Google PubSub源的新帐户接口。

基于主题和订阅的身份验证

若要创建仅对特定PubSub主题和订阅具有受限访问权限的帐户,请选择​ Google PubSub作用域身份验证凭据,然后提供您的凭据、主题名和/或订阅名。 完成后,选择​ 连接到源,然后留出一些时间来建立新连接。

已选择范围访问权限的Google PubSub源的新帐户接口。

NOTE
分配给PubSub项目的主体(角色)在PubSub项目内创建的所有主题和订阅中被继承。 如果希望主体(角色)可以访问特定主题,则还必须将该主体(角色)添加到主题的相应订阅中。 有关详细信息,请阅读有关访问控制[🔗] (https://cloud.google.com/pubsub/docs/access-control)的PubSub 文档。

选择数据

成功的身份验证将您带入选择数据步骤,您可以在此步骤中导航PubSub数据层次结构并选择您要带入Experience Platform的数据。

基于项目的身份验证

如果您已通过基于项目的访问验证,则Select data界面将显示您的项目中具有附加主题的所有订阅。

具有基于项目的身份验证的源工作流的选择数据步骤。

基于主题和订阅的身份验证

如果您已通过主题和基于订阅的访问权限的身份验证,则根据您提供的信息,选择数据界面显示可能会有所不同。

  • 如果只提供主题名称,则界面将显示与所提供主题对应的所有主题订阅对。
  • 如果仅提供订阅名称,则界面将显示与提供的订阅名称对应的所有主题订阅对。
  • 如果同时提供了主题和预订名称,则界面将显示与两个提供的值对应的主题 — 预订对。

具有主题和基于订阅的身份验证的源工作流的选择数据步骤。

后续步骤

通过完成本教程,您已在PubSub帐户和平台之间创建了连接。 您现在可以继续下一教程,并配置数据流以将云存储中的流数据引入Platform

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089