パラメータ・ファイルの検証
checkprm
検証用ネイティブ・コマンドはコマンドラインから実行され、構成可能なアプリケーションと実行環境を使用して、指定されたパラメータ・ファイルのアセスメントを提供します。単純にPASS
/FAIL
を表示するか、各パラメータの値がどのように格納され解釈されるかに関するオプション詳細を付けて表示することもできます。
checkprm
への入力は大/小文字を区別しません。値文字列にスペースが含まれている場合、checkprm
は意味のある値を認識できるので、引用符で囲む必要はありません。checkprm
にモードが指定されていない場合は、コンポーネントのあらゆるモードに適用可能なすべてのパラメータが使用されます。
checkprm
の出力は、想定される次の4つのセクションにまとめられます。
-
ヘルプ・メッセージ
-
事前検証エラー
-
検証結果
-
パラメータの詳細
一般に事前検証エラーとは、通常のパラメータ検証が実行できなくなるエラー(オプションの欠落やアクセス不可能なパラメータ・ファイルなど)のことです。オプションの値が間違って指定されている場合、そのオプションに対して考えられる入力のリストが表示されます。結果がFAIL
の場合、各エラーが最終結果メッセージに表示されます。結果がPASS
の場合、一部のパラメータに対してさらに実行時検証が行われることを示すメッセージが表示されます。パラメータの詳細出力には、検証コンテキスト、GLOBALS (存在する場合)から読み取られた値、および指定されたパラメータが含まれます。パラメータとオプションは、これらの関係がわかるよう、適切にインデントして出力されます。
表 -1に、checkprm
コマンドで使用可能なすべての引数を示します。checkprm
を使用する場合に、これらの引数をまったく使用しないと、checkprm
は自動的にExtractまたはReplicatおよびOracle GoldenGateインストールのプラットフォームとデータベースの検出を試みます。
表 -1 checkprmの引数
引数 | 目的と動作 |
---|---|
|
使用方法についての情報を表示します |
|
バナーを表示します。他のオプションと組み合せることはできません。 |
|
詳細な使用方法情報(各オプションの使用可能なすべての値など)を表示します。他のオプションと組み合せることはできません。 |
|
パラメータ・ファイルの名前を指定します。検証が必要な場合は第1引数にする必要があります。パラメータ・ファイルへの絶対パスを指定する必要があります。たとえば、 |
|
このパラメータ・ファイルを検証する対象の実行中のコンポーネント(アプリケーション)を指定します。このオプションは、ExtractまたはReplicatでは省略可能です(自動検出が試行されるため)。有効な値は次のとおりです。
このオプションにデフォルトはありません。 |
|
実行中のアプリケーションのモードを指定します(該当する場合)。このオプションは省略可能で、ExtractまたはReplicatにのみ適用できます。モードが指定されていない場合、検証はすべてのExtractまたはReplicatモードで実行されます。 このオプションの有効な入力は次のとおりです。
このオプションの値を入力する際、アプリケーション名はコンポーネントの値と一致する場合にかぎり省略可能です。たとえば、コンポーネントがExtractの場合、 |
|
アプリケーションを実行するプラットフォームを指定します。デフォルト値は、この 指定できる値は次のとおりです。
|
|
アプリケーションを構築する対象のデータベースを指定します。デフォルト値は、Oracle GoldenGateインストール用のデータベースです。 データベース・オプションは次のとおりです(大/小文字の区別なし)。
|
|
詳細なパラメータ情報を出力し、値がどのように読み取られ解釈されるかを示すよう、 検証で指定される最後のオプションです。 |
次に、いくつかの使用例を示します。
checkprm ? checkprm ./dirprm/ext1.prm -C extract -m data pump -p Linux -v checkprm ./dirprm/ext1.prm -m integrated checkprm ./dirprm/rep1.prm -m integrated checkprm ./dirprm/mgr.prm -C mgr -v checkprm GLOBALS -c GLOBALS
CHECKPARAMS
パラメータを使用した検証
推奨のcheckprm
ユーティリティを使用する方法の代用には、CHECKPARAMS
パラメータを使用して、ExtractまたはReplicatパラメータ・ファイル内のパラメータの構文が正確かどうかをチェックする方法があります。このプロセスは、ExtractまたはReplicatで使用できます。
パラメータの構文を検証する手順
レポート・ファイルの詳細は、Oracle GoldenGate処理の監視を参照してください。
CHECKPARAMS
の詳細は、『Oracle GoldenGateリファレンス』を参照してください。