この章では、vericom
コマンドライン・インタフェースを使用して比較を実行する方法について説明します。
この章の内容は次のとおりです。
Oracle GoldenGate Veridataのvericom
ツールを使用して、オペレーティング・システムのコマンド・シェルから特定の比較ジョブを実行できます。vericom
ツールはOracle GoldenGate Veridataコマンドライン・インタフェースを実行し、これらのアクティビティの自動化プログラムによる処理を可能にします。
次のジョブを実行できます。
ジョブ全体またはジョブの特定の比較ペアの実行
注意: グループは個別に実行できません。 |
Veridataがリポジトリへの接続に使用するパスワードの変更
トレースの設定 (Oracleサポート・アナリストのガイダンスがある場合のみ)
特定の比較ペアの場合は、次のジョブを実行できます。
以前の非同期結果の確認
以前の実行からの非同期XMLの生成
Webインタフェースから可能な同じプロファイル設定および行パーティションの上書き
比較は、Oracle GoldenGate Veridata Webインタフェースからも実行できます。このインタフェースは、比較するオブジェクトの構成およびランタイム・パラメータの設定制御において優れた機能を発揮します。
vericom
プログラムは、これを実行するための正しいオペレーティング・システムの権限を有するユーザーは誰でも実行できます。
Oracle GoldenGate Veridataがインストールされているシステムで、オペレーティング・システムのコマンド・シェルを実行します。
Oracle GoldenGate Veridataインストール・ディレクトリに移動します。
次の構文を使用して、vericom
プログラムを実行します。
構文
vericom{.bat|.sh} required_input [optional_input]
必須入力
次のいずれかは必須です。入力しないとエラーが返されます。オプションを1つのみ入力します。
-help | -helprun | {-version | -v} | {-job | -j} job | -reset_password [password]
-version
、-v
、-help
または-helprun
を指定すると、指定した他のフラグより優先されます。
オプション入力
これはオプションの入力です。
[ -g group -c compare_pair ] [ -nw ] [ -rP profile ] [ -rR ] | -rO ] [ -rN threads ] [ -rD seconds ] [ -rC | +rC ] [ -rOb | -rOx | -rO2 | -rO0 ] [ -rOs records ] [ -rTi ] [ -rTc ] [ -rTs trace_number ] [ -pS source_partition_name | -pSq source_sql_predicate | -pSA1 source_ascii_start_key | -pSA2 source_ascii_end_key | -pSH1 source_hex_start_key | -pSH2 source_hex_end_key ] [ -pT target_partition_name | -pTq target_sql_predicate | -pTA1 target_ascii_start_key | -pTA2 target_ascii_end_key | -pTH1 target_hex_start_key | -pTH2 target_hex_end_key ] [ -pq sql_predicate ] [ -rd0 | -rdN run_ID ]
表10-2 vericomのランタイム引数
Vericomは、次のいずれかのステータスで終了します。ここで示す例は、UNIXまたはLinuxシステムに対するものです。
ステータス | 説明 |
---|---|
0 |
コマンドが正常に実行されました。ジョブが実行された場合は、すべての行は同期で終了しました。
|
1 |
無効な
|
2 |
|
3 |
比較を実行したフラグを含む入力エラーの細分性を上げてください。たとえば、次のような誤りがこのエラーを引き起こします。
前述の例では、
前述の例では、デルタ処理が比較ペア・レベルで適用されるため、 |
4 |
ジョブは正常に実行されましたが、同期以外の何かの比較ステータスの行がありました。 |
5 |
Oracle GoldenGate Veridataサーバーで通信エラーが発生しました。 |
vericom
で実行する比較結果を表示する場合は、Oracle GoldenGate Veridata Webを使用して比較レポート(1.3項「比較結果の表示」を参照)を表示でき、vericom
が端末に返した出力を表示できます。実行が正常に終了すると、ジョブの統計が表示されます。
次の例は、-w
を指定しない場合のTestJob
のWindowsシステム上での実行を示しています。プロセスはステータス0で終了し、終了済みジョブの統計は表示されません。
C:\veridata\server\bin>vericom.bat -j TestJob Connecting to: localhost:9177 Run ID: (2256, 0, 0) C:\veridata\server\bin> if errorlevel 0 echo EXITED 0 STATUS EXITED 0 STATUS
次の例は、-w
を指定した場合のTestJob
の実行を示しています。比較ペアの1つに検証エラーがあったため、プロセスはステータス4で終了します。終了済みジョブは表示されます。
C:\veridata\server\bin>vericom.bat -j TestJob -w Connecting to: localhost:9177 Run ID: (2257, 0, 0) Job Start Time: 2008-03-21 22:48:05 Job Stop Time: 2008-03-21 22:48:20 Job Report Filename: C:\testjunit\rpt\TestJob\00002257\TestJob.rpt Number of Compare Pairs: 3 Number of Compare Pairs With Errors: 1 Number of Compare Pairs With OOS: 1 Number of Compare Pairs With No OOS: 1 Number of Compare Pairs Cancelled: 0 Job Completion Status: WITH ERRORS C:\veridata\server\bin> if errorlevel 4 echo EXITED 4 STATUS EXITED 4 STATUS
次の例は、-w
を指定した場合のジョブTestJob
の比較ペアTABLE9=TABLE9
の実行を示しています。表が同期であるため、プロセスはステータス0で終了します。終了済みジョブは表示されます。
C:\veridata\server\bin>vericom.bat -j TestJob -g TestGroup -c TABLE9=TABLE9 -w Connecting to: localhost:9177 Run ID: (2258, 0, 0) Job Start Time: 2008-03-21 22:51:08 Job Stop Time: 2008-03-21 22:51:11 Job Report Filename: C:\veridata\data\rpt\TestJob\00002258\TestJob.rpt Number of Compare Pairs: 1 Number of Compare Pairs With Errors: 0 Number of Compare Pairs With OOS: 0 Number of Compare Pairs With No OOS: 1 Number of Compare Pairs Cancelled: 0 Compare Pair Report Filename: C:\veridata\data\rpt\TestJob\00002258\TestGroup\CP_ TABLE9=TABLE9.rpt Number of Rows Compared: 21 Number of Rows In Sync: 21 Number of Rows With Errors: 0 Number of Rows Out Of Sync: 0 Number of Inserts Out Of Sync: 0 Number of Deletes Out Of Sync: 0 Number of Updates Out Of Sync: 0 Compare Pair OOSXML Directory: C:\veridata\data\oosxml\TestJob\00002258\TestGroup Compare Pair OOSXML Filename: Job Completion Status: IN SYNC C:\veridata\server\bin> if errorlevel 0 echo EXITED 0 STATUS EXITED 0 STATUS
UNIXシステムでは、SH
またはKSH
シェルを使用中の場合、以前に実行したコマンドの終了ステータスは特別な変数'$?'
にあります。CSH
シェルを使用中の場合、以前に実行したコマンドの終了ステータスは特別な変数'$status
'に格納されています。