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

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к:SQL Server

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

Синтаксис

catalog.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 (успешное завершение)

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

None

Разрешения

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

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

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

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

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

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

  • Недопустимое исходное имя переменной среды

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

Remarks

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

Примечание

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