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.