RMTTRAIL

適用対象

Extract

説明

RMTTRAILパラメータでは、GGSCIのADD RMTTRAILコマンドで作成されているリモート・トレイルを指定します。RMTTRAILで指定するトレイルは、関連するTABLE文よりも先に配置する必要があります。異なるリモート・トレイルを定義するために、複数のRMTTRAIL文を使用できます。RMTTRAILより先にRMTHOSTパラメータを配置する必要があります。

データ・ポンプではRMTTRAILパラメータは非推奨になったため無視されます

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

デフォルト

なし

構文

RMTTRAIL trail_name
[, FORMAT RELEASE major.minor]
[, OBJECTDEFS | NO_OBJECTDEFS]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

name

トレイルの相対パス名または完全修飾パス名。名前には2文字を使用します。エージングされたトレイル・ファイルは、この名前に6桁の順序番号が追加されます(例: /ggs/dirdat/rt000000001)。

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

FORMAT RELEASE major.minor

Extractからトレイルに送信されるデータのメタデータ・フォーマットを指定します。リーダー・プロセスは、メタデータに基づいて、データ・レコードが自身がサポートしているバージョンかどうかを把握します。古い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を指定してください。)

RELEASEはOracle GoldenGateのリリース・バージョンを指定します。majorはメジャー・バージョン番号で、minorはマイナー・バージョン番号です。X.xには、Oracle GoldenGateの現在または以前のGenerally Available (GA)リリースを指定する必要があります。有効な値は、9.0から現行のOracle GoldenGate X.xバージョン番号までです。Oracle GoldenGate 18c (18.1.0.0)リリースの場合、有効な値は18.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以下に設定する必要があります。

Oracle GoldenGateトレイル・ファイルのバージョニングおよびリカバリ・モードの詳細は、『Oracle GoldenGateの管理』を参照してください。

Oracle Database 12.2では、次の設定がサポートされています。

Oracle Database 12.2の場合は、12.1、FORMAT RELEASE 12.2以上との互換性が設定されている非CDBがサポートされます。
Oracle Database 12.2の場合は、12.2、FORMAT RELEASE 12.2以上との互換性が設定されている非CDBがサポートされます。
互換性が12.2に設定されているOracle Database 12.2 CDB/PDBの場合、サポートされるFORMAT RELEASE値は12.3および18.1のみです。これは、PDBのローカルUNDO操作を使用しているためです。trx IDの一意性を保証するためにPDB番号を使用してトランザクションIDを増やす必要があります。

OBJECTDEFS | NO_OBJECTDEFS

OBJECTDEFSとNO_OBJECTDEFSオプションでは、証跡にオブジェクト定義を含めるかどうかを制御します。この2つのオプションは、出力証跡がOracle GoldenGate正規フォーマットで書式設定され、証跡フォーマット・リリースが12.1より新しい場合にのみ適用可能です。それ以外の場合は証跡にメタデータ・レコードが追加されないため、どちらのオプションも無視されます。

オープン・システム・データベースからNonStopにレプリケートする場合、NonStopでは証跡からのオブジェクト定義の処理がサポートされていないため、12.2より前のフォーマット・バージョンを指定して、オブジェクト定義を証跡に含めないようにします。

TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}

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

例

例1

RMTTRAIL dirdat/ny

例2

RMTTRAIL /ggs/dirdat/ny, FORMAT RELEASE 10.4

例3

キャプチャされるのと同じ表のセット内の2つのトレイル・フォーマット:

FORMAT RELEASE  11.2 
TABLE tab1 
TABLE tab2 
FORMAT RELEASE 12.1 
TABLE tab1 
TABLE tab2

例4

オブジェクト定義を含むHRスキーマとオブジェクト定義を含まないORDスキーマを送信するデータ・ポンプ・パラメータ・ファイルの例:

RMTTRAIL $data/ggs12.2/a1, OBJECTDEFS
TABLE hr.*;
RMTTRAIL $data/ggs12.2/a2, NO_OBJECTDEFS
TABLE ord.*;