パッケージへのログ機能の実装

更新 : 2007 年 9 月 15 日

SQL Server 2005 Integration Services (SSIS) には、実行時イベントが発生するときにログ エントリを書き込み、カスタム メッセージも書き込むことができるログ機能があります。

Integration Services では各種ログ プロバイダをサポートしており、カスタム ログ プロバイダを作成する機能もあります。Integration Services ログ プロバイダでは、ログ エントリをテキスト ファイル、SQL Server Profiler、SQL Server、Windows イベント ログ、または XML ファイルに書き込むことができます。

ログはパッケージに関連付けられ、パッケージ レベルで設定します。パッケージ内の各タスクやコンテナによって、パッケージのログに情報を書き込むこともできます。パッケージのログ機能が有効にされていない場合でも、そのパッケージに含まれるタスクやコンテナのログ機能を有効にできます。たとえば、親パッケージのログ機能を有効にしなくても、SQL 実行タスクのログ機能を有効にできます。パッケージ、コンテナ、およびタスクは、複数のログに対して書き込みが可能です。パッケージにのみログ機能を有効にできます。または、そのパッケージに含まれる任意の個別のタスクまたはコンテナを選択して、ログ機能を有効にできます。

イベント メッセージまたはカスタム メッセージのログ機能をカスタマイズするために、Integration Services には、ログ エントリに通常書き込まれる情報のスキーマが用意されています。Integration Services のログ スキーマは、ログ記録できる情報を定義します。ログ エントリごとにログ スキーマから要素を選択します。

パッケージおよびパッケージ内のコンテナやタスクが、同じ情報をログ記録する必要はありません。また、同一パッケージやコンテナのタスクが別々の情報をログ記録することができます。たとえば、パッケージではパッケージが開始されたときにオペレータに関する情報をログに書き込み、あるタスクではタスク失敗の原因を書き込み、別のタスクではエラー発生時に情報を書き込むという処理が可能です。パッケージおよびパッケージ内のコンテナやタスクが複数のログを使用する場合、同じ情報がすべてのログに書き込まれます。

ログ記録するイベントと各イベントに対して書き込む情報を指定して、必要に応じたログ記録のレベルを選択できます。これにより、他のイベントに比べて有益な情報が得られるイベントがわかります。たとえば、PreExecute イベントについてはコンピュータ名とオペレータ名のみをログ記録し、Error イベントについては利用可能なすべての情報を記録すると良いでしょう。

ログ ファイルがディスク領域を大量に消費したり、過剰にログが記録されたりするとパフォーマンスが低下します。これを防止するため、特定のイベントとログ記録する情報項目を選択して、ログ記録を制限することができます。たとえば、エラーが発生した日付とコンピュータ名のみを記録するようにログを設定できます。

SSIS デザイナの [SSIS ログの構成] ダイアログ ボックスを使用して、ログ オプションを定義できます。

ログ スキーマ

次の表に、ログ スキーマの要素を示します。

要素 説明

Computer

ログ イベントが発生したコンピュータの名前。

Operator

パッケージを起動したユーザーの ID。

SourceName

ログ イベントが発生したコンテナまたはタスクの名前。

SourceID

ログ イベントが発生したパッケージ、For ループ コンテナ、Foreach ループ コンテナ、シーケンス コンテナ、またはタスクの一意識別子。

ExecutionID

パッケージ実行インスタンスの GUID。

MessageText

ログ エントリに関連付けられるメッセージ。

DataBytes

ログ エントリ固有のバイト配列。このフィールドの意味は、ログ エントリによって異なります。

次の 3 つのログ スキーマ要素は、[SSIS ログの構成] ダイアログ ボックスの [詳細] タブには表示されません。

要素 説明

StartTime

コンテナまたはタスクが実行を開始した時刻。

EndTime

コンテナまたはタスクが実行を終了した時刻。

DataCode

オプションの整数値。コンテナまたはタスクの実行結果を示す DTSExecResult 列挙体のいずれかの値を表します。

  • 0 = 成功
  • 1 = 失敗
  • 2 = 完了
  • 3 = キャンセル

ログ エントリ

Integration Services では、あらかじめ定義されたイベントのログ エントリをサポートし、多くの Integration Services オブジェクトにカスタム ログ エントリを提供します。SSIS デザイナの [SSIS ログの構成] ダイアログ ボックスに、これらのイベントとカスタム ログ エントリが一覧表示されます。

次の表に、実行時イベント発生時にログ エントリを書き込むために有効にできる、あらかじめ定義されたイベントを示します。これらのログ エントリは、実行可能ファイル、パッケージ、そのパッケージに含まれるタスクおよびコンテナに適用されます。ログ エントリ名は、ログ エントリが書き込まれる原因となった、発生実行時イベントの名前と同じです。

イベント 説明

OnError

エラー発生時にログ エントリを書き込みます。

OnExecStatusChanged

実行可能ファイルの実行状態が変化したときにログ エントリを書き込みます。

OnInformation

実行可能ファイルの検証および実行中に、情報を報告するログ エントリを書き込みます。

OnPostExecute

実行可能ファイルの実行が終了した直後にログ エントリを書き込みます。

OnPostValidate

実行可能ファイルの検証が終了したときにログ エントリを書き込みます。

OnPreExecute

実行可能ファイルの実行直前にログ エントリを書き込みます。

OnPreValidate

実行可能ファイルの検証が開始される前にログ エントリを書き込みます。

OnProgress

実行可能ファイルの処理で測定可能な進捗があったときにログ エントリを書き込みます。

OnQueryCancel

タスク処理中に、実行のキャンセルが可能な時点に達したときにログ エントリを書き込みます。

OnTaskFailed

タスクが失敗したときにログ エントリを書き込みます。

OnVariableValueChanged

変数の値が変更されたときにログ エントリを書き込みます。

OnWarning

警告が発生したときにログ エントリを書き込みます。

パッケージおよび多くのタスクには、ログ機能を有効にできるカスタム ログ エントリがあります。たとえば、メール送信タスクには SendMailTaskBegin カスタム ログ エントリがあります。これを使用すると、電子メール メッセージの送信前に、メール送信タスクの実行開始時の情報をログに書き込むことができます。詳細については、「ログ記録用のカスタム メッセージ」を参照してください。

パッケージのコピーの区別

ログ データには、ログ エントリが属しているパッケージの名前と GUID が含まれます。既存のパッケージをコピーして新しいパッケージを作成する場合、既存のパッケージの名前と GUID もコピーされます。したがって、同じ GUID と名前が付いたパッケージが 2 つになり、ログ データ内のパッケージの区別が困難になります。

このようなあいまいさを回避するには、新しいパッケージの名前と GUID を更新する必要があります。Business Intelligence Development Studio のプロパティ ウィンドウで、ID プロパティの GUID を再生成し、Name の値を更新できます。プログラムから、または dtutil コマンド プロンプトを使用して、GUID と名前を変更することもできます。詳細については、「パッケージのプロパティの設定」および「dtutil ユーティリティ」を参照してください。

親のログ オプション

一般的に、タスク、For ループ コンテナ、Foreach ループ コンテナ、シーケンス コンテナのログ オプションは、それらが含まれているパッケージや親コンテナのログ オプションと同じです。この場合、親コンテナからログ オプションを継承するように設定できます。たとえば、SQL 実行タスクが含まれている For ループ コンテナがある場合、SQL 実行タスクでは For ループ コンテナに設定されたログ オプションを使用できます。親のログ オプションを使用するには、コンテナの LoggingMode プロパティを UseParentSetting に設定します。このプロパティは、Business Intelligence Development Studio の [プロパティ] ウィンドウ、または SSIS デザイナの [SSIS ログの構成] ダイアログ ボックスで設定できます。

ログのテンプレート

[SSIS ログの構成] ダイアログ ボックスでは、頻繁に使用するログ構成をテンプレートとして作成および保存して、複数のパッケージでそのテンプレート使用できます。これにより、複数のパッケージで一貫したログ記録の方法を簡単に使用でき、テンプレートを更新して適用することによって簡単にパッケージのログ設定を修正できます。テンプレートは XML ファイルとして格納されます。

[SSIS ログの構成] ダイアログ ボックスを使用してログ機能を設定するには

  1. パッケージおよびタスクのログ記録を有効にします。ログは、パッケージ レベル、コンテナ レベル、またはタスク レベルで記録できます。パッケージ、コンテナ、タスクに対して、それぞれ異なるログを指定できます。

  2. ログ プロバイダを選択して、パッケージのログを追加します。ログはパッケージ レベルでのみ作成可能で、タスクやコンテナではパッケージで作成されたログのいずれかを使用します。各ログは、テキスト ファイル、SQL Server Profiler、SQL Server、Windows のイベント ログ、または XML ファイルのいずれかのログ プロバイダに関連付けられます。詳細については、「パッケージ内でのログ記録を有効にする方法」を参照してください。

  3. ログに取り込むイベントと、各イベントのログ スキーマ情報を選択します。詳細については、「コンテナ内でのログ記録を構成する方法」を参照してください。

パッケージの開発中にログ エントリを表示するには

参照

概念

Integration Services ログ プロバイダ

その他の技術情報

SSIS デザイナでのパッケージの作成

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2007 年 9 月 15 日

新しい内容 :
  • [詳細] タブに表示されないログ スキーマ要素の一覧表を追加しました。

2005 年 12 月 5 日

新しい内容 :
  • ログ エントリのログ スキーマとカスタム メッセージについての情報を追加しました。
  • パッケージのコピーを区別する方法の説明を追加しました。
変更した内容 :
  • パッケージ レベルのログ記録と個別のオブジェクトでのログ記録の説明を拡張しました。