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_name 是 nvarchar(128) 。

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

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

傳回碼值

0 (成功)

結果集

None

權限

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

  • 環境的 MODIFY 權限

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

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

錯誤和警告

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

  • 原始環境名稱無效

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

備註

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

注意

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