catalog.move_environment (SSISDB 資料庫)

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

語法

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

引數

• [ @source\_folder = ] source_folder
  在移動之前，環境所在之來源資料夾的名稱。 source_folder 為 nvarchar(128)。

• [ @environment\_name = ] environment_name
  要移動之環境的名稱。 environment_name 為 nvarchar(128)。

• [ @destination\_folder = ] destination_folder
  在移動之後，環境所在之目的地資料夾的名稱。 destination_folder 為 nvarchar(128)。

傳回碼值

0 (成功)

結果集

無

權限

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

• 環境的 READ 和 MODIFY 權限

• ssis_admin 資料庫角色成員資格

• sysadmin 伺服器角色成員資格

錯誤和警告

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

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

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

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

備註

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

[!附註]

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