catalog.move_environment (base de données SSISDB)

  • Article

Déplace un environnement d'un dossier vers un autre dans le catalogue Integration Services.

Syntaxe

move_environment [ @source_folder = ] source_folder
    , [ @environment_name = ] environment_name
    , [ @destination_folder = ] destination_folder

Arguments

  • [ @source\_folder = ] source_folder
    Nom du dossier source, où l'environnement réside avant le déplacement. source_folder est nvarchar(128).

  • [@ environment_name =] environment_name
    Nom de l'environnement qui sera supprimé. environment_name est nvarchar(128).

  • [ @destination\_folder = ] destination_folder
    Nom du dossier de destination, où l'environnement réside après le déplacement. Le paramètre destination_folder est de type 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 READ et 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 :

  • L'environnement n'existe pas dans le dossier source

  • Le dossier de destination a déjà un environnement avec le même nom

  • L'utilisateur n'a pas les autorisations appropriées

Notes

Les références environnementales des projets ne suivent pas l'environnement pendant le déplacement. 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 déplaçant un environnement. Les références environnementales doivent être mises à jour après que cette procédure stockée s'est achevée.

[!REMARQUE]

Un projet peut avoir des références environnementales relatives ou absolues. Les références relatives font référence à l'environnement par nom et requièrent que l'environnement réside dans le même dossier que le projet. Les références absolues font référence à l'environnement par nom et dossier, et aux environnements qui résident dans un dossier différent de celui du projet.