プロセス・レポートの使用

プロセス・レポートを使用して、(プロセスに応じて)次の情報を表示できます。

  • 使用中のパラメータ

  • 表および列マッピング

  • データベース情報

  • 実行時メッセージおよびエラー

  • 処理された操作の数に関する実行時統計

Extract、Replicatのすべてのプロセスで、レポート・ファイルが生成されます。このレポートは、実行中に発生した問題(無効なマッピング構文、SQLエラー、接続エラーなど)を診断する場合に役立ちます。

プロセス・レポートを表示するには、次のいずれかの方法を使用します。

  • 標準のシェル・コマンドによるテキスト・ファイルの表示

  • パフォーマンス・メトリック・サービス

  • VIEW REPORTコマンド。

  • プロセスがレポートを生成せずに異常終了した場合に情報を表示するには、次のコマンドを使用して、(Oracle GoldenGateコマンドラインでなく)オペレーティング・システムのコマンド・シェルからプロセスを実行し、端末に情報を送信します。

    process paramfile path.prm

    説明:

    • processの値は、extractまたはreplicatです。

    • path.prmの値は、パラメータ・ファイルの完全修飾名です。たとえば: 

      REPLICA PARAMFILE /ogg/dirdat/repora.prm

デフォルトでは、レポートのファイル拡張子は.rptです(EXTORA.rptなど)。デフォルトの場所は、Oracle GoldenGateディレクトリのdirrptサブディレクトリです。ただし、これらのプロパティは、グループを作成するときに変更できます。レポート・ファイルは、一度作成したら、処理の開始後にOracle GoldenGateを適切に動作させるため、元の場所から移動しないでください。

プロセス・レポートの名前と場所を確認するには、INFO EXTRACTまたはINFO REPLICATコマンドを使用します。

プロセス・レポートの実行時統計のスケジュール

デフォルトでは、実行時統計は、各実行の終了時に1回のみレポートに書き込まれます。長時間の実行や継続的な実行では、オプション・パラメータを使用することで、各実行の終了を待機せずにこれらの統計を定期的に表示できます。

実行時統計をレポートするスケジュールを設定するには、ExtractまたはReplicatのパラメータ・ファイルでREPORTパラメータを使用して、レポートで実行時統計を生成する日時を指定します。REPORTを参照してください。

レポートにオン・デマンドで実行時統計を送信するには、必要に応じてその時点の実行時統計を表示するREPORTオプションを付けてSEND EXTRACTまたはSEND REPLICATコマンドを実行します。

プロセス・レポートのレコード数の表示

REPORTCOUNTパラメータを使用して、ExtractまたはReplicatが起動後に処理したトランザクション・レコードの数をレポートします。各トランザクション・レコードは、Oracle GoldenGateによって取得されたトランザクション内で実行された論理データベース操作を表します。レコード数は、レポート・ファイルおよび画面に出力されます。

ReplicatレポートがSQLエラーで一杯になることを防止する方法

WARNRATEパラメータでは、プロセス・レポートおよびエラー・ログにレポートされるまでの、ターゲット表で許容されるSQLエラー数のしきい値を設定します。エラーは警告としてレポートされます。お使いの環境で、多数のエラーを許容できるときは、WARNRATEの値を増やすことによってこれらのファイルのサイズを最小限に抑えられます。