catalog.move_environment (SSISDB 資料庫)

適用於:SQL Server Azure Data Factory 中的 SSIS Integration Runtime

適用於:SQL Server

將環境從 Integration Services 目錄中的某個資料夾移至另一個資料夾。

語法

catalog.move_environment [ @source_folder = ] source_folder  
    , [ @environment_name = ] environment_name  
    , [ @destination_folder = ] destination_folder  

引數

[ @source_folder = ] source_folder
在移動之前,環境所在之來源資料夾的名稱。 source_foldernvarchar(128)

[ @environment_name = ] environment_name
要移動之環境的名稱。 environment_namenvarchar(128)

[ @destination_folder = ] destination_folder
在移動之後,環境所在之目的地資料夾的名稱。 destination_foldernvarchar(128)

傳回碼值

0 (成功)

結果集

None

權限

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

  • 環境的 READ 和 MODIFY 權限

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

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

錯誤和警告

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

  • 環境不存在於來源資料夾中

  • 目的地資料夾已有名稱相同的環境

  • 使用者未具備適當的權限

備註

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

注意

專案可以具有相對或絕對的環境參考。 相對參考會依名稱參考環境,而這些參考會要求環境位於與專案相同的資料夾中。 絕對參考會依名稱和資料夾參考環境,而這些參考會參考位於與專案資料夾不同之資料夾中的環境。