INFO EXTRACT

INFO EXTRACTでは、次の情報を表示します。

Extractのステータス(STARTING、RUNNING、STOPPEDまたはABENDED)。STARTINGは、プロセスが起動したが、まだ処理のためにチェックポイント・ファイルをロックしていないことを意味します。
おおよそのExtractラグ。
チェックポイント情報。
プロセス実行履歴。
Extractの書込み先となるトレイル。
統合Extractを対象とするアップグレードまたはダウングレードのステータス

構文

INFO EXTRACT group_name
[, SHOWCH [checkpoint_number]]
[, DETAIL]
[, TASKS | ALLPROCESSES]
[, UPGRADE | DOWNGRADE]
[, CONTAINERS]

group_name

Extractグループまたはワイルドカード(*) (複数のグループを指定する場合)。たとえば、T*と指定すると、名前がTから始まるすべてのExtractグループの情報が表示されます。指定したExtractグループ名に登録されているPDBをリストできます。

SHOWCH [checkpoint_number]

基本コマンドでは、現在のExtractチェックポイントに関する情報が表示されます。Extractのチェックポイント位置は、データ・ソースの読取りチェックポイントとトレイルの書込みチェックポイントで構成されます。トレイル・タイプEXTTRAILにも注意してください。

オプションで、checkpoint_numberの値を指定して、指定した数の以前のチェックポイントと現在のエンドポイントを含めます。

ノート:出力に不規則なインデントやスペースが不規則に表示されることがあります。これは通常の動作で、情報の正確性には影響ありません。

各プロセスが作成するチェックポイントのタイプと表示に含まれる内部メタデータ・エントリの説明などは、「チェックポイントについて」を参照してください。

DETAIL

次を表示します:

Extractの実行履歴(時間として表されるデータ・ソースの開始ポイントと停止ポイントを含む)。
Extractの書込み先となるトレイル。

TASKS

Extractタスクのみを表示します。ワイルドカード引数で指定したタスクは、INFO EXTRACTでは表示されません。

ALLPROCESSES

タスクを含め、すべてのExtractグループを表示します。

UPGRADE | DOWNGRADE

Oracle Databaseでのみ有効です。

UPGRADEは、Extractをクラシック取得モードから統合取得モードにアップグレードできるかどうかを示します。
DOWNGRADEは、Extractを統合取得モードからクラシック取得モードにダウングレードできるかどうかを示します。

Extractをアップグレードまたはダウングレードできない場合、その理由が表示されます。

ワイルドカードを使用したExtract名は、このオプションでは許可されません。

このコマンドを使用する前に、DBLOGINコマンドを発行します。

CONTAINERS

指定したExtractグループに登録されているPDBをリストします。ただし、非CDBモードで実行されている場合またはExtractグループが存在しない場合、コマンドはエラーになります。このオプションの使用前に、DBLOGINコマンドを発行してください。

INFO EXTRACTを発行すると、Extractは実行中または停止になります。実行中のプロセスの場合、RUNNINGのステータスは次のいずれかです:

Active: 実行中で、データを処理中(または処理可能)です。これは、プロセスが起動した後の通常の状態です。
一時停止: プロセスは実行中ですが、EVENTACTIONS SUSPENDアクションにより一時停止しました。一時停止状態の場合、プロセスはアクティブで、データを処理することはできませんが、現在の実行状態は保持されているため、SEND EXTRACTコマンドをRESUMEオプション付きで発行することで継続できます。INFOコマンドでのRBAは、一時停止アクションの前の最新のチェックポイント位置を表します。状態がアクティブか一時停止かを確認するには、SEND EXTRACTコマンドをSTATUSオプションとともに発行します。

基本コマンドでは、オンラインの(継続的) Extractプロセスの情報のみが表示されます。タスクは除外されます。

ノート:接続文字列に複数のホストが含まれているが、一部のホストがアクセス可能である間はアクセスできない場合、INFO EXTRACTコマンドはプロセス・ステータスの取得に失敗します。このような場合にプロセス・ステータスを確認するには、到達可能なホストのみを含む別のaliasを作成する必要があります。

A bout E xtract L ag

INFO EXTRACT出力のCheckpoint Lagフィールドは、最新のチェックポイントがトレイルに書き込まれた時点での遅延(秒)を表します。たとえば、次が当てはまる場合:

現在の時間 = 15:00:00
最終チェックポイント = 14:59:00
処理された最終レコードのタイムスタンプ = 14:58:00

このとき、ラグは00:01:00 (14:58と14:59の差である1分)としてレポートされます。

UNKNOWNというラグ値は、プロセスは実行中であるがまだレコードを処理していないこと、または(タイムゾーンの違いなくクロックに不具足があるため)ソース・システムのクロックがターゲット・システムのクロックより進んでいることを示します。LAG EXTRACTを参照してください。より正確なラグを計算したり、ラグ全体を確認したりするには、ハートビート表を使用します。ADD HEARTBEATTABLEを参照してください。

例

INFO EXTRACT ext*, SHOWCH

INFO EXTRACT *, TASKS

INFO EXTRACT exte UPGRADE

次の例は、Admin ClientからINFO EXTRACTコマンドを使用する方法を示しています。

INFO EXTRACT exte

EXTRACT    exte  Initialized   2019-11-20 23:22   Status STOPPED
Checkpoint Lag       00:00:00 (updated 00:00:09 ago)
Log Read Checkpoint  Oracle Redo Logs
                     2019-11-20 23:22:54  Seqno 0, RBA 0
                     SCN 0.0 (0)
Auto Start           Delay:   0
Encryption Profile   LocalWallet

次の例は、PostgreSQLでDBLOGINを使用したコマンド出力を示しています。

EXTRACT extw
Last Started 2020-07-01 01:40 Status RUNNING
Checkpoint Lag 00:00:00 (updated 00:00:09 ago)
Process ID 101094
VAM Read Checkpoint 2020-07-01 01:40:15.170802

Replication Slot edf_tc1_2c59ae112747afa1 is active with PID 101120 in database postgres
Slot Restart LSN 1/B982ED98
Slot Flush LSN 1/B982ED98
Current Log Position 1/B982EDD0

次の例は、PostgreSQLでDBLOGINを使用しなかった場合のコマンド出力を示しています。

EXTRACT extw Last Started 2020-07-01 01:40 Status RUNNING
Checkpoint Lag 00:00:00 (updated 00:00:04 ago)
Process ID 101094
VAM Read Checkpoint 2020-07-01 01:44:16.045693
LSN: 1/B99B7E60
Replication Slot Unavailable(requires DBLOGIN)
Slot Restart LSN Unavailable(requires DBLOGIN)
Slot Flush LSN Unavailable(requires DBLOGIN)
Current Log Position Unavailable(requires DBLOGIN)