Integration Services のイベント ハンドラ

実行可能ファイル (パッケージ、Foreach ループ コンテナ、For ループ コンテナ、シーケンス コンテナ、およびタスク ホスト コンテナ) は実行時にイベントを発生させます。たとえば、エラーが発生すると、OnError イベントが発生します。これらのイベントに対してカスタム イベント ハンドラを作成し、パッケージ機能を拡張すると、実行時のパッケージを容易に管理できます。イベント ハンドラは、次のタスクを実行できます。

• パッケージまたはタスクの実行が完了したとき、一時データ ストレージをクリーンアップします。

• システム情報を取得して、パッケージを実行する前にリソースの可用性を評価します。

• 参照テーブル内の参照が失敗したとき、テーブル内のデータを更新します。

• エラーまたは警告が発生したとき、またはタスクが失敗したときに、電子メール メッセージを送信します。

イベントにイベント ハンドラがない場合、パッケージのコンテナ階層で上位にあたる次のコンテナでイベントが発生します。このコンテナにイベント ハンドラがある場合、イベントに応答してイベント ハンドラが実行されます。イベント ハンドラがない場合、コンテナ階層で上位にあたる次のコンテナでイベントが発生します。

次の図は、1 つの SQL 実行タスクを含む For ループ コンテナを持つ、簡単なパッケージを示しています。

OnError イベントに対するイベント ハンドラを持つのは、パッケージのみです。SQL 実行タスクの実行時にエラーが発生した場合、パッケージの OnError イベント ハンドラが実行されます。次の図は、パッケージの OnError イベント ハンドラにより実行される呼び出しの順序を示しています。

イベント ハンドラは、イベント ハンドラ コレクションのメンバであり、このコレクションはすべてのコンテナに含まれています。SSIS デザイナを使用してパッケージを作成すると、イベント ハンドラ コレクションのメンバは、SSIS デザイナの [パッケージ エクスプローラ] タブ上の [イベント ハンドラ] フォルダ内に表示されます。

イベント ハンドラのコンテナは、次の方法で構成できます。

• イベント ハンドラの名前と説明を指定します。

• イベント ハンドラを実行するかどうか、イベント ハンドラが失敗した場合にパッケージが失敗するかどうか、イベント ハンドラが失敗するまでに発生するエラーの最大数を示します。

• 実行時にイベント ハンドラが返す実際の実行結果の代わりに、返される実行結果を指定します。

• イベント ハンドラのトランザクション オプションを指定します。

• イベント ハンドラが使用するログ モードを指定します。