次の方法で共有

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 パラメーターで指定されなかった

解説

プロジェクトでは、相対または絶対環境参照を使用できます。 相対参照の場合、名前によって環境を参照します。この環境はプロジェクトと同じフォルダーに格納されている必要があります。 絶対参照の場合、名前とフォルダーによって環境を参照します。プロジェクトとは異なるフォルダーに格納されている環境を参照する場合があります。 プロジェクトでは複数の環境を参照できます。