Бөлісу құралы:

Задача "Файловая система"

  • Мақала

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

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

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

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

Предопределенные операции файловой системы

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

Операция Description
Копировать каталог Копирует папку из одного места в другое.
Копировать файл Копирует файл из одного места в другое.
Создать каталог Создает папку в указанном месте.
Удалить каталог Удаляет папку в указанном месте.
Удалить содержимое каталога Удаляет все файлы и вложенные папки в текущей папке.
Удалить файл Удаляет файл в указанном месте.
Переместить каталог Перемещает папку из одного места в другое.
Переместить файл Перемещает файл из одного места в другое.
Переименовать файл Переименовывает файл в указанном месте.
Определение атрибутов Устанавливает атрибуты файлов и папок. Атрибуты принимают следующие значения: «архивный», «скрытый», «обычный», «только чтение» и «системный». «Обычный» означает отсутствие атрибутов, и его невозможно объединять с другими атрибутами. Все другие атрибуты можно использовать совместно.

Задача «Файловая система» работает с одиночным файлом или каталогом. Поэтому данная задача не позволяет использовать символы-шаблоны для выполнения одной операции над несколькими файлами. Чтобы задача «Файловая система» повторила операцию над несколькими файлами или каталогами, поместите ее в контейнер «цикл по каждому элементу», как описано в следующих разделах:

  • Настройка параметров контейнера «цикл по каждому элементу» На странице Коллекция редактора циклов по каждому элементу установите Перечислитель с циклом по каждому файлу и введите выражение с шаблонами в качестве настройки для поля Файлы. На странице Сопоставления переменной редактора циклов по каждому элементу укажите переменную, которую нужно использовать, чтобы передавать имена файлов по одному в задачу «Файловая система».

  • Добавление и настройка задачи «Файловая система» Добавьте задачу «Файловая система» в контейнер «цикл по каждому элементу». На странице Общие редактора задачи «Файловая система» установите свойство SourceVariable или DestinationVariable для переменной, определенной в контейнере «цикл по каждому элементу».

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

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

Запись журнала Description
FileSystemOperation Сообщает об операции, выполняемой задачей. Эта запись журнала формируется, когда операция файловой системы начинается и включает сведения об источнике и назначении.

Настройка задачи «Файловая система»

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

Дополнительные сведения о свойствах, которые можно задать в конструкторе служб SSIS, см. в следующих разделах:

Дополнительные сведения о настройке этих свойств в конструкторе служб SSIS см. в следующем разделе:

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

Службы Integration Services включают задачу, которая загружает и отправляет файлы данных и управляет каталогами на серверах. Дополнительные сведения см. в статье FTP Task.

Редактор задачи «Файловая система» (страница «Общие»)

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

Необходимо указать диспетчер подключений к источнику и назначению, установив свойства SourceConnection и DestinationConnection. Можно задать либо имена диспетчеров подключения файлов, которые указывают на файлы, используемые задачей в качестве источника или назначения, либо, если пути к файлам хранятся в переменных, имена этих переменных. Чтобы использовать переменные для хранения путей к файлам, вначале необходимо задать значение Trueдля параметра соединения с источником IsSourcePathVariable и параметра соединения с назначением IsDestinationPatheVariable. После этого можно выбрать существующие системные или определенные пользователем переменные либо можно создать новые переменные. В диалоговом окне Добавить переменную можно настроить переменные и указать область их действия. Областью действия должна быть задача «Файловая система» или родительский контейнер. Дополнительные сведения см. в статье Переменные в службах Integration Services (SSIS) и разделе об использовании переменных в пакетах.

Примечание.

Чтобы переопределить переменные, выбранные для свойств SourceConnection и DestinationConnection , введите выражения для свойств Source и Destination . Эти выражения вводятся на странице Выражения редактора задачи Файловая система. Например, чтобы задать путь к файлам, которые задача будет использовать в качестве назначения, может потребоваться в одном случае использовать переменную A, а в другом — переменную B.

Примечание.

Задача «Файловая система» работает с одиночным файлом или каталогом. Поэтому данная задача не поддерживает использование символов-шаблонов для выполнения одинаковых операций на множестве файлов или каталогов. Чтобы заставить задачу «Файловая система» повторить операцию для множества файлов или каталогов, поместите ее в контейнер «цикл по каждому элементу». Дополнительные сведения см. в статье File System Task.

Можно использовать выражения для использования других переменных для

Параметры

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

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

OverwriteDestination
Укажите, может ли операция перезаписывать файлы в каталоге назначения.

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

Примечание.

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

Description
Введите описание задачи «Файловая система».

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

значение Описание
Копировать каталог Скопируйте каталог. При выборе этого значения отображаются динамические параметры для источника и места назначения.
Копировать файл Скопируйте файл. При выборе этого значения отображаются динамические параметры для источника и места назначения.
Создать каталог Создайте каталог. При выборе этого значения отображаются динамические параметры для исходного и целевого каталога.
Удалить каталог Удалите каталог. При выборе этого значения отображаются динамические параметры для источника.
Удалить содержимое каталога Удалите содержимое каталога. При выборе этого значения отображаются динамические параметры для источника.
Удалить файл Удалите файл. При выборе этого значения отображаются динамические параметры для источника.
Переместить каталог Переместите каталог. При выборе этого значения отображаются динамические параметры для источника и места назначения.
Переместить файл Переместите файл. При выборе этого значения отображаются динамические параметры для источника и места назначения. При перемещении файла не включайте его имя в путь назначения.
Переименовать файл Переименуйте файл. При выборе этого значения отображаются динамические параметры для источника и места назначения. При переименовании файла, включите новое имя файла в путь назначения.
Задать атрибуты Задайте атрибуты файла или каталога. При выборе этого значения отображаются динамические параметры для источника и операции.

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

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

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

IsDestinationPathVariable = True

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

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

IsDestinationPathVariable = False

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

Связанные разделы: диспетчер подключений файлов, редактор диспетчер подключений файлов

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

IsSourcePathVariable = True

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

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

IsSourcePathVariable = False

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

Связанные разделы: диспетчер подключений файлов

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

Операция = Задать атрибуты

Скрыта
Укажите, виден ли файл или каталог.

ReadOnly
Укажите, доступен ли файл только для чтения.

Архив
Укажите, готов ли файл или каталог для архивирования.

Системные
Укажите, является ли файл файлом операционной системы.

Операция = Создать каталог

UseDirectoryIfExists
Указывает, использует ли операция Создать каталог существующий каталог с указанным именем вместо создания нового каталога.

См. также

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