4 アイデンティティの管理とデータの比較
Vericomコマンドライン・インタフェースには、資格証明ストアでアイデンティティを管理し、比較を実行するためのツールがあります。
この章の内容は次のとおりです。
- Vericomツールの概要
vericomツールを使用して、オペレーティング・システムのコマンド・シェルから特定の比較タスクを実行できます。vericomツールは Oracle GoldenGate Veridataコマンドライン・インタフェースを実行し、これらのアクティビティの自動化プログラムによって処理できるようにします。実際のユーザー名およびパスワードを指定することなく、vericomツールを使用できます。 - 資格証明ストアでのアイデンティティの管理
資格証明ストアは、Oracle Credential Store Framework内のAuto Loginウォレットとして実装されます。 - Vericomツールの実行
オペレーティング・システムの権限を有するユーザーは誰でも、vericomツールを実行できます。 - Vericom終了ステータス
vericomコマンドライン・ツールは、次のいずれかのステータスで終了します。ここで示すのは、UNIXまたはLinuxシステムに対する例です。 - Vericom出力例
vericomツールを使用して実行する比較の結果を表示するには、Oracle GoldenGate Veridata Webユーザー・インタフェースを使用して比較レポートを表示します。ツールによって端末に返された出力を表示することもできます。実行が正常に終了すると、ジョブの統計が表示されます。
4.1 Vericomツールの概要
vericomツールを使用して、オペレーティング・システムのコマンド・シェルから特定の比較ジョブを実行できます。vericomツールは Oracle GoldenGate Veridataコマンドライン・インタフェースを実行し、これらのアクティビティの自動化プログラムによって処理できるようにします。実際のユーザー名およびパスワードを指定することなく、vericomツールを使用できます。
次のジョブを実行できます。
-
ジョブ全体またはジョブの特定の比較ペアの実行
ノート:
グループは個別に実行できません。
-
トレースの設定 (Oracleサポート・アナリストのガイダンスがある場合のみ)
特定の比較ペアの場合は、次のジョブを実行できます。
-
以前の非同期結果の確認
-
以前の実行からの非同期XMLの生成
-
Webユーザー・インタフェースから可能な同じプロファイル設定および行パーティションの上書き
Oracle GoldenGate VeridataWebユーザー・インタフェースから比較を実行することもできます。このインタフェースは、比較するオブジェクトの構成およびランタイム・パラメータの設定制御に優れた機能を発揮します。
詳細は、Oracle GoldenGate Veridataのコマンドライン・ユーティリティの使用 - Vericom、Veridata GoldenGateパラメータ処理およびインポート/エクスポートを参照してください。
親トピック: アイデンティティの管理とデータの比較
4.2 資格証明ストアでのアイデンティティの管理
資格証明ストアは、Oracle Credential Store Framework内のAuto Loginウォレットとして実装されます。
この項では、資格証明ストアを使用して、暗号化されたデータベース・パスワードおよびユーザーIDを保持し、それらを別名に関連付ける方法を示します。これは、コマンドまたはパラメータ・ファイルで指定される別名で、実際のユーザーIDやパスワードではありません。暗号化キーのユーザー入力は必要ありません。
資格証明ストアには、次のトピックがあります。
別名には、次のトピックがあります。
- 資格証明ストアの追加
- 資格証明ストアの削除
- 別名の作成
-createAlias引数が入力として受け入れるのは、ゼロまたは1つです。入力を指定した場合、それが別名として使用されます。指定しない場合、wluser引数で指定したユーザー名が別名として使用されます。この別名が、ユーザー名およびパスワードのかわりに使用され、実際のユーザー名およびパスワードを指定する必要はありません。 - 別名の使用
-createAliasを使用して作成された別名には、-wluserAlias引数を使用する必要があります。このオプションを使用すると、パスワードの入力を要求されません。-wluserAliasに-wluserAlias引数は使用しないでください。ウォレットに別名が存在しない場合は、エラーが返されます。 - 別名の表示
-displayAlias引数を使用して、ウォレットのすべての別名およびユーザー名をリストします。パスワードは表示されません。 - 別名の更新
-updateAlias引数を使用して、有効なユーザーのパスワードを更新します。 - 別名の削除
親トピック: アイデンティティの管理とデータの比較
4.2.1 資格証明ストアの追加
–addCredentialStore引数は、入力を受け入れません。資格証明ストアのデフォルトの場所は、<Domain_home>/veridata/dircrdです。credential.store.locationプロパティの下のveridata.cfgファイル内でディレクトリを指定することで、これを変更できます。credential.store.locationプロパティのデフォルト値は、ドメインの場所に相対的なveridata/dircrdです。資格証明ストアの独自の場所を作成することや、vericomの実行前にこのプロパティを変更することができます。資格証明ストア・ウォレットは、読取りおよび書込み権限(-rw-------)のみで作成されます。
例4-1 例
vericom.sh -wluser username -wlport veridata server port –addCredentialStore
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.2 資格証明ストアの削除
—deleteCredentialStore引数は、入力を受け入れません。このオプションは、資格証明ストアを削除します。資格証明ストアの場所は、veridata.cfgファイル内のcredential.store.locationです。資格証明ストア・ウォレットおよびそのコンテンツは、恒久的に削除されます。
例4-2 例
vericom.sh -wluser username -wlport veridata server port –deleteCredentialStore
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.3 別名の作成
-createAlias引数が入力として受け入れるのは、ゼロまたは1つです。入力を指定した場合、それが別名として使用されます。指定しない場合、wluser引数で指定したユーザー名が別名として使用されます。この別名が、ユーザー名およびパスワードのかわりに使用され、実際のユーザー名およびパスワードを指定する必要はありません。
例4-3 例
vericom.sh -wluser username-wlport veridata server port –createAlias aliasname (オプション)
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.4 別名の使用
-createAliasを使用して作成された別名には、-wluserAlias引数を使用する必要があります。このオプションを使用すると、パスワードの入力を要求されません。-wluserAliasに-wluserAlias引数は使用しないでください。ウォレットに別名が存在しない場合は、エラーが返されます。
例4-4 例
vericom.sh -wluserAlias alias-name -wlport veridata server port –job job name
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.5 別名の表示
-displayAlias引数を使用して、ウォレットのすべての別名およびユーザー名をリストします。パスワードは表示されません。
例4-5 例
vericom.sh –wluser username -wlPort veridata server port -displayAlias
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.6 別名の更新
-updateAlias引数を使用して、有効なユーザーのパスワードを更新します。
例4-6 例
vericom.sh -wluser username -wlport veridata server port –updateAlias alias-name (オプション)
親トピック: 資格証明ストアでのアイデンティティ管理
4.2.7 別名の削除
別名を削除するには、-deleteAlias引数を使用します。他の別名が同じユーザーを参照していない場合は、別名とともに対応するユーザー資格証明も削除されます。
例4-7 例
vericom.sh -wluser username -wlport veridata server port –deleteAlias aliasname (オプション)
親トピック: 資格証明ストアでのアイデンティティ管理
4.3 Vericomツールの実行
オペレーティング・システムの権限を有するユーザーは誰でも、vericomツールを実行できます。
- Oracle GoldenGate Veridataがインストールされているシステムで、オペレーティング・システムのコマンド・シェルを実行します。
VERIDATA_DOMAIN_HOME/veridata/binディレクトリに移動します。vericomツールを実行します:vericom{.bat|.sh} required_parameter [optional_parameter]。
必須パラメータ
次のいずれかのオプションを入力します。入力しないとエラーが返されます。
[-wlport port ] | -wluser user_name | -help | -helprun | [-version | -v] | [-job | -j] job | [-purgeJobReports] job name1,job name2 | [-purgeJobReports] all In this example, the-wluseroption specifies the Oracle GoldenGate Veridata Server (server) user name that is needed to connect to the server. This user should have theveridataCommandLineUserprivilege to access and execute command-line operations. The user should also have theveridataAdministratororveridataPowerUserprivilege to successfully run jobs and use the import and export utilities.
ユーザー・グループの定義によるOracle GoldenGate Veridataへのアクセスの保護を参照してください。
-version、-v、-helpまたは-helprunオプションは、指定した他のオプションより優先されます。
例
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 a new Credential Store at location defined in the veridata.cfg file
-deleteCredentialStore
Delete the Credential Store
-createAlias
Create an alias for user provided in the wluser argument
-updateAlias
Update the user name and password for the alias with user provided in the wluser argument
-deleteAlias
Delete the alias
-displayAlias
Display the alias stored in credential store
-wlUserAlias
Use the alias in place of wluser
vericom [-wlport <port> ] -wluser <user Name> [purgeJobReports] j1,j2 |[purgeJobReports] all
この例の内容は次のとおりです。
[purgeJobReports] j1,j2は、ジョブ名j1とj2、レポートおよび選択した最新のジョブ実行を削除します。
[purgeJobReports all]は、すべての最新ジョブおよびレポートを削除します。
オプション・パラメータ
これらはオプションのパラメータです。
[ -g group -c compare_pair -s status][ -nw ] [ -repair | -norepair] [ -rP profile ] [ -rR ] | -rO ] [ -rN threads ] [ -rD seconds ] [ -rC | +rC ] [ -rOb | -rOx | -rO2 | -rO0 ] [ -rOs records ] [ -rd0 | -rdN run_id ] [ -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 ] [-rdj ] [ -wp ] Where: -g group_name Name of the group. Requires -c or -s. -c compare_pair_name Name of the compare pair. Requires -g. -s status of compare pair last run. It requires -j / -job and -g flags. The -c flag overrides the -s flag. Possible values are insync, failed, cancelled, and oos. All the values require the -g flag. Note that oos stands for out-of-sync. -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. -rdj Disables the delta processing for the job. -repair Launch a repair job automatically after compare job finishes. ] -norepair Do not launch a repair job automatically, after compare job finishes. ]
表4-1 Vericomランタイム引数
- VericomのSSL構成
Vericomツールは、SSLプロトコルを使用したOracle GoldenGate Veridataサーバーとの通信をサポートするようになりました。
親トピック: アイデンティティの管理とデータの比較
4.3.1 VericomのSSL構成
Vericomツールは、SSLプロトコルを使用したOracle GoldenGate Veridataサーバーとの通信をサポートするようになりました。
親トピック: Vericomツールの実行
4.4 vericom終了ステータス
vericomコマンドライン・ツールは、次のいずれかのステータスで終了します。ここで示すのは、UNIXまたはLinuxシステムに対する例です。
Vericomは、次のいずれかのステータスで終了します。ここで示す例は、UNIXまたはLinuxシステムに対するものです。
表4-2 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'変数です。
親トピック: アイデンティティの管理とデータの比較