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
此目标支持数据集导出。 有关如何设置数据集导出的完整信息,请阅读教程:
- 操作方法 使用Platform用户界面导出.
- 操作方法 使用流服务API以编程方式导出数据集.
导出数据的文件格式 file-format
导出时 受众数据,平台创建 .csv
, parquet
,或 .json
文件存储位置。 有关这些文件的详细信息,请参见 支持的导出文件格式 部分。
导出时 数据集,平台创建 .parquet
或 .json
文件存储位置。 有关这些文件的详细信息,请参见 验证数据集导出是否成功 导出数据集教程中的部分。
连接到目标 connect
要连接到此目标,请按照 目标配置教程. 在配置目标工作流中,填写下面两个部分中列出的字段。
身份验证信息 authentication-information
如果您选择 包含密码的SFTP 用于连接到SFTP位置的身份验证类型:
-
域:SFTP存储位置的地址;
-
用户名:用于登录到SFTP存储位置的用户名;
-
端口:您的SFTP存储位置使用的端口;
-
密码:用于登录到SFTP存储位置的密码。
-
加密密钥:(可选)您可以附加RSA格式公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
如果您选择 包含SSH密钥的SFTP 用于连接到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
请参阅 IP地址允许列表 文章(如果需要将AdobeIP添加到允许列表)。