SFTP连接
目标更改日志 changelog
在2023年7月发行的Experience Platform中,SFTP目标提供了新功能,如下所示:
- 支持导出数据集。
- 额外的文件命名选项。
- 可通过改进的映射步骤在您导出的文件中设置自定义文件头。
- 能够自定义导出的CSV数据文件的格式。
概述 overview
创建到SFTP服务器的实时出站连接,定期从Adobe Experience Platform导出分隔的数据文件。
通过API或用户界面连接到SFTP connect-api-or-ui
- 要使用Experience Platform用户界面连接到SFTP存储位置,请阅读下面的连接到目标和将受众激活到此目标部分。
- 要以编程方式连接到SFTP存储位置,请阅读使用流服务API教程将受众激活到基于文件的目标。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息,请参阅下表。
导出数据集 export-datasets
此目标支持数据集导出。 有关如何设置数据集导出的完整信息,请阅读教程:
导出数据的文件格式 file-format
导出 受众数据 时,Experience Platform会在您提供的存储位置创建一个.csv
、parquet
或.json
文件。 有关这些文件的更多信息,请参阅Audience Activation教程中的导出的支持文件格式部分。
导出 数据集 时,Experience Platform会在您提供的存储位置创建一个.parquet
或.json
文件。 有关这些文件的更多信息,请参阅导出数据集教程中的验证成功的数据集导出部分。
SFTP服务器连接要求 sftp-connection-requirements
要确保成功导出数据,必须将目标SFTP服务器配置为允许有足够数量的并发连接。 如果SFTP服务器限制同时连接的数量,则可能会遇到导出作业失败的情况,尤其是同时导出多个受众或数据集时。
推荐
为获得最佳性能,SFTP服务器应为要导出的每个受众或数据集至少允许一个并发连接。 服务器至少应支持计划同时导出的受众或数据集总数的30%。
示例
如果计划同时为100个受众或数据集导出,则SFTP服务器应允许至少30个并发连接。
正确配置SFTP服务器的连接限制有助于防止导出失败,并确保从Adobe Experience Platform可靠传送数据。
连接到目标 connect
要连接到此目标,请按照目标配置教程中描述的步骤操作。 在配置目标工作流中,填写下面两个部分中列出的字段。
身份验证信息 authentication-information
如果选择带有密码 身份验证类型的 SFTP连接到您的SFTP位置:
-
域: SFTP存储位置的地址;
-
用户名:用于登录到SFTP存储位置的用户名;
-
端口: SFTP存储位置使用的端口;
-
密码:用于登录到SFTP存储位置的密码。
-
加密密钥: (可选)您可以附加RSA格式的公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
如果选择 SFTP with SSH key 身份验证类型连接到SFTP位置:
-
域:填写SFTP帐户的IP地址或域名
-
端口: SFTP存储位置使用的端口;
-
用户名:用于登录到SFTP存储位置的用户名;
-
SSH密钥:用于登录到SFTP存储位置的私有SSH密钥。 私钥必须是RSA格式的Base64编码字符串,且不得受密码保护。
-
加密密钥: (可选)您可以附加RSA格式的公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
目标详细信息 destination-details
在建立与SFTP位置的身份验证连接后,提供目标的以下信息:
-
名称:输入一个名称,帮助您在Experience Platform用户界面中识别此目标;
-
描述:输入此目标的描述;
-
文件夹路径:在要导出文件的SFTP位置中输入文件夹的路径。
-
文件类型:选择Experience Platform应用于导出文件的格式。 在选择CSV选项时,您还可以配置文件格式选项。
-
压缩格式:选择Experience Platform应用于导出文件的压缩类型。
-
包含清单文件:如果希望导出包含清单JSON文件,并且该文件包含有关导出位置、导出大小等的信息,请打开此选项。 清单的命名格式为
manifest-<<destinationId>>-<<dataflowRunId>>.json
。 查看样本清单文件。 清单文件包含以下字段:flowRunId
:生成导出文件的数据流运行。scheduledTime
:导出文件时的时间(UTC时间)。exportResults.sinkPath
:存储位置中保存导出文件的路径。exportResults.name
:导出文件的名称。size
:导出文件的大小(字节)。
激活此目标的受众 activate
有关将受众激活到此目标的说明,请参阅将受众数据激活到批量配置文件导出目标。
验证数据导出是否成功 exported-data
要验证数据是否已成功导出,请检查您的SFTP存储,并确保导出的文件包含预期的配置文件人口。
IP地址允许列表 ip-address-allow-list
如果您需要将Adobe 列入允许列表 IP添加到,请参阅IP地址允许列表一文。