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 伺服器角色成員資格
錯誤和警告
下列清單將描述可能會引發錯誤或警告的某些條件:
原始環境名稱無效
新的名稱已經使用於現有環境
備註
重新命名環境時,不會自動更新來自專案的環境參考。 環境參考必須隨之更新。 即使環境參考因為變更環境名稱而中斷,這個預存程序仍然會成功。 環境參考必須在預存程序完成之後更新。
[!附註]
當環境參考無效時,使用這些參考的對應封裝之驗證和執行將會失敗。