defgen

ノート:

defgenユーティリティを使用できるように、Oracle GoldenGateプログラムの項の説明に従って環境変数を設定してください。

defgenは、Linux、UNIXまたはWindowsオペレーティング・システムのコマンドラインからDEFGENユーティリティを実行するために使用します。defgenプログラムは、Oracle GoldenGateインストール・ディレクトリまたはライブラリにインストールされます。

Windows、UNIXおよびLinuxの構文

defgen paramfile parameter_file 
[CHARSET character_set]
[COLCHARSET character_set]
[noextattr]
[pauseatend | nopauseatend]
[reportfile report_file]

次の構文は、他のオプションなしでも使用できます。

defgen defs_file updatecs charset

defgen

このコマンドをオプションなしで使用した場合、プログラムが対話型で実行されます。

paramfile parameter_file

必須です。実行するDEFGENプログラムのパラメータ・ファイルの相対パス名または絶対パス名を指定します。

COLCHARSET character_set

サポートされている文字セット。詳細は、COLCHARSETを参照してください。

noextattr

リリース11.2.1より古いOracle GoldenGateとの下位互換性を維持するために使用できますが、ASCII以外の文字セット、大/小文字の区別、および空白とともに引用符で囲んだオブジェクト名をサポートしません。NOEXTATTRを指定すると、DEFGENは、Oracle GoldenGateリリース11.2.1で導入されたグローバリゼーション機能をサポートするデータベース・ロケールおよび文字セットを組み込みません。表名または列名にマルチバイト文字や空白などの特殊文字が含まれている場合、NOEXTATTRを指定すると、DEFGENは表定義を組み込みません。パラメータ・ファイルでAPPENDモードが使用されている場合、NOEXTATTRは無視され、その他の属性が指定されているかどうかに関係なく、新しい表定義が既存のファイル形式で追加されます。

pauseatend | nopauseatend

(Windowsのみ)プロセスが停止した場合、Oracle GoldenGateユーザーはコンソール出力を参照し、任意のキーを押してクリアする必要があります。また、プロセスが正常終了したか異常終了したかも示します。

reportfile report_file

指定したレポート・ファイルにコマンド出力を送信します。reportfileオプションを指定しない場合、コマンド出力は画面に表示されます。

defs_file updatecs charset

文字セットに互換性のないオペレーティング・システムに定義ファイルを転送する場合、その定義ファイルの文字セットを別の文字セットに変換します。この手順では、入力として定義ファイル名およびターゲットの文字セットが使用されます。たとえば: defgen ./dirdef/source.def UPDATECS UTF-8。

updatecsが役立つのは、日本語のWindowsにおける日本語の表名がWindows CP932でデータ定義ファイルに記述されており、その定義ファイルを日本語のUNIXに転送するような場合です。UNIXがPCKロケールで構成されていないかぎり、このファイルは使用できません。そのため、updatecsを使用して定義ファイルのエンコーディングを正しい形式に変換する必要があります。

例

次に、DEFGENパラメータ・ファイルdefgenparam.prmのサンプルを示します:

DEFSFILE /home/oracle/ogg/ora/bin/ora.defs, 
PURGE useridalias oracle_source
table hr.employees;

次のコマンドを使用して、DEFGENプログラムをコールします:

.$OGG_HOME/bin/defgen PARAMFILE defgenparam.prm