次の方法で共有

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 タスクによってログに記録されるイベントを含みます。 詳細については、「ログ記録用のカスタム メッセージ」を参照してください。

パッケージの実行中にエラーが発生した場合に、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 データベース)

概念

パッケージ実行用のダンプ ファイルを生成する