catalog.rename_environment (base de données SSISDB)

  • Article

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.