catalog.create_execution (SSISDB データベース)
Integration Services カタログの実行のインスタンスを作成します。
このストアド プロシージャは既定のサーバーのログ レベルを使用します。
構文
create_execution [ @folder_name = folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
[ , [ @reference_id = ] reference_id ]
[ , [ @use32bitruntime = ] use32bitruntime ]
, [ @execution_id = ] execution_id OUTPUT
引数
[ @folder\_name = ] folder_name
実行するパッケージが格納されているフォルダーの名前。 folder_name は nvarchar(128) 型です。[ @project\_name = ] project_name
実行するパッケージが格納されているプロジェクトの名前。 project_name は nvarchar(128) 型です。[ @package\_name = ] package_name
実行するパッケージの名前。 package_name は nvarchar(260) 型です。[ @reference\_id = ] reference_id
環境参照の一意識別子。 このパラメーターはオプションです。 reference_id は bigint 型です。[ @use32bitruntime = ] use32bitruntime
64 ビット オペレーティング システムで 32 ビットのランタイムを使用してパッケージを実行するかどうかを示します。 値 1 を使用すると、64 ビット オペレーティング システムで実行しているときに、32 ビット ランタイムでパッケージを実行します。 値 0 を使用すると、64 ビット オペレーティング システムで実行しているときに、64 ビット ランタイムでパッケージを実行します。 このパラメーターはオプションです。 Use32bitruntime は bit 型です。[ @execution\_id = ] execution_id
実行のインスタンスの一意識別子を返します。 execution_id は bigint 型です。
解説
実行は、パッケージの実行の 1 つのインスタンス中にパッケージによって使用されるパラメーター値を指定するために使用されます。
環境参照が reference_id パラメーターで指定されている場合、ストアド プロシージャは、リテラル値、または対応する環境変数から参照された値でプロジェクト パラメーターおよびパッケージ パラメーターを設定します。 環境参照が指定されている場合は、パッケージの実行中、既定のパラメーター値が使用されます。 特定の実行インスタンスで使用される値を正確に判断するには、このストアド プロシージャから execution_id 出力パラメーター値を使用し、execution_parameter_values ビューに対してクエリを実行します。
実行で指定できるのは、エントリ ポイントのパッケージとしてマークされたパッケージのみです。 エントリ ポイントではないパッケージを指定すると、実行が失敗します。
例
次の例では catalog.create_execution を呼び出して、Child1.dtsx パッケージの実行のインスタンスを作成します。 integration Services Project1 にはパッケージが含まれています。 例では catalog.set_execution_parameter_value を呼び出して、Parameter1、Parameter2、および LOGGING_LEVEL の各パラメーターの値を設定します。 例では catalog.start_execution を呼び出して、実行のインスタンスを起動します。
Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null
Select @execution_id
DECLARE @var0 sql_variant = N'Child1.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0
DECLARE @var1 sql_variant = N'Child2.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1
DECLARE @var2 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO
リターン コード値
0 (成功)
結果セット
なし
権限
このストアド プロシージャには、次の権限のいずれかが必要です。
プロジェクトの READ および EXECUTE 実行権限と、該当する場合は、参照先の環境での READ 権限
ssis_admin データベース ロールのメンバーシップ
sysadmin サーバー ロールのメンバーシップ
エラーおよび警告
エラーまたは警告が発生する可能性がある条件を以下に示します。
パッケージがありません。
ユーザーに適切な権限がない
環境参照 reference_id が無効。
指定したパッケージが、エントリ ポイントのパッケージではない。
参照先の環境変数のデータ型が、プロジェクトまたはパッケージ パラメーターのデータ型と異なる。
プロジェクトまたはパッケージに、値が必要なパラメーターが含まれているが、値が割り当てられていない。
参照先の環境変数が、環境参照 reference_id で指定された環境にない。