共用方式為


catalog.rename_environment (SSISDB 資料庫)

適用於:SQL Server Azure Data Factory 中的 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_namenvarchar(128)

[ @environment_name = ] environment_name
環境的原始名稱。 environment_namenvarchar(128)

[ @new_environment_name = ] new_environment_name
環境的新名稱。 new_environment_namenvarchar(128)

傳回碼值

0 (成功)

結果集

None

權限

這個預存程序需要下列其中一個權限:

  • 環境的 MODIFY 權限

  • ssis_admin 資料庫角色的成員資格

  • 系統管理員伺服器角色的成員資格

錯誤和警告

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

  • 原始環境名稱無效

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

備註

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

注意

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