catalog.rename_environment (SSISDB Database)

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

gäller för:SQL Server

Byter namn på en miljö i katalogen Integration Services.

Syntax

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

Argument

[ @folder_name = ] folder_name
Namnet på mappen som innehåller miljön. folder_name är nvarchar(128).

[ @environment_name = ] environment_name
Det ursprungliga namnet på miljön. environment_name är nvarchar(128).

[ @new_environment_name = ] new_environment_name
Det nya namnet på miljön. new_environment_name är nvarchar(128).

Returnera kodvärde

0 (lyckades)

Resultatuppsättningar

Ingen

Behörigheter

Den här lagrade proceduren kräver någon av följande behörigheter:

• ÄNDRA behörigheter för miljön

• Medlemskap i ssis_admin databasrollen

• Medlemskap i serverrollen sysadmin

Fel och varningar

I följande lista beskrivs vissa villkor som kan orsaka ett fel eller en varning:

• Det ursprungliga miljönamnet är inte giltigt

• Det nya namnet har redan använts i en befintlig miljö

Anmärkningar

Miljöreferenser från projekt uppdateras inte automatiskt när du byter namn på miljön. Miljöreferenser måste uppdateras i enlighet med detta. Den här lagrade proceduren lyckas även om miljöreferenserna bryts genom att miljönamnet ändras. Miljöreferenser måste uppdateras när den här lagrade proceduren har slutförts.

Not

När en miljöreferens inte är giltig misslyckas verifieringen och körningen av motsvarande paket som använder dessa referenser.