INGEST GET STATS コマンド
INGEST GET STATS コマンドは、データベースに接続されている許可 ID によって実行されている 1 つ以上の INGEST コマンドに関する統計を表示します。 INGEST ユーティリティーは、同時に実行中の最大 128 の INGEST ジョブについての統計を維持します。
範囲
このコマンドを正常に呼び出すには、別の CLP セッションが必要です。 INGEST コマンドが実行されているのと同じマシンでこれを実行する必要があります。
許可
なし必要な接続
データベース。
構文
コマンド・パラメーター
- ALL | job-ID
- どの INGEST コマンドについて統計を表示するかを指定します。
ジョブ ID は、単一引用符で囲まれた完全ジョブ ID または INGEST LIST コマンドで表示された一時ジョブ ID のいずれかです。
- EVERY number SECONDS
- 表示される表に、何秒ごとに (number 秒) 新しい行を追加するかを指定します。
このパラメーターは、INGEST job-ID が指定されている場合 (ALL が指定されていないとき) に限り有効です。 このパラメーターが指定された場合に、コマンドを終了させる方法は、Ctrl+C を押すか、または CLP セッションを終了することだけです。 秒数の範囲は 1 から 86,400 までです。
- SHOW TOTALS
- INGEST 処理の各フェーズ (トランスポーター、フォーマッター、およびフラッシャー) に関する統計を表示することを指定します。 このパラメーターを省いた場合、コマンドはサマリー統計だけを表示します。
例
基本的な INGEST GET STATS コマンド出力の例
=> INGEST GET STATS FOR 4
Ingest job ID = DB21000:20101116.123456.234567:34567:4567
Database = MYDB
Target table = MY_SCHEMA.MY_TABLE1
Overall Overall Current Current
ingest rate write rate ingest rate write rate Total records
(records/second) (writes/second) (records/second) (writes/second)
---------------- --------------- --------------- ---------------- ----------------
54321 5432 76543 87654 98765
3 秒ごとに統計を提供する INGEST GET STATS コマンドの例
=> INGEST GET STATS FOR 4 EVERY 3 SECONDS
Ingest job ID = DB21000:20101116.123456.234567:34567:4567
Database = MYDB
Target table = MY_SCHEMA.MY_TABLE1
Overall Overall Current Current
ingest rate write rate ingest rate write rate Total records
(records/second) (writes/second) (records/second) (writes/second)
---------------- --------------- --------------- ---------------- ----------------
3333 65432 76543 87654 108765
3334 75432 86543 97654 118765
3335 85432 96543 107654 128765 ...
(new row appended every 3 seconds)
各フェーズの合計を示す INGEST GET STATS コマンドの例
=> INGEST GET STATS FOR 4 SHOW TOTALS
===================================================================
Ingest job ID = DB21000:20101116.123456.234567:34567:4567
Database = MYDB
Target table = MY_SCHEMA.MY_TABLE1
-------------------------------------------------------------------
Totals for all transporters
Since last query Since command start
------------------------- ----------------------------
Number of bytes read 90,000 180,000
Number of records read 3000 6000
Bytes per second 10,000 10,000
Records per second 1000 1000
-----------------------------------------------------------------------------------------
Totals for all formatters
Since last query Since command start
------------------------- ----------------------------
Number of records formatted 9000 18,000
Records per second 3000 3000
Number of records rejected 6 12
-----------------------------------------------------------------------------------------
Totals for all flushers
Since last query Since command start
------------------------- ----------------------------
Number of records flushed 12,000 24,000
Records per second 4000 4000
Number of records rejected 8 16
Number of reconnects 4 8
Number of retries 16 32
使用上の注意
多くの統計について、INGEST GET STATS コマンドは、前回の INGEST GET STATS コマンド (現行ウィンドウで発行されたもの) 以降、かつ INGEST コマンドの開始以降の統計を表示します。 上記のいくつかの例に示されているように、それらは出力内の異なる列に表示されます。
注: INGEST GET
STATS コマンド出力のフォーマットは、プログラミング・インターフェースと見なすことはできません。 IBM は、今後のフィックスパックまたはリリースでフォーマットを変更する権利を留保します。