FTP 任务可以下载和上载数据文件,并管理服务器上的目录。 例如,在 Integration Services 包工作流中,包可以从远程服务器或 Internet 位置下载数据文件。 可以将 FTP 任务用于下列用途:
-
在移动数据之前或之后,将目录和数据文件从一个目录复制到另一个目录,并对数据应用转换。
-
登录到源 FTP 位置并将文件或包复制到目标目录。
-
从 FTP 位置下载文件并在将数据加载到数据库之前对列数据应用转换。
在运行时,FTP 任务通过使用 FTP 连接管理器连接到服务器。 FTP 连接管理器与 FTP 任务分开配置,然后在 FTP 任务中引用连接管理器。 FTP 连接管理器包括服务器设置、用于访问 FTP 服务器的凭据,以及连接到服务器的超时值和重试次数之类的选项。 有关详细信息,请参阅 FTP 连接管理器。
Important:
FTP 连接管理器仅支持匿名身份验证和基本身份验证, 而不支持 Windows 身份验证。
访问本地文件或本地目录时,FTP 任务使用文件连接管理器或存储在变量中的路径信息。 与此相反,访问远程文件或远程目录时,FTP 任务使用远程服务器上的直接指定路径(在 FTP 连接管理器中指定)或存储在变量中的路径信息。 有关详细信息,请参阅文件连接管理器和 Integration Services (SSIS) 变量。
这意味着 FTP 任务可以接收多个文件和删除多个远程文件;但如果使用连接管理器,则该任务只能发送一个文件和删除一个本地文件,因为文件连接管理器只能访问一个文件。 若要访问多个本地文件,FTP 任务必须使用变量来提供路径信息。 例如,包含“C:\Test\*.txt”的变量所提供的路径可以支持删除或发送 Test 目录中所有以 .txt 为扩展名的文件。
若要发送多个文件和访问多个本地文件及目录,还可以通过在 Foreach 循环中包含 FTP 任务来多次执行 FTP 任务。 Foreach 循环可以使用 For Each 文件枚举器对目录中的文件进行枚举。 有关详细信息,请参阅 Foreach Loop Container。
FTP 任务支持在路径中使用通配符 ? 和 * 。 这使得任务可以访问多个文件。 但是,只能在路径中指定文件名的部分使用通配符。 例如,C:\MyDirectory\*.txt 是有效路径,而 C:\*\MyText.txt 则不是。
FTP 操作可以配置为在操作失败时停止文件系统任务,或以 ASCII 模式传输文件。 发送和接收文件副本的操作可以配置为覆盖目标文件和目录。
预定义的 FTP 操作
FTP 任务包含一组预定义的操作。 下表介绍了这些运算。
| 运算 | 描述 |
|---|---|
| 发送文件 | 将文件从本地计算机发送到 FTP 服务器。 |
| 接收文件 | 将文件从 FTP 服务器保存到本地计算机。 |
| 创建本地目录 | 在本地计算机上创建文件夹。 |
| 创建远程目录 | 在 FTP 服务器上创建文件夹。 |
| 删除本地目录 | 删除本地计算机上的文件夹。 |
| 删除远程目录 | 删除 FTP 服务器上的文件夹。 |
| 删除本地文件 | 删除本地计算机上的文件。 |
| 删除远程文件 | 删除 FTP 服务器上的文件。 |
FTP 任务可用的自定义日志项
下表列出了 FTP 任务的自定义日志项。 有关详细信息,请参阅 Integration Services (SSIS) 日志记录。
| 日志项 | 描述 |
|---|---|
| FTPConnectingToServer | 指示任务已启动与 FTP 服务器的连接。 |
| FTPOperation | 报告任务所执行的 FTP 操作的开始及其类型。 |
Related Tasks
可以通过 SSIS 设计器或以编程方式设置属性。
有关如何在 SSIS 设计器中设置这些属性的信息,请参阅 设置任务或容器的属性。
有关如何以编程方式设置这些属性的详细信息,请参阅 xref:Microsoft.SqlServer.Dts.Tasks.FtpTask.FtpTask。
FTP 任务编辑器(“常规”页)
使用 “FTP 任务编辑器” 对话框的 “常规” 页可以指定连接到与任务通信的 FTP 服务器的 FTP 连接管理器。 您还可以命名和描述 FTP 任务。
选项
FtpConnection
选择现有 FTP 连接管理器,或单击“<新建连接...>”以创建连接管理器。
Important:
FTP 连接管理器仅支持匿名身份验证和基本身份验证, 而不支持 Windows 身份验证。
相关主题: FTP Connection Manager、 FTP Connection Manager Editor
StopOnFailure
指示在 FTP 操作失败时是否终止 FTP 任务。
名称
为 FTP 任务提供唯一的名称。 此名称用作任务图标中的标签。
Note:
任务名称在一个包内必须是唯一的。
Description
键入对 FTP 任务的说明。
FTP 任务编辑器(“文件传输”页)
可以使用 “FTP 任务编辑器” 对话框的 “文件传输” 页配置任务执行的 FTP 操作。
选项
IsRemotePathVariable
指示远程路径是否存储在变量中。 此属性具有下表所列的选项。
| ReplTest1 | 描述 |
|---|---|
| True | 目标路径存储在变量中。 选择该值将显示动态选项 RemoteVariable。 |
| False | 目标路径在文件连接管理器中指定。 选择该值将显示动态选项 RemotePath。 |
OverwriteFileAtDestination
指定是否可以覆盖目标位置中的文件。
IsLocalPathVariable
指示本地路径是否存储在变量中。 此属性具有下表所列的选项。
| ReplTest1 | 描述 |
|---|---|
| True | 目标路径存储在变量中。 选择该值将显示动态选项 LocalVariable。 |
| False | 目标路径在文件连接管理器中指定。 选择该值将显示动态选项 LocalPath。 |
运算
选择要执行的 FTP 操作。 此属性具有下表所列的选项。
| ReplTest1 | 描述 |
|---|---|
| 发送文件 | 发送文件。 选择此值将显示动态选项 LocalVariable、 LocalPathRemoteVariable 和 RemotePath。 |
| 接收文件 | 接收文件。 选择此值将显示动态选项 LocalVariable、 LocalPathRemoteVariable 和 RemotePath。 |
| 创建本地目录 | 创建本地目录。 选择此值将显示动态选项 LocalVariable 和 LocalPath。 |
| 创建远程目录 | 创建远程目录。 选择此值将显示动态选项 RemoteVariable 和 RemotelPath。 |
| 删除本地目录 | 删除本地目录。 选择此值将显示动态选项 LocalVariable 和 LocalPath。 |
| 删除远程目录 | 删除远程目录。 选择此值将显示动态选项 RemoteVariable 和 RemotePath。 |
| 删除本地文件 | 删除本地文件。 选择此值将显示动态选项 LocalVariable 和 LocalPath。 |
| 删除远程文件 | 删除远程文件。 选择此值将显示动态选项 RemoteVariable 和 RemotePath。 |
IsTransferASCII
指示是否应以 ASCII 模式传输从远程 FTP 服务器传输来的文件和传输到远程 FTP 服务器上的文件。
IsRemotePathVariable 动态选项
IsRemotePathVariable = True
RemoteVariable
选择现有的用户定义变量,或单击“<新建变量...>”以创建用户定义变量。
相关主题:Integration Services (SSIS) 变量、添加变量
IsRemotePathVariable = False
RemotePath
选择现有 FTP 连接管理器,或单击“<新建连接...>”以创建连接管理器。
相关主题 FTP 连接管理器、 FTP 连接管理器编辑器
IsLocalPathVariable 动态选项
IsLocalPathVariable = True
LocalVariable
选择现有的用户定义变量,或单击“<新建变量...>”以创建变量。
相关主题:Integration Services (SSIS) 变量、添加变量
IsLocalPathVariable = False
LocalPath
选择现有文件连接管理器,或单击“<新建连接...>”以创建连接管理器。
相关主题:平面文件连接管理器
另请参阅
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 douglaslMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
