トレースの設定
ジョブが実行されると、各ステップに関する情報を示すトレースログが生成されます。
表示される詳細のレベルは、ジョブまたは実行プロパティで設定できる一部のオプションによって異なります。
利用可能なトレースオプションの一部を以下に示します。
| Trace | 内容説明 |
|---|---|
| ローテーブル | トランスフォームが行をインポートまたはエクスポートするときにメッセージを書き込みます。 |
| ワークフロー | ワークフローの説明がリポジトリから読み込まれるとき、ワークフローが最適化されるとき、ワークフローが実行されるとき、およびワークフローが終了したときに、メッセージを書き込みます。 |
| データフロー | データフローの開始時、およびデータフローが正常に終了したとき、またはエラーが原因でデータフローが終了したときに、メッセージを書き込みます。 |
| トランスフォーム | トランスフォームの開始時および終了時にメッセージを書き込みます。 |
| SQL リーダ | スクリプト、Query トランスフォーム、または SQL 関数がシステムに送信し、SQL 結果を書き込む SQL クエリブロックを書き込みます。 |
| テーブル | テーブルの作成または削除時にメッセージを書き込みます。 |
| スクリプトおよびスクリプト関数 | スクリプトが呼び出され、スクリプトによって関数が呼び出され、スクリプトが正常に完了したときにメッセージを書き込みます。 |
| 並列実行のトレース | データフロー内のデータの並列処理方法を記述したメッセージを書き込みます。 |
| ストアドプロシージャ | ストアドプロシージャの開始時と終了時にメッセージを書き込み、キー値を含めます。 |
| 監査データ | 監査ポイントで統計を収集し、監査ルールが合格または不合格かどうかを決定するメッセージを書き込みます。 |
ジョブ実行プロパティでのトレースの設定
- ログに書き込まれる情報を決定します。
- 一時的に実行することも (実行プロパティ)、永続的に実行することもできます (ジョブのプロパティ)。
- 行ごとに 1 つのトレースまたはトレースを生成できます (トレース行、SQL... など)。
ジョブが開始されたら、トレース、モニタ、およびエラーアイコンを選択して、ジョブ実行中に登録されるログファイルを表示することができます。
トレースの設定方法を説明します。
トレースログの検証
以下の図に示すように、トレースログを使用して、実行が失敗した場所、実行ステップが予想される順序で発生するかどうか、および実行のどの部分が最も時間がかかるかを判断します。
監視ログとエラーログの調査
モニタログを使用して、この他の図に示すように、ジョブのコンポーネントのアクティビティを定量化します。ジョブの特定のコンポーネントで費やされた時間、およびそのコンポーネントを通じてストリームされたデータ行の数が一覧表示されます。
エラーログを使用して、実行が失敗した方法を判断します。実行がエラーなしで完了した場合、エラーログは空白になります。
ログファイル
ジョブが実行されると、Data Services によって 2 つまたは 3 つ (エラーの場合) のログファイルが生成されます。デフォルトでは、このログファイルはワークスペースに自動的に表示されるように設定されています。ただし、プロジェクト領域のモニタタブおよびログタブからも表示することができます。
Monitor タブの使用
モニタタブには、ジョブの現在または最新のすべての実行のトレースログが一覧表示されます。
モニタタブの停止信号アイコンは、以下のように読み込むことができます。
- 緑信号は、ジョブが実行中であることを示します。
右クリックして Kill Job を選択し、実行中のジョブを停止します。ジョブの強制終了を選択すると、ジョブのアイコンが黄色の三角形になり、中央に感嘆符が表示されます。
- 赤信号は、ジョブが停止したことを示します。
右クリックしてプロパティを選択し、特定のトレースログの内容説明を追加します。この内容説明はログとともに保存され、後でログタブからアクセスすることができます。
- 赤色の十字形は、ジョブでエラーが発生したことを示します。
ログタブの使用
ログタブを選択して、ジョブのログ履歴を表示します。
ジョブのログファイルを検索するには、次の手順に従います。
- ログを表示するジョブを選択します。
- ワークスペース、 + ドロップダウンリストで、表示するログのタイプを選択します。
- ログの一覧で、ログをダブルクリックして詳細を表示します。
- 開いているログからログコンテンツをコピーするには、1 つまたは複数の行を選択し、キーコマンド [CTRL+C ] を使用します。