catalog.move_environment (SSISDB Database)


THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Moves an environment from one folder to another within the Integration Services catalog.

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

[ @source_folder = ] source_folder
The name of the source folder, where the environment resides before the move. The source_folder is nvarchar(128).

[ @environment_name = ] environment_name
The name of the environment that is to be moved. The environment_name is nvarchar(128).

[ @destination_folder = ] destination_folder
The name of the destination folder, where the environment resides after the move. The destination_folder is nvarchar(128).

0 (success)


This stored procedure requires one of the following permissions:

  • READ and MODIFY permissions on the environment

  • Membership to the ssis_admin database role

  • Membership to the sysadmin server role

The following list describes some conditions that may raise an error or warning:

  • The environment does not exist in the source folder

  • The destination folder already has an environment with the same name

  • The user does not have the appropriate permissions

Environment references from projects do not follow the environment during the move. Environment references must be updated accordingly. This stored procedure will succeed even if environment references are broken by moving an environment. Environment references must be updated after this stored procedure completes.

System_CAPS_ICON_note.jpg Note

A project can have relative or absolute environment references. Relative references refer to the environment by name, and these references require that the environment reside in the same folder as the project. 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.

Community Additions