catalog.move_environment (база данных SSISDB)

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

Синтаксис

move_environment [ @source_folder = ] source_folder
    , [ @environment_name = ] environment_name
    , [ @destination_folder = ] destination_folder

Аргументы

• [ @source\_folder = ] source_folder
  Имя исходной папки, в которой среда хранится до перемещения. source_folder имеет значение nvarchar(128).

• [ @environment\_name = ] environment_name
  Имя перемещаемой среды. Параметр environment_name имеет тип nvarchar(128).

• [ @destination\_folder = ] destination_folder
  Имя целевой папки, в которой среда хранится после перемещения. Параметр destination_folder имеет тип nvarchar(128).

Значения кодов возврата

0 (успешное завершение)

Результирующие наборы

Нет

Разрешения

Эта хранимая процедура требует применения одного из следующих разрешений:

• Разрешения READ и MODIFY для среды

• Членство в роли базы данных ssis_admin

• Членство в роли сервера sysadmin

Ошибки и предупреждения

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

• В исходной папке среда отсутствует

• В указанной папке уже существует среда с тем же именем

• Пользователь не имеет соответствующих разрешений

Замечания

Ссылки из проектов на среду не изменяются с учетом перемещения. Ссылки на среду должны обновляться соответствующим образом. Хранимая процедура будет выполнена успешно, даже если вследствие перемещения среды ссылки на нее оказались недействительными. Ссылки на среду должны обновляться после завершения этой хранимой процедуры.

Примечание
Проект может иметь относительные или абсолютные ссылки на среду. Относительные ссылки указывают среду по имени, для использования этих ссылок среда должна находиться в той же папке, что и проект. Абсолютные ссылки указывают среду по имени и папке, они могут ссылаться на среду, расположенную в другой папке, отличной от папки, в которой находится проект.