catalog.rename_environment (databáze SSISDB)

Článek
03/05/2025

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

platí pro:SQL Server

Přejmenuje prostředí v katalogu integračních služeb.

Syntax

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

Argumenty

[ @folder_name = ] folder_name
Název složky, která obsahuje prostředí. folder_name je nvarchar(128).

[ @environment_name = ] environment_name
Původní název prostředí. environment_name je nvarchar(128).

[ @new_environment_name = ] new_environment_name
Nový název prostředí. new_environment_name je nvarchar(128).

Návratová hodnota kódu

0 (úspěch)

Sady výsledků

Žádný

Dovolení

Tato uložená procedura vyžaduje jedno z následujících oprávnění:

ÚPRAVA oprávnění pro prostředí
Členství v roli databáze ssis_admin
Členství v roli serveru správce systému

Chyby a upozornění

Následující seznam popisuje některé podmínky, které mohou vyvolat chybu nebo upozornění:

Původní název prostředí není platný.
Nový název již byl použit v existujícím prostředí.

Poznámky

Odkazy na prostředí z projektů se při přejmenování prostředí automaticky neaktualizují. Odkazy na prostředí musí být odpovídajícím způsobem aktualizovány. Tato uložená procedura bude úspěšná i v případě, že se odkazy na prostředí přeruší změnou názvu prostředí. Po dokončení této uložené procedury je nutné aktualizovat odkazy na prostředí.

Poznámka

Pokud odkaz na prostředí není platný, ověření a spuštění odpovídajících balíčků, které tyto odkazy používají, selžou.

Sdílet prostřednictvím