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

Статья
11/19/2024

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных 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 (успешное завершение)

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

нет

Разрешения

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

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

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

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

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

Замечания

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

Примечание.

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

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