4 アイデンティティの管理とデータの比較
Vericomコマンドライン・インタフェースには、資格証明ストアでアイデンティティを管理し、比較を実行するためのツールがあります。
この章の内容は次のとおりです。
4.1 Vericomツールの概要
vericomツールを使用して、オペレーティング・システムのコマンド・シェルから特定の比較ジョブを実行できます。vericomツールは Oracle GoldenGate Veridataコマンドライン・インタフェースを実行し、これらのアクティビティの自動化プログラムによって処理できるようにします。
次のジョブを実行できます。
-
ジョブ全体またはジョブの特定の比較ペアの実行
ノート:
グループは個別に実行できません。 -
トレースの設定 (Oracleサポート・アナリストのガイダンスがある場合のみ)
特定の比較ペアの場合は、次のジョブを実行できます。
-
以前の非同期結果の確認
-
以前の実行からの非同期XMLの生成
-
Webユーザー・インタフェースから可能な同じプロファイル設定および行パーティションの上書き
Oracle GoldenGate VeridataWebユーザー・インタフェースから比較を実行することもできます。このインタフェースは、比較するオブジェクトの構成およびランタイム・パラメータの設定制御に優れた機能を発揮します。
詳細は、Oracle GoldenGate Veridataのコマンドライン・ユーティリティの使用 - Vericom、Veridata GoldenGateパラメータ処理およびインポート/エクスポートを参照してください。
4.2 Vericomツールの実行
オペレーティング・システムの権限を有するユーザーは誰でも、vericomツールを実行できます。
- Oracle GoldenGate Veridataがインストールされているシステムで、オペレーティング・システムのコマンド・シェルを実行します。
VERIDATA_DOMAIN_HOME/veridata/binディレクトリに移動します。- 次のパラメータを指定して
vericomツールを実行します:
基本パラメータ
- Vericomツールの実行:
/vericom.sh -wluser <wlusername> -wlport <wlport>。例:/vericom.sh -wluser vericom -wlport 8830 - コマンドを実行してOracle GoldenGate Veridataを識別:
/vericom.sh -wluser <wlusername> -wlport <wlport> -version。例:/vericom.sh -wluser vericom -wlport 8830 - ジョブの実行:
/vericom.sh -wluser <wluser> -wlport <wlport> -job <job name> -g <group name> -c <compare pair>例:
サンプル出力:./vericom.sh -wluser vericom -wlport 8830 -job Vericom -g Vericom -c DP=DPOGGV-20032: Run ID: (7979,0,0) OGGV-20033: Number of Rows Compared: 5 OGGV-20034: Number of Rows In Sync: 1 OGGV-20035: Number of Rows With Errors: 0 OGGV-20036: Number of Rows Out Of Sync: 4 OGGV-20037: Compare Pair OOSXML Directory: /scratch/username/Oracle_Home/user_projects/domains/base_domain1/veridata/reports/oosxml/Vericom/00007979/Vericom OGGV-20038: Compare Pair OOSXML Filename: OGGV-20039: Job Completion Status: With Out-Of-Sync bash-4.4$ - ジョブのパージ: 例:
/vericom.sh -wluser vericom -wlport 8830 -purgeJobReports job1,job2,job3purgeJobReports allパラメータは、すべての最新ジョブおよびレポートを削除します。 - ヘルプ・コマンドの実行:
/vericom.sh -wluser <wlusername> -wlport <wlport> -version -help例:
/vericom.sh -wluser vericom -wlport 8830 -helpサンプル出力:Oracle GoldenGate Veridata Command Line Interface - Version 12.2.1.4.0 190913 release build 19 vericom [-wlport <port> ] -wluser <user Name> { -job | -j } <job> [run_flags] | -help | { -version | -v} | -helprun Where: [-wlport <port> ] Weblogic port number -wluser <user Name> Weblogic User Name to connect { -job | -j } <job> Run job <job> -help Print usage. -version, -v Print version. -helprun Print usage of run_flags run_flags Flags for running a job or compare pair -addCredentialStore Create new Credential Store at location defined in veridata.cfg file -deleteCredentialStore Delete Credential Store -createAlias Create alias for user provided in wluser argument -updateAlias Update username and password for alias with user provided in wluser argument -deleteAlias Delete alias -displayAlias Display alias stored in the credential store -wlUserAlias Use alias inplace of wluser - 実行のヘルプ・コマンドの実行:
/vericom.sh -wluser <wlusername> -wlport <wlport> -version -helprun例:
/vericom.sh -wluser vericom -wlport 8830 -helprunサンプル出力:Oracle GoldenGate Veridata Command Line Interface - Version 12.2.1.4.0 190913 release build 19 vericom [-wlport <port> ] -wluser <user Name> { -job | -j } <job> [run_flags] | -help | { -version | -v} | -helprun Where: [-wlport <port> ] Weblogic port number -wluser <user Name> Weblogic User Name to connect { -job | -j } <job> Run job <job> -help Print usage. -version, -v Print version. -helprun Print usage of run_flags run_flags Flags for running a job or compare pair -addCredentialStore Create new Credential Store at location defined in veridata.cfg file -deleteCredentialStore Delete Credential Store -createAlias Create alias for user provided in wluser argument -updateAlias Update username and password for alias with user provided in wluser argument -deleteAlias Delete alias -displayAlias Display alias stored in credential store -wlUserAlias Use alias inplace of wluser Run Flags Usage: [ -g group_name -c compare_pair_name ] [ -rP profile_name ] [ -rR | -rO ] [ -rN number_of_threads ] [ -rD number_of_seconds ] [ -rC | +rC ] [ -rOb | -rOx | -rO2 | -rO0 ] [ -rOs number_of_rows ] [ -rd0 | -rdN run_id ] [ -pS partition_name | -pSq SQL_predicate | -pSA1 ascii_start_key | -pSA2 ascii_ending_key | -pSH1 hex_start_key | -pSH2 hex_ending_key ] [ -pT partition_name | -pTq SQL_predicate | -pTA1 ascii_start_key | -pTA2 ascii_ending_key | -pTH1 hex_start_key | -pTH2 hex_ending_key ] [ -pq SQL_predicate ] [-nw ] [ -w | -wp interval ] [ -repair ] [ -norepair ] Where: -g group_name Name of the group. Requires -c. -c compare_pair_name Name of the compare pair. Requires -g. -rP profile_name Override the default profile. -rR Review Previous OOS Results. -rO Generate OOS XML from Previous Run. -rd0 Do not use delta base from previous run for this job. Requires -c. -rdN run_id Use delta base from run run_id. Requires -c. -rN number_of_threads Override the number of concurrent threads. -rD number_of_seconds Override the COOS delay for this job. -rC Do not run COOS this job. +rC Do run COOS this job. -rOb Generate binary OOS for this job. -rOx Generate XML OOS for this job. -rO2 Generate both binary and XML OOS for this job. -rO0 Do not generate OOS for this job. -rOs number_of_rows Number of rows in each OOS XML chunk for this job. -pS Use named partition on the source. -pSq Use SQL predicate on the source. -pSA1 Use arg as the starting ascii key the source. -pSA2 Use arg as the ending ascii key the source. -pSH1 Use arg as the starting hexadecimal key the source. -pSH2 Use arg as the ending hexadecimal key the source. -pT Use named partition on the target. -pTq Use SQL predicate on the target. -pTA1 Use arg as the starting ascii key the target. -pTA2 Use arg as the ending ascii key the target. -pTH1 Use arg as the starting hexadecimal key the target. -pTH2 Use arg as the ending hexadecimal key the target. -pq Use SQL predicate on the source and target. -nw Do not wait for job to complete; job is submitted in background. -wp Wait for job to complete, poll at specified interval. -repair Launch a repair job automatically after compare job finishes. ] -norepair Do not launch a repair job automatically, after compare job finishes. ] -repairsql Supports generation of repair sql after the Job comparison is completed. When the compare is complete, a repair sql zip file gets generated if out-of-sync data exists. This flag is valid only for Oracle and SQL Server target databases. ]
ユーザー・グループの定義によるOracle GoldenGate Veridataへのアクセスの保護を参照してください。
-version、-v、-helpまたは-helprunオプションは、指定した他のオプションより優先されます。
表4-1 Vericomの基本パラメータの説明
| 引数 | 説明 |
|---|---|
-wluser |
サーバーを認証して接続するサーバー・ユーザー名を指定します。 |
-ssl |
SSLを介したOracle Goldengate Veridataサーバーへの接続に使用します。 |
-wlport |
サーバーのポート番号を指定します。 |
-help |
|
-helprun |
実行関連の構文コンポーネントとその説明を表示します。 |
{-version | -v} |
使用中のOracle GoldenGate Veridataコマンドライン・インタフェースのバージョンを表示します。 |
{-job | -j} job |
実行するジョブを指定します。 |
-g group -c compare_pair |
グループと比較ペアを指定します。
|
表4-2 Vericomの拡張パラメータの説明
4.3 資格証明ストアでのアイデンティティの管理
資格証明ストアは、Oracle Credential Store Framework内のAuto Loginウォレットとして実装されます。
この項では、資格証明ストアを使用して、暗号化されたデータベース・パスワードおよびユーザーIDを保持し、それらを別名に関連付ける方法を示します。これは、コマンドまたはパラメータ・ファイルで指定される別名で、実際のユーザーIDやパスワードではありません。暗号化キーのユーザー入力は必要ありません。
資格証明ストアには、次のトピックがあります。
別名には、次のトピックがあります。
4.3.1 資格証明ストアの追加
–addCredentialStore引数は、入力を受け入れません。資格証明ストアのデフォルトの場所は、<Domain_home>/veridata/dircrdです。credential.store.locationプロパティの下のveridata.cfgファイル内でディレクトリを指定することで、これを変更できます。credential.store.locationプロパティのデフォルト値は、ドメインの場所に相対的なveridata/dircrdです。資格証明ストアの独自の場所を作成することや、vericomの実行前にこのプロパティを変更することができます。資格証明ストア・ウォレットは、読取りおよび書込み権限(-rw-------)のみで作成されます。
例4-1
./vericom.sh -wluser vericom -wlport 8830 -addCredentialStore
4.3.2 別名の作成
-createAlias引数が入力として受け入れるのは、ゼロまたは1つです。入力を指定した場合、それが別名として使用されます。指定しない場合、wluser引数で指定したユーザー名が別名として使用されます。この別名が、ユーザー名およびパスワードのかわりに使用され、実際のユーザー名およびパスワードを指定する必要はありません。
例4-2
./vericom.sh -wluser vericom -wlport 8830 -createAlias
4.3.3 資格証明ストアの削除
—deleteCredentialStore引数は、入力を受け入れません。このオプションは、資格証明ストアを削除します。資格証明ストアの場所は、veridata.cfgファイル内のcredential.store.locationです。資格証明ストア・ウォレットおよびそのコンテンツは、恒久的に削除されます。
例4-3
./vericom.sh -wluser vericom -wlport 8830 -deleteCredentialStore
4.3.4 別名の使用
-createAliasを使用して作成された別名には、-wluserAlias引数を使用する必要があります。このオプションを使用すると、パスワードの入力を要求されません。-wluserAliasに-wluserAlias引数は使用しないでください。ウォレットに別名が存在しない場合は、エラーが返されます。
例4-4
./vericom.sh -wluserAlias vericom -wlport 8830 -job Vericom
4.3.5 別名の表示
-displayAlias引数を使用して、ウォレットのすべての別名およびユーザー名をリストします。パスワードは表示されません。
例4-5
vericom.sh –wluser vericom -wlport 8830 -displayAlias
Alias : vericom
Username : vericom4.4 vericom終了ステータス
vericomコマンドライン・ツールは、次のいずれかのステータスで終了します。ここで示すのは、UNIXまたはLinuxシステムに対する例です。
Vericomは、次のいずれかのステータスで終了します。ここで示す例は、UNIXまたはLinuxシステムに対するものです。
表4-3 Vericom終了ステータス
| ステータス | 説明 |
|---|---|
0 |
コマンドが正常に実行されました。ジョブが実行された場合、すべての行が同期します。
|
1 |
無効な
|
3 |
比較フラグを含む入力エラーの細分性を提供します。たとえば、次のような誤りがこのエラーを引き起こします。
前述の例では、
前述の例では、デルタ処理が比較ペア・レベルで適用されるため、 |
4 |
ジョブに同期されていない行が含まれています。 |
5 |
サーバーとの通信エラーが発生しました。 |
6 |
ジョブは失敗しました。 |
7 |
ジョブは取り消されました。 |
4.5 Vericom出力例
vericomツールを使用して実行する比較の結果を表示するには、Oracle GoldenGate Veridata Webユーザー・インタフェースを使用して比較レポートを表示します。ツールによって端末に返された出力を表示することもできます。実行が正常に終了すると、ジョブの統計が表示されます。
「比較結果の表示」を参照してください。
次の例では、TestJobジョブを使用します。
- 例1
-
この例では、
‐wを指定しない場合のWindowsシステム上での実行を示しています。プロセスはステータス0で終了し、終了済みジョブの統計は表示されません。VERIDATA_DOMAIN_HOME\veridata\bin\vericom.bat -wluser veridata -wlport 8830 -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 - 例2
-
この例は、
-wを指定した場合のTestJobの実行を示しています。比較ペアの1つに検証エラーがあったため、プロセスはステータス4で終了します。終了済みジョブは表示されます。VERIDATA_DOMAIN_HOME\veridata\bin\vericom.bat -wluser veridata -wlport 8830 -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 - 例3
-
この例は、
-wを指定した場合のジョブTestJobでのTABLE9=TABLE9の実行を示しています。表が同期であるため、プロセスはステータス0で終了します。終了済みジョブは表示されます。VERIDATA_DOMAIN_HOME\veridata\bin\vericom.bat -wluser veridata -wlport 8830 -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 STATUSUNIXシステムで、SHまたはKSHシェルを使用する場合、終了ステータスは特殊な'$?'変数です。CSHシェルを使用する場合、終了ステータスは特殊な'$status'変数です。