[Ultimate]{class="badge positive"}

Google PubSub 源

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

Adobe Experience Platform为云提供商提供本机连接,例如 AWS, Google Cloud Platform、和 Azure,允许您将这些系统中的数据引入Platform以用于下游服务和目标。

云存储源可以将您的数据导入Platform,而无需下载、格式化或上传。 引入的数据可以格式化为XDM JSON、XDM Parquet或分隔。 该过程的每个步骤都集成到源工作流中。 Platform允许您从以下位置引入数据 Google PubSub 实时。

先决条件 prerequisites

此部分概述连接之前必须完成的必备设置 Google PubSub 帐户到Experience Platform。

创建服务帐户 create-service-account

A 服务帐户 是一种通常由应用程序或计算工作负载使用,而不是由人员使用的帐户类型。 服务帐户由其电子邮件地址标识,该地址是该帐户独有的。

  • 一方面,服务帐户是 主体 — 您可以向授予服务帐户访问权限 Google Cloud 资源。 例如,您可以授予服务帐户计算管理员角色 (roles/compute.admin) 在给定项目上。 然后,该服务帐户将能够管理该特定项目中的计算引擎资源。
  • 另一方面,服务帐户也是资源 — 您可以向其他承担者授予访问服务帐户的权限。 例如,您可以授予用户服务帐户用户角色 (roles/iam.serviceAccountUser) 服务帐户,以允许用户将该服务帐户附加到资源。 或者,您也可以授予用户服务帐户管理员角色 (roles/iam.serviceAccountAdmin) 让用户完成查看、编辑、禁用和删除服务帐户等任务。

有关为您的用例确定正确的身份验证类型的更多信息,请参阅 Google 身份验证方法指南.

按照下面列出的步骤创建服务帐户:

首先,导航到 IAM 第页,共 Google Developer Console 然后选择 Create Service Account.

Google开发人员控制台中的创建服务帐户窗口

接下来,输入服务帐户的显示名称和ID,然后选择 Create and Continue.

Google开发人员控制台中的服务帐户详细信息

生成服务帐户密钥 generate-service-account-keys

要为服务帐户生成密钥,请在服务帐户页中选择密钥标头。 从那里,选择 Add key 然后选择 Create new key 下拉菜单中。 您还可以使用此面板上传现有密钥。

Google开发人员控制台中的add key窗口

成功后,您将收到一条消息,指示私钥已保存到您的计算机,并将下载文件。 然后,在创建时,您可以将此文件的内容用作凭据 Google PubSub Experience Platform帐户。

在主题和订阅级别授予权限 grant-permissions

要在主题和订阅级别授予权限,请导航到主题控制台页面,然后选择 Show info panel. 接下来,在 Permissions 选项卡,选择 Add Principal 然后添加服务帐户主体以及权限。

Google Developer Console中的弹出窗口,您可以在其中授予主题和订阅级别的权限

配置以优化 Google PubSub usage optimal-configurations

本节概述建议您进行的配置,以优化您对 Google PubSub 源Experience Platform。

订阅属性 subscription-properties

使用 Google Developer Console 到 增加确认截止日期. 这允许 Google Publisher 以根据您配置的时间等待,然后再发送消息。 这种延迟有助于在订阅者级别减少不必要的负载。

Google开发人员控制台中的确认截止日期界面。

启用 exactly one delivery. 此配置会通知 Google Publisher 以确保发送到订阅的消息不会在确认截止日期之前重新发送。 您可以使用此设置来确保确认消息不会被重新发送到订阅。

Google开发人员控制台中的唯一一个投放配置页面。

您可以启用 Retry after exponential backoff delay 降低进一步淹没服务器的风险。 您可以在 Google Developer Console 为了更好地缓解暂时性故障(通常可自行解决的暂时性错误),请在尝试其他连接之前为系统提供更多的恢复时间。

Google开发人员控制台中的重试策略窗口。

您必须 将订阅消息保留持续时间设置为24小时或更长 以确保未确认的数据不会在峰值负载期间丢失。 此外, 启用死信主题 以确保即使在极少数极端情况下也不会发生数据丢失。

IMPORTANT
您只能为每个创建一个源数据流 Google PubSub 订阅。 重用订阅(甚至跨沙盒)会导致数据丢失。

连接 Google PubSub 至Experience Platform

以下文档提供了有关如何连接的信息 Google PubSub 使用API或用户界面连接到Platform:

使用API

使用UI

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