Teradata FastLoad /通知出口ルーチン インターフェース - FastLoad

Teradata® FastLoad リファレンス

Product
FastLoad
Release Number
17.00
Published
2020年6月
Language
日本語
Last Update
2021-01-07
dita:mapPath
ja-JP/ije1544831946874.ditamap
dita:ditavalPath
ja-JP/ije1544831946874.ditaval
dita:id
B035-2411
Product Category
Teradata Tools and Utilities
Teradata FastLoadは、Teradata FastLoadジョブの実行中に発生した特定のイベントに関する操作情報を蓄積しています。Teradata FastLoadジョブ スクリプトに、EXITオプションが指定されたNOTIFYコマンドが含まれている場合、特定のイベントが発生した時点で、指定された通知出口ルーチンがTeradata FastLoadから呼び出され、以下の情報が渡されます。
  • イベントを識別するイベント コード
  • イベントに関する特定の情報

次の表 に、イベント コードの一覧と、各イベントでTeradata FastLoadが通知出口ルーチンに渡すデータの内容を示します。各通知レベル(低、中、高)に対応するイベントについては、NOTIFYを参照してください。

  • ユーザー出口(INMODと通知出口)は、Teradata Call-Level Interface (CLIv2)を呼び出すべきではありません。その場合は、ユーティリティの通常の動作が予期しない結果をもたらし、リクエストが正常に完了しないことがあります。
  • 将来の拡張をサポートするために、必ず、スクリプトの通知出口ルーチンが無効なイベント コードや未定義のイベント コードを無視すること、および通知出口ルーチンがTeradata FastLoadを異常終了させないことを確認してください。
  • Teradata Tools and Utilities 14.10のリリースから、Teradata FastLoadは8バイトの行カウンタをサポートしています。通知イベントで8バイトの行カウンタを表示するには、次の表で説明されているように64で新しいイベントを使用し、NOTIFYコマンドでEXITではなくキーワードEXIT64を使用します。
  • Teradata Tools and Utilities 14.10のリリースから、Teradata FastLoadはEON機能をサポートします。通知イベントでラージ オブジェクト名を表示するには、表18で説明されているようにEONで新しいイベントを使用し、NOTIFYコマンドでEXITではなくキーワードEXITEON を使用します。キーワードEXITEONはキーワードEXIT64を自動的にサポートします。
通知出口ルーチンに引き渡されるイベント
イベント コード イベント イベントの説明 通知出口ルーチンに渡されるデータ
0 初期化 NOTIFYコマンドが正常に処理された。
  • バージョンID長 - 4バイト符号なし整数
  • バージョンIDの文字列 – 最大32バイトの配列
  • ユーティリティID - 4バイト符号なし整数
  • ユーティリティ名長 - 4バイト符号なし整数
  • ユーティリティ名の文字列 – 最大32バイトの配列
  • ユーザー名長 - 4バイト符号なし整数
  • ユーザー名の文字列 – 最大64バイトの配列
  • オプション文字列の長さ - 4バイトの符号なし整数
  • オプション文字列 – 最大80バイトの配列
1 ファイルまたはINMODのオープン ファイルまたはINMODルーチン名を指定するDEFINEコマンドが正常に処理されました。
  • ユーティリティ名長 - 4バイト符号なし整数
  • ファイル名 – 最大256バイトの配列
2 フェーズ1の開始 表名がINSERT文によって指定された場合の、挿入フェーズの開始を意味します。
  • テーブル名の長さ - 4バイト符号なし整数
  • 表名 – 最大128バイトの配列
  • データベース名 – 最大62バイトの配列
3 チェックポイント 再始動ログ表にチェックポイント情報が書き込まれた。
  • レコード番号 — 4バイトの符号なし整数
4 フェーズ1の終了 挿入フェーズの終了後、CHECKPOINT LOADING END要求が正常終了しました。
  • 読み取られたレコード数 - 4バイトの符号なし整数
  • 省略されたレコード数 - 4バイトの符号なし整数
  • 拒否されたレコード数 - 4バイトの符号なし整数
  • データベースに送信されたレコード — 4バイトの符号無し整数
5 フェーズ2の開始 END LOADINGコマンドがデータベースに送られる直前である。 「フェーズ2の開始」イベントにはデータが付随しません。
6 フェーズ2の終了 END LOADINGコマンドの処理が正常終了しました。
  • ロードされたレコード - 4バイトの符号無し整数
7 エラー テーブル1 最初のエラー表について、SEL COUNT(*)要求の処理が正常終了しました。
  • 行数 - 4バイトの符号なし整数
8 Error Table 2(エラー テーブル2) 2番目のエラー表について、SEL COUNT(*)要求の処理が正常終了しました。
  • 行数 - 4バイトの符号なし整数
9 データベース再起動 Teradata FastLoadがデータベースまたはCLIv2からクラッシュ メッセージを受け取りました。 データベース再始動イベント コードにはデータが付随しません。
10 CLIv2エラー Teradata FastLoadがCLIv2エラーを受け取りました。
  • エラー コード - 4バイトの符号なし整数
11 データベース エラー Teradata FastLoadが、終了コード12を生成するデータベース エラーを受け取りました。
すべてのデータベース エラーが、このイベントを発生させるわけではありません。例えば、表を削除または作成しようとした際のエラー3807では、Teradata FastLoadは終了しません。
  • エラー コード - 4バイトの符号なし整数
12 終了 FastLoadが終了しようとしている。
  • 終了コード - 4バイトの符号なし整数
13 チェックポイント64 再始動ログ表にチェックポイント情報が書き込まれた。
  • レコード番号 - 再始動ログ表に書き込まれた24バイト文字列
14 フェーズI終了64 挿入フェーズの終了後、CHECKPOINT LOADING END要求が正常終了しました。
  • 読み取られたレコード - 24バイト文字列
  • スキップされたレコード - 24バイト文字列
  • 拒否されたレコード - 24バイト文字列
  • データベースに送信されたレコード - 24バイト文字列
15 フェーズ2終了64 END LOADINGコマンドの処理が正常終了しました。
  • ロードされたレコード - 24バイト文字列
16 エラー表1 64 最初のエラー表について、SEL COUNT(*)要求の処理が正常終了しました。
  • ロー番号 - 24バイト文字列
17 エラー テーブル 2 64 2番目のエラー表について、SEL COUNT(*)要求の処理が正常終了しました。
  • ロー番号 - 24バイト文字列
18 初期化EON NOTIFYコマンドが正常に処理された。
  • バージョンID長 - 4バイト符号なし整数
  • バージョンIDの文字列 – 最大32バイトの配列
  • ユーティリティID - 4バイト符号なし整数
  • ユーティリティ名長 - 4バイト符号なし整数
  • ユーティリティ名の文字列 – 最大32バイトの配列
  • ユーザー名長 - 4バイト符号なし整数
  • ユーザー名の文字列 – バイト ポインタ
  • オプション文字列の長さ - 4バイトの符号なし整数
  • オプション文字列 – 最大80バイトの配列
19 フェーズ1の開始EON 表名がINSERT文によって指定された場合の、挿入フェーズの開始を意味します。
  • テーブル名の長さ - 4バイト符号なし整数
  • 表名 - 文字ポインタ
  • データベース名 - 文字ポインタ