RMTFILE

適用対象

Extract

説明

RMTFILEパラメータでは、抽出データを書き込むリモート・システム上の抽出ファイル名を定義します。このパラメータは、初期ロード構成に使用します。オンライン変更同期では、RMTTRAILパラメータを使用します。

抽出ファイルのサイズの上限は2GBです。

RMTFILEは、RMTHOST文の後に指定する必要があり、すべてのTABLE文より先に指定する必要があります。

ENCRYPTTRAILパラメータを使用して、このファイル内のデータを暗号化できます。詳細は、「ENCRYPTTRAIL | NOENCRYPTTRAIL」を参照してください。

デフォルト

なし

構文

RMTFILE file_name
[, APPEND]
[, PURGE]
[, MAXFILES number]
[, MEGABYTES megabytes]
[, FORMAT RELEASE major.minor]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

file_name

ファイルの相対名または完全修飾名。

APPEND

現在のデータをファイルの既存のデータに追加します。APPENDを使用する場合、PURGEは使用しないでください。

PURGE

新しいファイルを作成する前に、既存のファイルを削除します。PURGEを使用する場合、APPENDは使用しないでください。

MAXFILES number

単一のファイルでなく、連続するファイルを作成します。このオプションは、1つのファイルのサイズがオペレーティング・システムに許可される制限を越える可能性があるときに使用します。

MAXFILESを使用して、必要な数のファイルを作成できます。エージングされたファイルには、6桁の順序番号が付けられます(例: datafile000002)。

MAXFILESを使用するときは、MEGABYTESも使用して、連続ファイル内の各ファイルの最大サイズを設定します。

チェックポイントは、これらのファイルには保持されません。

MEGABYTES megabytes

ファイル(MAXFILESを使用している場合は各ファイル)の最大サイズを定義します。リモート・ファイルのサイズの上限は2GBです。

FORMAT RELEASE major.minor

Extractからファイルに送信されるデータのメタデータ・フォーマットを指定します。リーダー・プロセスは、メタデータに基づいて、データ・レコードが自身がサポートしているバージョンかどうかを把握します。メタデータのフォーマットは、Oracle GoldenGateプロセスのリリースによって異なります。古いOracle GoldenGateリリースには、新しいリリースとは異なるメタデータが含まれます。

FORMATは必須のキーワードです。
RELEASEはOracle GoldenGateのリリース・バージョンを指定します。majorはメジャー・バージョン番号で、minorはマイナー・バージョン番号です。X.xには、Oracle GoldenGateの現在または以前のGenerally Available (GA)リリースを指定する必要があります。有効な値は、9.0から現在のOracle GoldenGate X.xバージョン番号(たとえば11.2または12.1)です。(9.0以前のOracle GoldenGateリリースを使用している場合は、9.0または9.5を指定してください。)

リリース・バージョンは、プログラムによって適切な内部互換性レベルにマッピングされます。デフォルトは、このトレイルに書き込むプロセスの現在のバージョンです。12.1より前のRELEASEのリリースでは、3つの部分からなるオブジェクト名はサポートされません。

FORMATとRECOVERYOPTIONSパラメータの間には、依存関係があります。RECOVERYOPTIONSをAPPENDMODEに設定する場合、FORMATはRELEASE 10.0以上に設定する必要があります。RECOVERYOPTIONSをOVERWRITEMODEに設定する場合、FORMATはRELEASE 9.5以下に設定する必要があります。

TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}

ファイル・レコードのメタデータのバイト・フォーマットを設定します。このパラメータは、列データに影響しません。12.1以上のバージョンのFORMAT RELEASEが指定されているファイルにのみ有効です。有効な値は、BIGENDIAN (ビッグ・エンディアン)、LITTLEENDIAN (リトル・エンディアン)およびNATIVEENDIAN (ローカル・システムのデフォルト)です。デフォルトはBIGENDIANです。使用方法の詳細は、GLOBALSバージョンの「TRAILBYTEORDER」を参照してください。

例

例1

RMTFILE /ggs/dirdat/salesny, MEGABYTES 2, PURGE

例2

RMTFILE /ggs/dirdat/salesny, MEGABYTES 2, FORMAT RELEASE 10.4