catalog.create_environment (SSISDB Database)

Creates an environment in the Integration Services catalog.

Syntax

create_environment [ @folder_name = ] folder_name
     , [ @environment_name = ] environment_name
  [  , [ @environment_description = ] environment_description ]

Arguments

• [ @folder\_name = ] folder_name
  The name of the folder that will contain the environment. The folder_name is nvarchar(128).

• [ @environment\_name = ] environment_name
  The name of the environment. The environment_name is nvarchar(128).

• [ @environment\_description= ] environment_description
  An optional description of the environment. The environment_description is nvarchar(1024).

Return Code Value

0 (success)

Result Sets

None

Permissions

This stored procedure requires one of the following permissions:

• READ and MODIFY permissions on the folder

• Membership to the ssis_admin database role

• database role

• Membership to the sysadmin server role

Errors and Warnings

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

• The folder name cannot be found

• An environment that has the same name already exists in the specified folder

Remarks

The environment name must be unique within the folder.