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 參數中必須提供環境資料夾名稱。 |