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 伺服器角色成員資格

錯誤和警告

下列清單將描述可能會引發錯誤或警告的某些條件：

• 原始環境名稱無效

• 新的名稱已經使用於現有環境

備註

重新命名環境時，不會自動更新來自專案的環境參考。 環境參考必須隨之更新。 即使環境參考因為變更環境名稱而中斷，這個預存程序仍然會成功。 環境參考必須在預存程序完成之後更新。

[!附註]

當環境參考無效時，使用這些參考的對應封裝之驗證和執行將會失敗。