Задача «FTP»

  • Статья

Применяется к:sql Server SSIS Integration Runtime в Фабрика данных Azure

Задача «FTP» производит загрузку и передачу файлов данных, а также управляет каталогами на серверах. Например, пакет может загружать файлы данных с удаленного сервера или из Интернета в качестве части рабочего процесса пакета Integration Services. Можно использовать задачу «FTP» для следующих целей:

  • Копирование каталогов и файлов данных из одного каталога в другой перед или после перемещения данных, а также применение преобразований данных.

  • Вход на источник FTP и копирование файлов или пакетов в целевой каталог.

  • Загрузка файлов из расположения FTP и применение преобразований столбцов данных перед загрузкой данных в базу данных.

Во время выполнения задача «FTP» подключается к серверу, используя диспетчер FTP-соединений. Настройка диспетчера FTP-сеансов производится отдельно от задачи «FTP», затем в задаче «FTP» указывается ссылка на диспетчера. Диспетчер FTP-соединений включает в себя настройки сервера, учетные данные для доступа на FTP-узел, а также такие параметры, как время ожидания и количество повторных попыток подключения к серверу. Дополнительные сведения см. в статье Диспетчер FTP-соединений.

Важно!

Диспетчер FTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности. Проверка подлинности Windows не поддерживается.

При доступе к локальному файлу или локальному каталогу, задача «FTP» использует диспетчер подключения файлов или сведения о пути, хранимые в переменной. При доступе к удаленному файлу или удаленному каталогу, задача «FTP» использует явно указанный путь удаленного сервера, который указан в диспетчере FTP-соединений, или сведения о пути, хранимые в переменной. Дополнительные сведения см. в разделах Диспетчер подключений файлов и Переменные Integration Services (SSIS).

Это значит, что задача «FTP» может получать несколько файлов и удалять несколько удаленных файлов, однако задача может посылать только один файл и удалять только один локальный файл, если она использует диспетчер подключения, т.к. диспетчер подключения файлов может обращаться только к одному файлу. Для обращения к нескольким локальным файлам, задача «FTP» должна использовать переменную для предоставления сведений о пути. Например, переменная, содержащая "C:\Test&42;. txt" предоставляет путь, поддерживающий удаление или отправку всех файлов с расширением TXT в каталоге Test.

Для отправки нескольких файлов и для доступа к нескольким локальным файлам или каталогам, также можно выполнить задачу «FTP» несколько раз, включив ее в контейнер «цикл по каждому элементу». Контейнер «цикл по каждому элементу» может произвести перечисление файлов каталога, используя перечислитель For Each File. Дополнительные сведения см. в разделе Контейнер «цикл по каждому элементу».

Задача FTP поддерживает подстановочные знаки ? и * в путях. Это позволяет задаче обращаться к нескольким файлам. Однако можно использовать символы-шаблоны только в той части пути, которая указывает имя файла. Например, C:\MyDirectory\*.txt является допустимым путем, но C:\*\MyText.txt не является.

Операции FTP могут быть настроены для остановки задачи «Файловая система» при ошибке операции или для переноса файлов в режиме ASCII. Операции, которые отправляют и получают файлы, могут быть настроены для перезаписи целевых файлов и каталогов.

Стандартные FTP-операции

Задача «FTP» содержит стандартный набор операций. Данные операции описываются в следующей таблице.

Операция Description
Отправить файлы Отправляет файл с локального компьютера на FTP-сервер.
Получение файлов Сохраняет файл с FTP-сервера на локальный компьютер.
Создать локальный каталог Создает каталог на локальном компьютере.
Создать удаленный каталог Создает каталог на FTP-сервере.
Удалить локальный каталог Удаляет каталог на локальном компьютере.
Удалить удаленный каталог Удаляет каталог на FTP-сервере.
Удалить локальные файлы Удаляет файл на локальном компьютере.
Удалить удаленные файлы Удаляет файл на FTP-сервере.

Пользовательские записи журнала, доступные в задаче «FTP»

В следующей таблице перечислены пользовательские записи журнала для задачи «FTP». Дополнительные сведения см. в статье Ведение журналов в службах Integration Services (SSIS).

Запись журнала Description
FTPConnectingToServer Указывает, что задача инициализировала соединение с FTP-сервером.
FTPOperation Сообщает о начале FTP-операции, выполняемой задачей, и о типе этой операции.

Свойства могут быть заданы с помощью конструктора SSIS или программным путем.

Сведения о настройке этих свойств в конструкторе Integration Services см. в разделе Задание свойств задачи или контейнера.

Дополнительные сведения о настройке этих свойств программным путем см. в разделе FtpTask.

Редактор задачи «FTP» (страница «Общие»)

Используйте страницу Общие диалогового окна Редактор задачи «FTP» для задания диспетчера FTP-соединений, выполняющего соединение с FTP-сервером, с которым задача обменивается данными. Также здесь можно указать имя и описание задачи «FTP».

Параметры

FtpConnection
Выберите существующий диспетчер подключений FTP или щелкните <Создать подключение...>, чтобы создать диспетчер подключений.

Важно!

Диспетчер FTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности. Проверка подлинности Windows не поддерживается.

См. также: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailure
Укажите, следует ли завершить задачу «FTP» в случае ошибки операции с FTP.

Имя
Задайте уникальное имя задачи «FTP». Это имя используется в качестве метки для значка задачи.

Примечание.

Имена задач в пределах пакета должны быть уникальными.

Description
Введите описание задачи «FTP».

Редактор задачи «FTP» (страница «Передача файлов»)

Страница Передача файлов диалогового окна Редактор задачи «FTP» используется для настройки операции FTP, выполняемой задачей.

Параметры

IsRemotePathVariable
Укажите, хранится ли удаленный путь в переменной. Это свойство имеет параметры, указанные в следующей таблице.

значение Описание
True Целевой путь хранится в переменной. Выбор этого значения отображает динамический параметр RemoteVariable.
False Целевой путь задается в диспетчере подключения файлов. Выбор этого значения отображает динамический параметр RemotePath.

OverwriteFileAtDestination
Задайте, можно ли заменять файл в месте назначения.

IsLocalPathVariable
Укажите, хранится ли локальный путь в переменной. Это свойство имеет параметры, указанные в следующей таблице.

значение Описание
True Целевой путь хранится в переменной. Выбор этого значения отображает динамический параметр LocalVariable.
False Целевой путь задается в диспетчере подключения файлов. Выбор этого значения отображает динамический параметр LocalPath.

Операция
Выберите операцию протокола FTP для выполнения. Это свойство имеет параметры, указанные в следующей таблице.

значение Описание
Отправить файлы Отправляет файлы. При выборе этого значения выводятся динамические параметры LocalVariable, LocalPathRemoteVariable и RemotePath.
Получить файлы Получает файлы. При выборе этого значения выводятся динамические параметры LocalVariable, LocalPathRemoteVariable и RemotePath.
Создать локальный каталог Создает локальный каталог. При выборе этого значения выводятся динамические параметры LocalVariable и LocalPath.
Создать удаленный каталог Создает удаленный каталог. При выборе этого значения выводятся динамические параметры RemoteVariable и RemoteIPath.
Удалить локальный каталог Удаляет локальный каталог. При выборе этого значения выводятся динамические параметры LocalVariable и LocalPath.
Удалить удаленный каталог Удаляет удаленный каталог. При выборе этого значения выводятся динамические параметры RemoteVariable и RemotePath.
Удалить локальные файлы Удаляет локальные файлы. При выборе этого значения выводятся динамические параметры LocalVariable и LocalPath.
Удалить удаленные файлы Удаляет удаленные файлы. При выборе этого значения выводятся динамические параметры RemoteVariable и RemotePath.

IsTransferASCII
Укажите, должны ли файлы, передаваемые на и с удаленного FTP-сервера, передаваться в режиме ASCII.

Динамические параметры IsRemotePathVariable

IsRemotePathVariable = True

RemoteVariable
Выберите существующую пользовательскую переменную или щелкните <Создать переменную...>, чтобы создать ее.

См. также:Переменные Integration Services (SSIS), "Добавление переменной"

IsRemotePathVariable = False

RemotePath
Выберите существующий диспетчер подключений FTP или щелкните <Создать подключение...>, чтобы создать диспетчер подключений.

См. также:Диспетчер FTP-соединений, Редактор диспетчера FTP-сеансов

Динамические параметры IsLocalPathVariable

IsLocalPathVariable = True

LocalVariable
Выберите существующую пользовательскую переменную или щелкните <Создать переменную...>, чтобы создать ее.

См. также:Переменные Integration Services (SSIS), "Добавление переменной"

IsLocalPathVariable = False

LocalPath
Выберите существующий диспетчер подключений файлов или щелкните <Создать подключение...>, чтобы создать его.

См. также:Диспетчер соединений с неструктурированными файлами

См. также

Задачи служб Integration Services
Поток управления