catalog.rename_environment(SSISDB 数据库)

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

语法

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 服务器角色的成员身份

错误和警告

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

  • 原始环境名称无效

  • 新名称已用于现有环境

注释

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

注意注意

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