スクリプト コンポーネントでのイベントの発生

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

イベントは、エラーや警告、タスクの進行状況や状態などのその他の情報を、親パッケージにレポートする方法を提供するものです。 パッケージには、イベントの通知機能を管理するためのイベント ハンドラーがあります。 スクリプト コンポーネントは、ScriptMain クラスの ComponentMetaData プロパティに対してメソッドを呼び出して、イベントを発生させることができます。 Integration Services パッケージのイベントの処理の詳細については、「Integration Services (SSIS) のイベント ハンドラー」を参照してください。

イベントは、パッケージ内で有効な任意のログ プロバイダーに記録できます。 ログ プロバイダーは、イベントに関する情報をデータ ストアに保存します。 スクリプト コンポーネントは、イベントを発生させずに Log メソッドを使用して、情報をログ プロバイダーに記録することもできます。 Log メソッドの使用方法の詳細については、次のセクションを参照してください。

イベントを発生させるには、スクリプト コンポーネントは IDTSComponentMetaData100 プロパティによって公開される、ComponentMetaData インターフェイスの次のメソッドのいずれかを呼び出します。

Event	説明
FireCustomEvent	パッケージ内でユーザー定義のカスタム イベントを発生させます。
FireError	パッケージにエラー条件を通知します。
FireInformation	ユーザーに情報を提供します。
FireProgress	コンポーネントの進行状況をパッケージに通知します。
FireWarning	エラー条件ではないが、コンポーネントがユーザーに通知する必要がある状態であることをパッケージに通知します。

エラー イベントを発生させる簡単な例を次に示します。

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

参照

Integration Services (SSIS) のイベント ハンドラー
パッケージにイベント ハンドラーを追加する