catalog.rename_environment (base de données SSISDB)

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

S’applique à :SQL Server

Renomme un environnement dans le catalogue Integration Services.

Syntaxe

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

Arguments

[ @folder_name = ] folder_name
Nom du dossier qui contient l'environnement. folder_name est de type nvarchar(128) .

[ @environment_name = ] environment_name
Nom d'origine de l'environnement. environment_name est de type nvarchar(128) .

[ @new_environment_name = ] new_environment_name
Nouveau nom de l'environnement. new_environment_name est de type nvarchar(128).

Valeur du code de retour

0 (succès)

Jeux de résultats

None

Autorisations

Cette procédure stockée requiert l'une des autorisations suivantes :

  • Autorisations MODIFY sur l'environnement

  • Appartenance au rôle de base de données ssis_admin

  • Appartenance au rôle serveur sysadmin

Erreurs et avertissements

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :

  • Le nom d'environnement d'origine n'est pas valide

  • Le nouveau nom a déjà été utilisé dans un environnement existant

Notes

Les références environnementales des projets ne sont pas mises à jour automatiquement lorsque vous renommez l'environnement. Les références environnementales doivent être mises à jour en conséquence. Cette procédure stockée réussira même si les références environnementales sont arrêtées en modifiant le nom d'un environnement. Les références environnementales doivent être mises à jour après que cette procédure stockée s'est achevée.

Notes

Lorsqu'une référence environnementale n'est pas valide, la validation et l'exécution des packages correspondants qui utilisent ces références échoueront.