catalog.set_execution_parameter_value (SSISDB データベース)
Integration Services カタログの実行のインスタンスにパラメーターの値を設定します。
実行インスタンス開始後は、パラメーターの値は変更できません。
構文
set_execution_parameter_value [ @execution_id = execution_id
, [ @object_type = ] object_type
, [ @parameter_name = ] parameter_name
, [ @parameter_value = ] parameter_value
引数
[ @execution\_id = ] execution_id
実行のインスタンスの一意の識別子。 execution_id は bigint 型です。[ @object\_type = ] object_type
パラメーターの種類。次のパラメーターでは、object_type を 50 に指定します。
LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZED
値 20 を使用するとプロジェクトのパラメーターを示し、値 30 を使用するとパッケージのパラメーターを示します。
object_type は smallint 型です。
[ @parameter\_name = ] parameter_name
パラメーターの名前。 parameter_name は nvarchar(128) 型です。[ @parameter\_value = ] parameter_value
パラメーターの値。 parameter_value は sql_variant 型です。
解説
特定の実行に使用されたパラメーター値を調べるには、catalog.execution_parameter_values ビューに対してクエリを実行します。
パッケージの実行中にログに記録される情報のスコープを指定するには、parameter_name を LOGGING_LEVEL に設定して、parameter_value を次のいずれかの値に設定します。
object_type パラメーターを 50 に設定します。
値 |
説明 |
---|---|
0 |
ありません ログ記録をオフにします。 パッケージの実行状態のみがログに記録されます。 |
1 |
基本 カスタム イベントと診断イベントを除く、すべてのイベントをログに記録します。 これは既定値です。 |
2 |
パフォーマンス パフォーマンス統計、および OnError イベントと OnWarning のイベントのみをログに記録します。 |
3 |
詳細 カスタム イベントと診断イベントを含む、すべてのイベントをログに記録されます。 |
パッケージの実行中にエラーが発生した場合に、Integration Services サーバーによりダンプ ファイルが生成されるように指定するには、未実行の実行インスタンスに次のパラメーター値を設定します。
パラメーター |
値 |
---|---|
execution_id |
実行のインスタンスの一意識別子 |
object_type |
50 |
parameter_name |
‘DUMP_ON_ERROR |
parameter_value |
1 |
パッケージの実行中にイベントが発生した場合に、Integration Services サーバーによりダンプ ファイルを生成されるように指定するには、未実行の実行インスタンスに次のパラメーター値を設定します。
パラメーター |
値 |
---|---|
execution_id |
実行のインスタンスの一意識別子 |
object_type |
50 |
parameter_name |
‘DUMP_ON_EVENT |
parameter_value |
1 |
パッケージの実行中に、Integration Services サーバーによるダンプ ファイルの生成が行われる原因となるイベントを指定するには、未実行の実行インスタンスに次のパラメーター値を設定します。 複数のイベント コードは、セミコロンで区切ります。
パラメーター |
値 |
---|---|
execution_id |
実行のインスタンスの一意識別子 |
object_type |
50 |
parameter_name |
DUMP_EVENT_CODE |
parameter_value |
1 つまたは複数のイベント コード |
使用例
次の例では、パッケージの実行中にエラーが発生した場合に、Integration Services サーバーによりダンプ ファイルが生成されるように指定しています。
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_ERROR',1
次の例では、パッケージの実行中にイベントが発生した場合に、Integration Services サーバーによりダンプ ファイルが生成されるように指定し、サーバーによるファイルの生成が行われる原因となるイベントを指定しています。
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_EVENT',1
declare @event_code nvarchar(50)
set @event_code = '0xC020801C'
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_EVENT_CODE', @event_code
リターン コード値
成功した場合は 0 を返します。
結果セット
なし
権限
このストアド プロシージャには、次の権限のいずれかが必要です。
実行のインスタンスの READ および MODIFY 権限
ssis_admin データベース ロールのメンバーシップ
sysadmin サーバー ロールのメンバーシップ
エラーおよび警告
エラーまたは警告が発生する可能性がある条件を以下に示します。
ユーザーに適切な権限がない
実行識別子が有効ではない
パラメーター名が無効
パラメーター値のデータ型が、パラメーターのデータ型と一致しない
関連項目
参照
catalog.execution_parameter_values (SSISDB データベース)