catalog.move_environment(SSISDB 数据库)

适用范围:SQL Server Azure 数据工厂中的 SSIS Integration Runtime

适用范围:SQL Server

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

语法

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

参数

[ @source_folder = ] source_folder
此环境在移动之前所在的源文件夹的名称。 source_foldernvarchar(128)

[ @environment_name = ] environment_name
要移动的环境的名称。 environment_name 为 nvarchar(128) 。

[ @destination_folder = ] destination_folder
此环境在移动之后所在的目标文件夹的名称。 destination_foldernvarchar(128)

返回代码值

0(成功)

结果集

权限

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

  • 针对环境的 READ 和 MODIFY 权限

  • ssis_admin 数据库角色的成员资格

  • sysadmin 服务器角色的成员资格

错误和警告

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

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

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

  • 用户没有相应的权限

注解

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

注意

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