catalog.rename_environment（SSISDB 数据库）

  • 项目

适用于：SQL Server Azure 数据工厂中的 SSIS Integration Runtime

适用于：SQL Server

在 Integration Services 目录中重命名环境。

语法

catalog.rename_environment [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @new_environment_name= ] new_environment_name

参数

[ @folder_name = ] folder_name
包含环境的文件夹的名称。 folder_name 为 nvarchar(128) 。

[ @environment_name = ] environment_name
环境的原始名称。 environment_name 为 nvarchar(128) 。

[ @new_environment_name = ] new_environment_name
环境的新名称。 new_environment_name 为 nvarchar(128)。

返回代码值

0（成功）

结果集

无

权限

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

  • 针对环境的 MODIFY 权限

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

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

错误和警告

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

  • 原始环境名称无效

  • 新名称已用于现有环境

备注

当您重命名环境时，项目中的环境引用不会自动更新。 必须相应地更新环境引用。 即使通过更改环境名称损坏了环境引用，此存储过程也会成功。 在此存储过程完成之后，必须更新环境引用。

备注

当一个环境引用无效时，对使用这些引用的包进行验证和执行将失败。