共用方式為

catalog.create_environment_reference (SSISDB 資料庫)

  • 發行項

為 Integration Services 目錄中的專案建立環境參考。

語法

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @environment_folder_name = ] environment_folder_name ]
  [  , [ @reference_id = ] reference_id OUTPUT ]

引數

  • [ @folder\_name = ] folder_name
    參考環境之專案的資料夾名稱。 folder_name 為 nvarchar(128)。

  • [ @project\_name = ] project_name
    參考環境的專案名稱。 project_name 為 nvarchar(128)。

  • [ @environment\_name = ] environment_name
    正在參考的環境名稱。 environment_name 為 nvarchar(128)。

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

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

  • [ @reference\_id = ] reference_id
    傳回新參考的唯一識別碼。 這個參數是選擇性的。 reference_id 為 bigint。

傳回碼值

0 (成功)

結果集

無

權限

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

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

  • ssis_admin 資料庫角色成員資格

  • sysadmin 伺服器角色成員資格

錯誤和警告

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

  • 資料夾名稱無效

  • 專案名稱無效

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

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

備註

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