ファイル定義

有効な対象

DEFGEN

摘要

DEFSFILEパラメータでは、DEFGENがデータ定義を書き込むファイルの名前を指定します。デフォルトでは、データ定義ファイルは、ローカル・オペレーティング・システムの文字セットで書き込まれます。文字セットを変更するには、CHARSETオプションを使用します。

デフォルト

なし

構文

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

相対または完全修飾ファイル名。このファイルはDEFGENを実行するときに作成されます。

APPEND

指定したファイルがすでに存在している場合、DEFGENに、既存のコンテンツの末尾に(現在の実行から)新しいコンテンツを書き込ませます。すでに存在している定義ファイルが古いOracle GoldenGateリリース・バージョンである場合は、FORMAT RELEASEオプションを既存のファイルと同じバージョンに設定するとエラーを防ぐことができます。そうしないと、DEFGENは新しいメタデータ機能を追加しようとして異常終了します。APPENDを使用する場合、次の制約があります。

PURGE

現在の実行で新しいコンテンツを書き込む前に、DEFGENに指定したファイルをパージさせます。PURGEを使用すると、古いバージョンのDEFGENによって作成された既存の定義ファイルを、新しい機能(3つの部分からなるオブジェクト名など)をサポートする新しいメタデータで上書きできます。

CHARSET <character_set>

定義ファイルを指定した文字セットで生成します。CHARSETを指定しない場合、オペレーティング・システムのデフォルトの文字セットが使用されます。リリース11.2.1以降の定義ファイルにAPPENDモードが指定されている場合、CHARSETは無視され、既存の定義ファイルの文字セットが使用されます。

FORMAT RELEASE <major.minor>

DEFGENによって定義ファイルに送られる定義のメタデータ・フォーマットを指定します。リーダー・プロセスは、メタデータに基づいて、ファイル・レコードが自身がサポートしているバージョンかどうかを把握します。メタデータ・フォーマットは、Oracle GoldenGateプロセスのバージョンに応じて異なります。以前のOracle GoldenGateバージョンには、新しいバージョンと異なるメタデータが含まれています。定義ファイルを使用するプロセスが、現在のOracle GoldenGateバージョンよりも古い場合は、FORMATを使用します。

FORMAT RELEASE <major.minor>

Extractがトレイル、ファイルまたは(リモート・タスクの場合)別のプロセスに送信するデータのメタデータ・フォーマットを指定します。メタデータは、データ・レコードがサポートされているバージョンであるかどうかをリーダー・プロセスに示します。メタデータ・フォーマットは、Oracle GoldenGateプロセスのバージョンに応じて異なります。以前のOracle GoldenGateバージョンには、新しいバージョンと異なるメタデータが含まれています。

FORMAT RELEASEでは、Oracle GoldenGateのリリース・バージョンを指定します。majorはメジャー・バージョン番号、minorはマイナー・バージョン番号です。X.xは、Oracle GoldenGateの現在または以前の一般提供(GA)リリースを反映している必要があります。有効な値は、11.1から現在のOracle GoldenGate X.xバージョン番号(たとえば11.2または12.1)です。リリース・バージョンは、適切なトレイル・フォーマットの互換性レベルにプログラム的にマップされます。デフォルトは、このトレイルに書込みを行うプロセスの現在のバージョンです。ノート: 12.1より前のRELEASEバージョンでは、3つの部分からなるオブジェクト名はサポートされません。

ノート: 単一のExtractで複数の証跡を使用する場合、同じRELEASEバージョンのみが共存できます。

次の設定は、Oracle Database 12.2以上でサポートされます:

例

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2