catalog.move_environment (base de données SSISDB)catalog.move_environment (SSISDB Database)

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Déplace un environnement d'un dossier vers un autre dans le catalogue Integration ServicesIntegration Services.Moves an environment from one folder to another within the Integration ServicesIntegration Services catalog.

SyntaxeSyntax

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

ArgumentsArguments

[ @source_folder = ] source_folder[ @source_folder = ] source_folder
Nom du dossier source, où l'environnement réside avant le déplacement.The name of the source folder, where the environment resides before the move. source_folder est de type nvarchar(128).The source_folder is nvarchar(128).

[ @environment_name = ] environment_name[ @environment_name = ] environment_name
Nom de l'environnement qui sera supprimé.The name of the environment that is to be moved. environment_name est de type nvarchar(128).The environment_name is nvarchar(128).

[ @destination_folder = ] destination_folder[ @destination_folder = ] destination_folder
Nom du dossier de destination, où l'environnement réside après le déplacement.The name of the destination folder, where the environment resides after the move. destination_folder est de type nvarchar(128).The destination_folder is nvarchar(128).

Valeur du code de retourReturn Code Value

0 (succès)0 (success)

Jeux de résultatsResult Sets

AucuneNone

PermissionsPermissions

Cette procédure stockée requiert l'une des autorisations suivantes :This stored procedure requires one of the following permissions:

  • Autorisations READ et MODIFY sur l'environnementREAD and MODIFY permissions on the environment

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :The following list describes some conditions that may raise an error or warning:

  • L'environnement n'existe pas dans le dossier sourceThe environment does not exist in the source folder

  • Le dossier de destination a déjà un environnement avec le même nomThe destination folder already has an environment with the same name

  • L’utilisateur n’a pas les autorisations appropriéesThe user does not have the appropriate permissions

NotesRemarks

Les références environnementales des projets ne suivent pas l'environnement pendant le déplacement.Environment references from projects do not follow the environment during the move. Les références environnementales doivent être mises à jour en conséquence.Environment references must be updated accordingly. 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.This stored procedure will succeed even if environment references are broken by moving an environment. Les références environnementales doivent être mises à jour après que cette procédure stockée s'est achevée.Environment references must be updated after this stored procedure completes.

Note

Un projet peut avoir des références environnementales relatives ou absolues.A project can have relative or absolute environment references. 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.Relative references refer to the environment by name, and these references require that the environment reside in the same folder as the project. 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.Absolute references refer to the environment by name and folder, and these references refer to environments that reside in a different folder from that of the project.