catalog.rename_environment (base de données SSISDB)
Renomme un environnement dans le catalogue Integration Services.
Syntaxe
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 nvarchar(128).[@ environment_name =] environment_name
Nom d'origine de l'environnement. environment_name est nvarchar(128).[@ new_environment_name =] new_environment_name
Nouveau nom de l'environnement. new_environment_name est nvarchar(128).
Valeurs des codes de retour
0 (succès)
Jeux de résultats
Aucun
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 de 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.
[!REMARQUE]
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.