共用方式為

catalog.set_environment_reference_type (SSISDB 資料庫)

  • 發行項

針對 Integration Services 目錄中的專案，設定與現有環境參考相關聯之參考類型和環境名稱。

語法

set_environment_reference_location [ @reference_id = reference_id
    , [ @reference_type = ] reference_type
 [  , [ @environment_folder_name = ] environment_folder_name ]

引數

  • [ @reference\_id = ] reference_id
    要更新之環境參考的唯一識別碼。 reference_id 為 bigint。

  • [ @reference\_type = ] reference_type
    指出環境會位於與專案相同的資料夾 (相對參考) 中，或是在不同的資料夾 (絕對參考) 中。 使用值 R 表示相對參考。 使用值 A 表示絕對參考。 reference_type 為 char(1)。

  • [@ environment_folder_name =] environment_folder_name
    環境所在的資料夾。 對於絕對參考來說，這個值是必要值。 environment_folder_name 為 nvarchar(128)。

傳回碼值

0 (成功)

結果集

無

權限

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

  • 專案的 READ 和 MODIFY 權限，以及環境的 READ 權限

  • ssis_admin 資料庫角色成員資格

  • sysadmin 伺服器角色成員資格

錯誤和警告

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

  • 資料夾名稱、環境名稱或參考識別碼無效

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

  • 透過使用 reference_location 參數中的 A 字元指定了絕對參考，但是並未使用 environment_folder_name 參數指定資料夾名稱。

備註

專案可以具有相對或絕對的環境參考。 相對參考會依名稱參考環境，並且需要位於與專案相同的資料夾中。 絕對參考會依名稱和資料夾參考環境，且可以參考位於與專案不同資料夾中的環境。 專案可以參考多個環境。

重要事項重要事項

如果指定了相對參照，就不會使用 environment_folder_name 參數值，而且環境資料夾名稱會自動設定為 NULL。 如果指定了絕對參考，environment_folder_name 參數中必須提供環境資料夾名稱。