Vericom

6.2.1 Vericomツールの概要

vericomツールを使用して、オペレーティング・システムのコマンド・シェルから特定の比較ジョブを実行できます。vericomツールは Oracle GoldenGate Veridataコマンドライン・インタフェースを実行し、これらのアクティビティの自動化プログラムによって処理できるようにします。

次の操作を実行できます:

ジョブ全体、またはジョブ内の特定のグループ、またはグループとジョブの特定の比較ペアの実行。

特定の比較ペアの場合は、次のジョブを実行できます。

以前の非同期結果の確認
Webユーザー・インタフェースから可能な同じプロファイル設定および行パーティションの上書き

Oracle GoldenGate VeridataWebユーザー・インタフェースから比較を実行することもできます。このインタフェースは、比較するオブジェクトの構成およびランタイム・パラメータの設定制御に優れた機能を発揮します。

ノート:

Oracle GoldenGate Veridataのインストール中にWebのSSL / TLSセキュリティ・オプションが選択されている場合は、Vericomが機能するように、次の操作を実行します:

<VERIDATA_HOME>/config/vdtWebKeystore.p12を<VERIDATA_HOME>/cli/config/veridata-23c.p12にコピーします。

親トピック: Vericom

6.2.2 Vericomでサポートされているコマンド

Oracle GoldenGate Veridataでは、次のコマンドがサポートされています:

-u OR -user : veridataジョブを実行しているVeridataユーザー
-host: Veridata helidonのホスト名。デフォルトはlocalhostです
-port : Veridataサーバーのポート。オプションのパラメータ。渡されない場合、デフォルトのポートが使用されます
-j OR -job <jobname>: 実行するVeridataジョブ名
-j OR -job <jobname> -g OR -group <groupName>: 実行するジョブ内の特定のグループ
-j OR -job <jobname> -g OR -group <groupName> -c OR compare_pair <CPName>: 特定の比較ペアを実行する必要がある場合
-repair : 比較とともに修復を実行する必要がある場合
-p OR -profile <profileName>: 実行時にジョブ・プロファイルをオーバーライドします。
-pS : ソース・パーティション名(デフォルトのパーティション名を取ります)
-pS <source partition name>: 実行時にソースの手動行パーティションをオーバーライドします
-pT: ターゲット・パーティション名(デフォルトのパーティション名を取ります)
-pT <target partition name>: 実行時にターゲットの手動行パーティションをオーバーライドします
-delta : デルタを有効にして実行します。渡されない場合、すべての行がすべての実行で比較されます
-help: Vericomの使用方法を表示するためのパラメータ
-v : Veridataサーバーのバージョンの詳細が表示されます。
-monitorStats <runId>: このコマンドは、ジョブのステータスを監視します。入力としてrunIdを取ります。

例

Vericomを使用してジョブを実行する場合は、./vericom.sh -j <jobName>のようにジョブ・ステータスを表示する必要があります。
出力:
```
Run ID: (2258, 0, 0)
```

実行統計をフェッチするには、次のようにコマンドを実行します: ./vericom.sh -monitorStats <runId>:

出力:

Run ID: (2257, 0, 0) Job Start Time: 2008-03-21 22:48:05 Job Stop Time: 2008-03-21 22:48:20  Number of Compare Pairs: 3 Number of Compare Pairs With Errors: 0 Number of Compare Pairs With OOS: 1 Number of Compare Pairs With No OOS: 1 Number of Compare Pairs Cancelled: 0 Job Completion Status: SUCCESSFUL
RUN ID: <CP RUN ID> <CP Name> <Group Name>
RUN ID: <CP RUN ID> <CP Name> <Group Name>
RUN ID: <CP RUN ID> <CP Name> <Group Name> and so on.

比較ペアの詳細を表示するには、./vericom.sh -monitorStats <comparepair_runId>を実行します

出力

Run ID: (2257, 0, 0) Job Start Time: 2008-03-21 22:48:05 Job Stop Time: 2008-03-21 22:48:20  Number of Compare Pairs: 3 Number of Compare Pairs With Errors: 0 Number of Compare Pairs With OOS: 1 Number of Compare Pairs With No OOS: 1 Number of Compare Pairs Cancelled: 0 Job Completion Status: SUCCESSFUL
Compare Pair RUN ID:
Compare Pair Name:
Compare Pair ID:
Phase:
Status:
Total Rows Compared:
Rows In-sync:
Rows out-of-sync:
Compare-pair report:

ノート:

Vericomユーティリティは、ジョブ、グループまたは比較ペアの名前フィールドに$記号などの特殊文字が存在する場合に失敗します。この問題を解決するには、次のようにエスケープ文字を追加する必要があります:

実際の比較ペア名: \THOR.$DATA08.IRFASRC.EACCT=\THOR.$DATA08.IRFASRC.BACCT

エスケープ文字を使用: \THOR.\$DATA08.IRFASRC.EACCT=\THOR.\$DATA08.IRFASRC.BACCT

次のようにコマンドを実行します。

./vericom.sh -wluser veridata -j NskTest -g nskENscribeTesting -c \THOR.\$DATA08.IRFASRC.EACCT=\THOR.\$DATA08.IRFASRC.BACCT

親トピック: Vericom

6.2.3 Vericomの出力例

vericomツールを使用して実行する比較の結果を表示するには、Oracle GoldenGate Veridata Webユーザー・インタフェースを使用して比較レポートを表示します。ツールによって端末に返された出力を表示することもできます。実行が正常に終了すると、ジョブの統計が表示されます。

次の例では、TestJobジョブを使用します。

例1

この例は、Linuxシステムでの実行を示しています。プロセスはステータス0で終了し、終了済みジョブの統計は表示されません。

./vericom.sh -user veridata -port 8089 -job jobBetaBug
JAVA_HOME is set to: /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
Java version:17.0.8
[Enter user password:]
Veridata job submitted successfully!
Run ID: 325865/0/0
Execute ./vericom.sh -user <username> -monitorStats <runId> to fetch the run statistics.

例2

この例では、ジョブの実行IDから統計を取得する方法を示します。

/vericom.sh -user veridata -monitorStats 325865/0/0
JAVA_HOME is set to: /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
Java version:17.0.8
[Enter user password:]
Run ID: 325865,0,0
Job Start Time: 2024-06-19T05:32:42.870Z
Job End Time: 2024-06-19T05:32:42.990Z
Number of Compare Pairs: 1
Number of Compare Pairs With Errors: 1
Number of Compare Pairs With Out-Of-Sync: 0
Number of Compare Pairs With No Out-Of-Sync: 0
Number of Compare Pairs Cancelled: 0
Number of Compare Pairs Running: 0
Job Completion Status: ERRORS
Compare Pair Run ID: 325865,0,0
Compare Pair Name: ETMSP_TIMESTAMPTEST=ETMSP_TIMESTAMPTEST
Compare Pair Id: 1,893
Compare Pair Phase: FINISHED
Compare Pair Status: FAILED
Number of Rows Compared: 0
Number of Rows In Sync: 0
Number of Rows Out Of Sync: 0

親トピック: Vericom