SFTP连接
目标更改日志 changelog
在2023年7月发行的Experience Platform中,SFTP目标提供了新功能,如下所示:
- 支持导出数据集。
- 额外的文件命名选项。
- 可通过改进的映射步骤在您导出的文件中设置自定义文件头。
- 能够自定义导出的CSV数据文件的格式。
概述 overview
创建到SFTP服务器的实时出站连接,定期从Adobe Experience Platform导出分隔的数据文件。
通过API或用户界面连接到SFTP connect-api-or-ui
- 要使用Platform用户界面连接到SFTP存储位置,请阅读下面的连接到目标和将受众激活到此目标部分。
- 要以编程方式连接到SFTP存储位置,请阅读使用流服务API教程将受众激活到基于文件的目标。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息,请参阅下表。
导出数据集 export-datasets
此目标支持数据集导出。 有关如何设置数据集导出的完整信息,请阅读教程:
导出数据的文件格式 file-format
导出 受众数据 时,Platform会在您提供的存储位置创建一个.csv
、parquet
或.json
文件。 有关这些文件的更多信息,请参阅Audience Activation教程中的导出的支持文件格式部分。
导出 数据集 时,Platform会在您提供的存储位置创建一个.parquet
或.json
文件。 有关这些文件的更多信息,请参阅导出数据集教程中的验证成功的数据集导出部分。
连接到目标 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地址允许列表一文。