catalog.move_environment（SSISDB 数据库）

将环境从一个文件夹移到 Integration Services 目录中的另一个文件夹。

语法

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

参数

• [ @source\_folder = ] source_folder
  此环境在移动之前所在的源文件夹的名称。 source_folder 的数据类型为 nvarchar(128)。

• [ @environment\_name = ] environment_name
  要移动的环境的名称。 environment_name 的数据类型为 nvarchar(128)。

• [ @destination\_folder = ] destination_folder
  此环境在移动之后所在的目标文件夹的名称。 destination_folder 的数据类型为 nvarchar(128)。

返回代码值

0（成功）

结果集

无

权限

此存储过程需要下列权限之一：

• 针对环境的 READ 和 MODIFY 权限

• ssis_admin 数据库角色的成员身份

• sysadmin 服务器角色的成员身份

错误和警告

下面的列表描述了一些可能引发错误或警告的情况：

• 在源文件夹中不存在此环境

• 目标文件夹中已存在同名的环境

• 用户不具备适当的权限

注释

在移动过程中，项目中的环境引用未遵循此环境。 必须相应地更新环境引用。 即使通过移动环境损坏了环境引用，此存储过程也会成功。 在此存储过程完成之后，必须更新环境引用。

注意
项目可以具有相对或绝对的环境引用。 相对引用通过名称引用环境，这些引用要求环境与项目位于相同文件夹中。 绝对引用通过名称和文件夹引用环境，这些引用引用与项目不在同一文件夹中的环境。