ログ記録用のカスタム メッセージ
Integration Services には、パッケージや多くのタスクのログ エントリを書き込むための豊富なカスタム イベントが用意されています。記録したエントリを使用すれば、定義済みのイベントやユーザー定義メッセージを後の分析用に記録しておくことで、実行の進行状況、結果、および問題点に関する詳細を保管できます。たとえば、一括挿入の開始時刻と終了時刻を記録しておけば、パッケージ実行時のパフォーマンスの問題を特定できます。
カスタム ログ エントリとは、パッケージ、すべてのコンテナー、およびタスクに使用できる一連の標準的なログ記録イベントとは異なるエントリのセットです。カスタム ログ エントリは、パッケージ内の特定のタスクに関する有益な情報を取得するように調整されます。たとえば、SQL 実行タスクのカスタム ログ エントリの 1 つに、そのタスクで実行される SQL ステートメントをログに記録するものがあります。
すべてのログ エントリには、パッケージの開始時と終了時に自動的に書き込まれるログ エントリなど、日付と時刻に関する情報が含まれます。多くのログ イベントでは、ログに複数のエントリが書き込まれます。通常、イベントにいくつか異なるフェーズが含まれている場合に複数のエントリが書き込まれます。たとえば、ExecuteSQLExecutingQuery ログ イベントでは、3 つのエントリが書き込まれます。1 つ目はタスクがデータベースへの接続を取得した後、2 つ目は SQL ステートメントの準備が開始された後、3 つ目は SQL ステートメントの実行が完了した後に書き込まれます。
次の Integration Services オブジェクトには、カスタム ログ エントリがあります。
パッケージ
一括挿入タスク
データ フロー タスク
DTS 2000 実行タスク
プロセス実行タスク
SQL 実行タスク
ファイル システム タスク
FTP タスク
メッセージ キュー タスク
スクリプト タスク
メール送信タスク
データベース転送タスク
エラー メッセージ転送タスク
ジョブ転送タスク
ログイン転送タスク
Master ストアド プロシージャ転送タスク
SQL Server オブジェクトの転送タスク
Web サービス タスク
WMI データ リーダー タスク
WMI イベント監視タスク
XML タスク
ログ エントリ
パッケージ
次の表は、パッケージのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
PackageStart |
パッケージの実行が開始されたことを示します。 .gif "注意") 注
このログ エントリは自動的にログに書き込まれます。除外することはできません。
|
PackageEnd |
パッケージが完了したことを示します。 注
このログ エントリは自動的にログに書き込まれます。除外することはできません。
|
Diagnostic |
同時実行できる実行可能ファイル数など、パッケージの実行に影響するシステム構成に関する情報を提供します。 Diagnostic ログ エントリに、外部データ プロバイダーの呼び出し前後のエントリも含まれています。詳細については、「パッケージ実行のトラブルシューティング」を参照してください。 |
一括挿入タスク
次の表は、一括挿入タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
DTSBulkInsertTaskBegin |
一括挿入が開始されたことを示します。 |
DTSBulkInsertTaskEnd |
一括挿入が終了したことを示します。 |
DTSBulkInsertTaskInfos |
タスクに関する説明情報を提供します。 |
データ フロー タスク
次の表は、データ フロー タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
BufferSizeTuning |
データ フロー タスクでバッファーのサイズが変更されたことを示します。このログ エントリはサイズ変更の理由を説明し、一時的な新しいバッファー サイズを表示します。 |
OnPipelinePostEndOfRowset |
ProcessInput メソッドの最終呼び出しで設定される、行セットの終了シグナルがコンポーネントに通知されたことを示します。エントリは、データ フロー内で入力を処理するコンポーネントごとに書き込まれます。このエントリには、コンポーネント名が含まれます。 |
OnPipelinePostPrimeOutput |
コンポーネントが PrimeOutput メソッドの最終呼び出しを完了したことを示します。データ フローによっては、複数のログ エントリが書き込まれる場合があります。コンポーネントがソースの場合、コンポーネントが行の処理を完了したことを意味します。 |
OnPipelinePreEndOfRowset |
ProcessInput メソッドの最終呼び出しで設定される、行セットの終了シグナルがコンポーネントに通知されたことを示します。エントリは、データ フロー内で入力を処理するコンポーネントごとに書き込まれます。このエントリには、コンポーネント名が含まれます。 |
OnPipelinePrePrimeOutput |
コンポーネントに、PrimeOutput メソッドからの呼び出しが通知されたことを示します。データ フローによっては、複数のログ エントリが書き込まれる場合があります。 |
OnPipelineRowsSent |
ProcessInput メソッドの呼び出しによってコンポーネント入力に指定された行数を報告します。ログ エントリにはコンポーネント名が含まれます。 |
PipelineBufferLeak |
バッファー マネージャーの終了後もバッファーを保持しているコンポーネントに関する情報を提供します。つまり、バッファー リソースが解放されていないため、メモリ リークの原因になる可能性があります。このログ エントリは、コンポーネントの名前とバッファーの ID を含みます。 |
PipelineExecutionPlan |
データ フローの実行プランを報告します。バッファーをコンポーネントに送信する方法に関する情報を提供します。この情報は、PipelineExecutionTrees エントリと組み合わせて、タスク内での実行内容を示します。 |
PipelineExecutionTrees |
データ フロー内のレイアウトの実行ツリーを報告します。データ フロー エンジンのスケジューラは、このツリーを使用して、データ フローの実行プランを構築します。 |
PipelineInitialization |
タスクに関する初期化情報を提供します。この情報には、BLOB データの一時的な保存に使用するディレクトリ、既定のバッファー サイズ、およびバッファー内の行数が含まれます。データ フロー タスクの構成によっては、複数のログ エントリが書き込まれる場合があります。 |
DTS 2000 実行タスク
次の表は、DTS 2000 実行タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
ExecuteDTS80PackageTaskBegin |
タスクが DTS 2000 パッケージの実行を開始したことを示します。 |
ExecuteDTS80PackageTaskEnd |
タスクが終了したことを示します。 注
DTS 2000 パッケージは、タスク終了後も引き続き実行される場合があります。
|
ExecuteDTS80PackageTaskTaskInfo |
タスクに関する説明情報を提供します。 |
ExecuteDTS80PackageTaskTaskResult |
タスクで実行された DTS 2000 パッケージの実行結果を報告します。 |
プロセス実行タスク
次の表は、プロセス実行タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
ExecuteProcessExecutingProcess |
タスクで実行するように構成されている実行可能ファイルの実行プロセスに関する情報を提供します。 2 つのログ エントリが書き込まれます。1 つのエントリには、タスクで実行される実行可能ファイルの名前と場所が含まれ、もう 1 つのエントリは、実行可能ファイルの終了を記録します。 |
ExecuteProcessVariableRouting |
実行可能ファイルの入力と出力にルーティングされる変数に関する情報を提供します。ログ エントリは、stdin (入力)、stdout (出力)、および stderr (エラー出力) に書き込まれます。 |
SQL 実行タスク
次の表では、SQL 実行タスクのカスタム ログ エントリを説明します。
ログ エントリ |
説明 |
|---|---|
ExecuteSQLExecutingQuery |
SQL ステートメントの実行フェーズに関する情報を提供します。タスクがデータベースへの接続を取得したとき、SQL ステートメントの準備が開始されたとき、および SQL ステートメントの実行が完了した後に、ログ エントリが書き込まれます。準備フェーズのログ エントリには、タスクで使用される SQL ステートメントが含まれます。 |
ファイル システム タスク
次の表では、ファイル システム タスクのカスタム ログ エントリを説明します。
ログ エントリ |
説明 |
|---|---|
FileSystemOperation |
タスクで実行される操作を報告します。ログ エントリは、ファイル システム操作の開始時に書き込まれます。これには、操作の基になるファイルと操作対象のファイルに関する情報が含まれます。 |
FTP タスク
次の表は、FTP タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
FTPConnectingToServer |
タスクで FTP サーバーへの接続が開始されたことを示します。 |
FTPOperation |
タスクで実行された FTP 操作の開始および種類を報告します。 |
メッセージ キュー タスク
次の表は、メッセージ キュー タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
MSMQAfterOpen |
タスクで開いていたメッセージ キューを終了したことを示します。 |
MSMQBeforeOpen |
タスクがメッセージ キューを開く操作を開始したことを示します。 |
MSMQBeginReceive |
タスクがメッセージの受信を開始したことを示します。 |
MSMQBeginSend |
タスクがメッセージの送信を開始したことを示します。 |
MSMQEndReceive |
タスクがメッセージの受信を終了したことを示します。 |
MSMQEndSend |
タスクがメッセージの送信を終了したことを示します。 |
MSMQTaskInfo |
タスクに関する説明を提供します。 |
MSMQTaskTimeOut |
タスクがタイムアウトしたことを示します。 |
スクリプト タスク
次の表では、スクリプト タスクのカスタム ログ エントリを説明します。
ログ エントリ |
説明 |
|---|---|
ScriptTaskLogEntry |
スクリプト内でのログ記録の実装結果を報告します。ログ エントリは、Dts オブジェクトの Log メソッドを呼び出すたびに書き込まれます。このエントリは、コードの実行時に書き込まれます。詳細については、「スクリプト タスクでのログ記録」を参照してください。 |
メール送信タスク
次の表は、メール送信タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
SendMailTaskBegin |
タスクが電子メール メッセージの送信を開始したことを示します。 |
SendMailTaskEnd |
タスクが電子メール メッセージの送信を終了したことを示します。 |
SendMailTaskInfo |
タスクに関する説明情報を提供します。 |
データベース転送タスク
次の表は、データベース転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
SourceDB |
タスクでコピーされたデータベースを示します。 |
SourceSQLServer |
データベースのコピー元のコンピューターを示します。 |
エラー メッセージ転送タスク
次の表は、エラー メッセージ転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
TransferErrorMessagesTaskFinishedTransferringObjects |
タスクがエラー メッセージの転送を終了したことを示します。 |
TransferErrorMessagesTaskStartTransferringObjects |
タスクがエラー メッセージの転送を開始したことを示します。 |
ジョブ転送タスク
次の表は、ジョブ転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
TransferJobsTaskFinishedTransferringObjects |
タスクが SQL Server エージェント ジョブの転送を終了したことを示します。 |
TransferJobsTaskStartTransferringObjects |
タスクが SQL Server エージェント ジョブの転送を開始したことを示します。 |
ログイン転送タスク
次の表は、ログイン転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
TransferLoginsTaskFinishedTransferringObjects |
タスクがログインの転送を終了したことを示します。 |
TransferLoginsTaskStartTransferringObjects |
タスクがログインの転送を開始したことを示します。 |
Master ストアド プロシージャ転送タスク
次の表は、Master ストアド プロシージャ転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
TransferStoredProceduresTaskFinishedTransferringObjects |
master データベースに格納されている、ユーザー定義ストアド プロシージャの転送をタスクが完了したことを示します。 |
TransferStoredProceduresTaskStartTransferringObjects |
master データベースに格納されている、ユーザー定義ストアド プロシージャの転送をタスクが開始したことを示します。 |
SQL Server オブジェクトの転送タスク
次の表は、SQL Server オブジェクトの転送タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
TransferSqlServerObjectsTaskFinishedTransferringObjects |
タスクが SQL Server データベース オブジェクトの転送を終了したことを示します。 |
TransferSqlServerObjectsTaskStartTransferringObjects |
タスクが SQL Server データベース オブジェクトの転送を開始したことを示します。 |
Web サービス タスク
次の表は、Web サービス タスクに対して有効にできるカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
WSTaskBegin |
タスクが Web サービスへのアクセスを開始しました。 |
WSTaskEnd |
タスクが Web サービス メソッドを完了しました。 |
WSTaskInfo |
タスクに関する説明情報を提供します。 |
WMI データ リーダー タスク
次の表は、WMI データ リーダー タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
WMIDataReaderGettingWMIData |
タスクが WMI データの読み取りを開始したことを示します。 |
WMIDataReaderOperation |
タスクで実行された WQL クエリを報告します。 |
WMI イベント監視タスク
次の表は、WMI イベント監視タスクのカスタム ログ エントリの一覧です。
ログ エントリ |
説明 |
|---|---|
WMIEventWatcherEventOccurred |
タスクが監視しているイベントが発生したことを示します。 |
WMIEventWatcherTimedout |
タスクがタイムアウトしたことを示します。 |
WMIEventWatcherWatchingForWMIEvents |
タスクが WQL クエリの実行を開始したことを示します。このエントリには、クエリが含まれています。 |
XML タスク
次の表では、XML タスクのカスタム ログ エントリを説明します。
ログ エントリ |
説明 |
|---|---|
XMLOperation |
タスクで実行される操作に関する情報を提供します。 |
|
.gif "Integration Services のアイコン (小)")
最新の Integration Services の入手