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

Статья
05/08/2013

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

Синтаксис

rename_environment [ @folder_name = ] folder_name
    , [ @environment_name = ] environment_name
    , [ @new_environment_name= ] new_environment_name

Аргументы

[ @folder\_name = ] folder_name
Имя папки, которая содержит среду. folder_name имеет значение nvarchar(128).
[ @environment\_name = ] environment_name
Исходное имя среды. environment_name имеет значение nvarchar(128).
[ @new\_environment\_name = ] new_environment_name
Новое имя среды. new_environment_name имеет значение nvarchar(128).

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

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

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

Нет

Разрешения

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

Разрешения MODIFY для среды
Членство в роли базы данных ssis_admin
Членство в роли сервера sysadmin

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

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

Недопустимое исходное имя переменной среды
Новое имя уже использовано в существующей среде

Замечания

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

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

Поделиться через