TRANLOGOPTIONS

2.169 TRANLOGOPTIONS

適用対象

Extract

説明

TRANLOGOPTIONSパラメータでは、Extractと、トランザクション・ログまたはトランザクション・データを渡すAPI(データベースやキャプチャ・モードによって異なる)とのやり取り方法を制御します。TRANLOGOPTIONS文を同一のパラメータ・ファイル内で複数回使用することも、(オプションに許可されている場合は)同一のTRANLOGOPTIONS文内で複数のオプションを指定することもできます。

各TRANLOGOPTIONSオプションは、対象のデータベースに対してのみ使用してください。

デフォルト

なし

構文

TRANLOGOPTIONS {
[{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN} width]
[ADGAPPLYCHECKFREQ seconds | cseconds | mseconds]
[ADGCRETRYCOUNT number]
[ADGTIMEOUT seconds]
[ALLOWTABLECOMPRESSION]
[ALTARCHIVEDLOGFORMAT string] [INSTANCE instance] [THREADID id]
[ALTARCHIVELOGDEST [PRIMARY] [INSTANCE instance] path] 
[ALTLOGDEST path | REMOTE]
[ARCHIVEDLOGONLY]
[{ASMBUFSIZE size | DBLOGREADERBUFSIZE size}]
[ASMUSER SYS@ASM_instance, ASMPASSWORD password
   [algorithm ENCRYPTKEY {key_name | DEFAULT}] 
[ASMUSERALIAS alias [DOMAIN domain]]
[ASYNCTRANSPROCESSING buffer_size]
[BUFSIZE size]
[CHECKPOINTRETENTIONTIME days]
[CHECKTABLELEVELSUPPLOG]
[COMPLETEARCHIVEDLOGONLY | NOCOMPLETEARCHIVEDLOGONLY]
[COMPLETEARCHIVEDLOGTIMEOUT seconds]
[DB2APIRETRY 	retry_count]
[DB2ZV11COMPATIBILITYMODE]
[DBLOGREADER]
[DBLOGREADERBUFSIZE size]
[DLFAILOVER_TIMEOUT seconds]
[DISABLESOFTEOFDELAY]
[EXCLUDETAG [tag | NULL] | [EXCLUDETAG +]
[EXCLUDETRANS transaction]
[EXCLUDEUSER user]
[EXCLUDEUSERID Oracle_uid]
[FAILOVERTARGETDESTID n]
[FETCHLOBIFERROR]
[FETCHPARTIALLOB]
[FETCHINLINESFLOB]
[FETCHPARTIALXML]
[FILTERTABLE table]
[FORCEFETCHLOB]
[GETCTASDML | NOGETCTASDML]
[HANDLEDLFAILOVER]
[IGNOREDATACAPTURECHANGES | NOIGNOREDATACAPTURECHANGES]
[IGNOREDIRECTLOADINSERTS]
[INCLUDEAUX (AUX_specification)]
[INCLUDEREGIONID | INCLUDEREGIONIDWITHOFFSET]
[INTEGRATEDPARAMS (ENABLE_PROCEDURAL_REPLICATION Y] [, ...])]
[LOGRETENTION [ENABLED | SR | DISABLED]
[LOGSOURCE platform, [PATHMAP path]]

[MAXWARNEOF seconds]

[MAXAUTOCMTTRANSSIZE (range, default)]
[MINEFROMACTIVEDG | NOMINEFROMACTIVEDG]
[MINEFROMSNAPSHOTSTBY | NOMINEFROMSNAPSHOTSTBY]
[MININGUSER {/ | user}[, MININGPASSWORD password]
   [algorithm ENCRYPTKEY {key_name | DEFAULT}] [SYSDBA]
[MININGUSERALIAS alias [DOMAIN domain]]
[TRANLOGOPTIONS MIXEDENDIAN [ON|OFF] [NODDLCHANGEWARNING]]
[NOFLUSH]
[NOMANAGECDCCLEANUP | MANAGECDCCLEANUP] 
[PATHMAP NFS_mount_point log_path]
[PREPAREFORUPGRADETOIE | NOPREPAREFORUPGRADETOIE]
[PERFORMANCEPROFILE HIGH|MEDIUM]
[PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS]
[QUERYTIMEOUT number]
[QUERYRETRYCOUNT number]
[READQUEUESIZE size]
[READTIMEOUT milliseconds]
[REDO_TRANSPORT_LAG_THRESHOLD seconds]
[REQUIRELONGDATACAPTURECHANGES | NOREQUIRELONGDATACAPTURECHANGES]
[SOURCE_OS_TIMEZONE timezone]
[SUPPRESSNOOOPUPDATES]
[TRANSCLEANUPFREQUENCY minutes]

[TRANCOUNT integer]
[TSLOOKUPBEGINLRI | TSLOOKUPENDLRI]
[VALIDATEINLINESFLOB]
[USE_ROOT_CONTAINER_TIMEZONE]
[USENATIVEOBJSUPPORT | NOUSENATIVEOBJSUPPORT]
[USEPREVRESETLOGSID | NOUSEPREVRESETLOGSID]
[VALIDATEINLINESFLOB]
[VAMCOMPATIBILITY {1 | 2 | 3}]
}
[, ...]

{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN} width

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

ExtractがALTARCHIVELOGFORMATパラメータでフォーマット指定子%A、%D、%T、%Sおよび%Rを使用してアーカイブ・ログ名を形成する際に最小のデフォルト埋込み長を指定します。対応する数値がフィールド幅より小さい場合は、左にゼロが埋め込まれます。表2-16に、各オプションに関連する指定子とデフォルトの長さを示します。

表2-16 アーカイブ・ログ指定子とデフォルトの埋込み長

オプション	指定子	デフォルトの埋込み長
`ACTIVATIONIDPADLEN`	%A	8
`DATABASEIDPADLEN`	%D	8
`THREADPADLEN`	%T	Windowsでは3、その他のプラットフォームでは4
`SEQPADLEN`	%S	Windowsでは5、その他のプラットフォームでは10
`RESETLOGSIDPADLEN`	%R	10

ADGAPPLYCHECKFREQ seconds | cseconds | mseconds

Oracleの統合Extractに有効です。

ADGのキャッチ・アップを確認する各フェッチ・チェック間でExtractが待機する秒、センチ秒またはミリ秒を指定します。数値を小さくするとレイテンシは向上しますが、current_scn from v$databaseの問合せ数は増加します。デフォルト値は3秒、最小値は1秒、最大値は120秒です。

ADGCRETRYCOUNT number

Oracleの統合Extractに有効です。

ADGのキャッチ・アップの待機時に、ExtractがADGの進捗または進捗がない理由を報告するまでの、Extractの試行回数を指定します。この値にFETCHCHECKFREQを乗算することで、ADGの進捗を報告するおおよその頻度が決まります。

ADGTIMEOUT seconds

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

v$database.current_scnが処理する必要のあるレコードに関連付けられたコミットSCNを過ぎていない場合にExtractがタイムアウトになる間隔を秒単位で設定します。デフォルトは30秒です。最小値は5、最大値は2147483646です。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。

ALLOWTABLECOMPRESSION

DB2 LUWバージョン9.5および9.7に有効です。

行圧縮で作成された表を、その表にLOBが含まれていないかぎり、Oracle GoldenGateがサポートできるようにします。このパラメータを設定した場合、表が圧縮されているかどうかにかかわらず、LOB列はサポートされません。行圧縮が含まれる表と含まれない行が混在しているソースから取得するには、圧縮対応の表と非圧縮表を、別々のExtractグループを使用して処理してください。

ALTARCHIVEDLOGFORMAT string [INSTANCE instance] [THREADID id]

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

ソース・データベースのアーカイブ・ログ・フォーマットをオーバーライドする文字列を指定します。

Oracle RAC環境では、各ノード上でALTARCHIVEDLOGFORMATパラメータを使用します。Extractがログ・ストリームを区別できるようにするには、INSTANCEまたはTHREADIDオプションを使用します。1つのRACスレッドのデータベースから問い合されるデフォルトのログ・フォーマットは、Extractがログ・フォーマットを見つけられず、INSTANCEまたはTHREADIDで何も指定されていない場合に他のすべてのスレッドに対して想定されます。

ALTARCHIVEDLOGFORMATを含むTRANLOGOPTIONS文には、他のすべてのTRANLOGOPTIONSオプションを含めることはできません。他のオプションを指定するには、別のTRANLOGOPTIONS文を使用してください。

string

OracleのパラメータLOG_ARCHIVE_FORMATと同じ指定子を受け入れます。Extractは、指定されるフォーマット指定子を使用してログ・ファイル名を導出します。例:

arch_%T.arc

INSTANCE instance

Oracle RACで使用します。ALTARCHIVEDLOGFORMATを特定のOracleインスタンスに適用します。Extractは、データベース・カタログに対して、提供された入力を検証します。

例:

TRANLOGOPTIONS ALTARCHIVEDLOGFORMAT &
INSTANCE rac1 log_%t_%s_%r.arc

THREADID id

Oracle RACで使用します。指定のログ・フォーマットを持つインスタンスのスレッド番号を指定します。

例:

TRANLOGOPTIONS ALTARCHIVEDLOGFORMAT &
THREADID 2 log_%t_%s_%r.arc

ALTARCHIVELOGDEST [PRIMARY] [INSTANCE instance]

[THREADID id] path

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

デフォルト以外の場所に存在するときに、Extractにアーカイブ・ログまたはバックアップOracleトランザクション・ログの場所を示します。Extractはまず指定された場所を確認し、次にデフォルトの場所を確認します。

path: 代替ディレクトリのアーカイブ・ログの完全修飾パスを指定します。このディレクトリは、Oracle GoldenGateが実行されているノードにNFSマウントされている必要があります。このマウント・ポイントをALTARCHIVELOGDESTに使用します。
PRIMARY: 代替場所でログが見つからない場合に、Extractがデフォルトのログの場所を確認することを防ぎます。ALTARCHIVELOGDESTパスのみが確認されます。PRIMARYは、アーカイブ・ログ専用(ALO)モードで実行しているExtractのデフォルトで、それ以外の場合にはオプションです。
INSTANCE instance: 指定したALTARCHIVELOGDEST動作を特定のOracleインスタンスに適用します。RACでこのオプションを使用する場合は、各ノードにALTARCHIVELOGDESTパラメータを指定する必要があります。
THREADID id: 指定されたALTARCHIVELOGDEST動作を特定のスレッド番号に適用します。

ALTLOGDEST path | REMOTE

MySQLに有効です。

MySQLのログ索引ファイルの場所を指定します。Extractは、データベースのデフォルトの場所ではなく、この場所でログ・ファイルを探します。データベース構成にログの完全パス名が含まれていない場合、またはマシンに複数のMySQLがインストールされている場合に、ALTLOGDESTを使用できます。Extractではログ索引ファイルを読み取り、読取りが必要なバイナリ・ログ・ファイルが検索されます。ALTLOGDESTを使用する場合、Extractでは、ログと索引は同じ場所にあるとみなされます。

ディレクトリの完全パス名を指定します。Windowsでは、次の例のように、パスに空白が含まれる場合にパスを二重引用符で囲みます。

TRANLOGOPTIONS  ALTLOGDEST "C:\Program Files\MySQL\MySQL Server 5.1\log\test.index"

Linuxでは次の形式を使用します。

TRANLOGOPTIONS ALTLOGDEST "/mnt/rdbms/mysql/data/logs/binlog.index"

リモート・サーバーからキャプチャする場合や、リモート・キャプチャの場合は、リモート・サーバー上のインデックス・ファイルのパスのかわりにREMOTEオプションを指定するだけです。WindowsおよびLinuxの両方で、リモート・キャプチャの場合はExtractパラメータ・ファイル(capture.prm)で次のように指定します。

TRANLOGOPTIONS ALTLOGDEST REMOTE

REMOTEオプションの使用方法の詳細は、「ロギング・パラメータの設定」を参照してください。

ARCHIVEDLOGONLY

SQL Serverのクラシック・キャプチャ・モードのExtractに有効です。

ARCHIVEDLOGONLYを使用すると、Extractはトランザクション・ログ・バックアップから排他的に読み取ります。このパラメータはExtractをアーカイブ・ログ専用(ALO)モードに設定し、データベース・サーバー以外の異なるWindowsサーバー上でExtractを実行できるようにします。ALOモードはACTIVESECONDARYTRUNCSTIONPOINTパラメータと互換性がありません。

(Oracle) クラシック・キャプチャ・モードのExtractに有効です。

ARCHIVEDLOGONLYでは、v$logおよびv$archived_logなどのシステム・ビューのログの問合せや検証を行わずに、Extractにアーカイブ・ログからのみ読取りを実行させます。このパラメータにより、Extractはアーカイブ・ログ専用(ALO)モードに入ります。デフォルトでは、Extractは接続先が物理スタンバイ・データベースの場合でも、アーカイブ・ログ専用モードを使用しません。アーカイブログ専用モードの詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』のアーカイブログ専用モードでの複数のソースからのキャプチャに関する例を参照してください。

ASMBUFSIZE size

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

トランザクション・ログの各読取り結果を保持する内部バッファへの読取り操作の最大サイズ(バイト)を制御します。ソースOracleのリリースが次のいずれかの場合、DBLOGREADERBUFSIZEオプションのかわりにこのオプションを使用します。

11.2.0.2より前の11g
任意のOracle 11g R1リリース

これらのリリースは、DBLOGREADERオプションでサポートされているOracleリリースで使用できる新しいAPIをサポートしていません。お使いのOracleリリースでサポートされている場合、DBLOGREADERオプションをDBLOGREADERBUFSIZEオプションとともに使用することをお薦めします。

値を大きくすると抽出速度は向上しますが、Extractはより多くのメモリーを消費します。値を小さくすると、メモリーの使用量は減りますが、Extractはキャッシュ・サイズを超えるデータをディスクに保持する必要があるため、I/Oは増加します。

次に、有効範囲とデフォルト・サイズ(バイト)を示します。

最小: REDOログの1ブロックのサイズ
最大: 4MB
デフォルト: 2MB (2097152)

BUFSIZEオプションの値は、常に少なくともDBLOGREADERBUFSIZEの値以上である必要があります。

ASMUSER SYS@ASM_instance, ASMPASSWORD password [algorithm

ENCRYPTKEY {key_name | DEFAULT}]

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

トランザクション・ログを読み取るASMインスタンスにログインするための資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されていない場合にASMUSERALIASのかわりに使用できます。

SYS@ASM_instance: 接続文字列のASMインスタンスを指定します。ユーザーはSYSである必要があります。
password: ENCRYPT PASSWORDコマンドの結果からコピーした暗号化パスワードです。
algorithm: パスワードの暗号化に使用した暗号化アルゴリズムを、AES128、AES192、AES256またはBLOWFISHの中から指定します。
ENCRYPTKEY key_name: ENCKEYS参照ファイル内のユーザー作成の暗号化キーの論理名を指定します。ENCRYPT PASSWORDがKEYNAME key_nameオプションとともに使用された場合に使用します。
ENCRYPTKEY DEFAULT: 指定すると、Oracle GoldenGateでランダムなキーが使用されます。ENCRYPT PASSWORDがKEYNAME DEFAULTオプションとともに使用された場合に使用します。

ノート:

このパラメータは、標準のUSERIDパラメータのかわりには使用できません。ASM環境では、両方のパラメータが必要です。ASMUSERは、ログを読み取るためにDBLOGREADERオプションを使用している場合は不要です。

ASMUSERALIAS alias [DOMAIN domain]

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

トランザクション・ログを読み取るASMインスタンスにログインするための資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されている場合にASMUSERのかわりに使用できます。

alias: ASMインスタンスへのログインに使用されるログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。使用する別名が不明な場合は、INFO CREDENTIALSTOREコマンドを発行して資格証明ストアの内容を調べることができます。
DOMAIN domain: 資格証明ストア内の指定した別名に割り当てるドメインを指定します。

ノート:

このパラメータは、標準のUSERIDALIASパラメータのかわりには使用できません。ASM環境では、両方のパラメータが必要です。ASMUSERALIASは、ログを読み取るためにDBLOGREADERオプションを使用している場合は不要です。

ASYNCTRANSPROCESSING buffer_size

Oracleの統合キャプチャ・モードのExtractに有効です。

統合キャプチャを非同期処理モードで実行するか、同期処理モードで実行するかを制御し、Extractが非同期モードの場合のバッファ・サイズを制御します。最小値は1、最大値は1024、デフォルト値は300です。

ASYNCTRANSPROCESSING buffer_size

非同期トランザクション処理モードには、2つの制御スレッドがあります。

一方のスレッドは、論理変更レコード(LCR)をトランザクションにグループ化し、オブジェクトレベルのフィルタリングと部分ロールバック処理を行います。
他方のスレッドは、コミットされたトランザクションをフォーマットし、ユーザー指定の変換を実行してトレイル・ファイルに書き込みます。

トランザクション・バッファは、これらの2つのスレッド間のバッファで、あるスレッドから別のスレッドへの転送に使用されます。デフォルト・トランザクション・バッファ・サイズはコミット済トランザクション300件分ですが、キャッシュ・メモリーが不足している場合はOracle GoldenGateメモリー・マネージャによって下方に調整されます。

NOASYNCTRANSPROCESSING

非同期処理を無効にし、Extractを同期モードで動作させます。このモードでは、1つのスレッドですべての取得処理を行います。

BUFSIZE size

DB2 LUW、DB2 z/OSおよびOracleに有効です。

トランザクション・ログから読み取られるデータを格納するために割り当てられるバッファの最大サイズ(バイト)を制御します。

ExtractがファイルベースのREDOを処理しているOracleソースの場合、このパラメータは、バッファへの読取り操作の最大サイズ(バイト)も制御します。
ExtractがASM REDOを処理しているOracleソースの場合、TRANLOGOPTIONSとASMBUFSIZEまたはDBLOGREADERBUFSIZEが読取りサイズを制御し、どちらの場合もBUFSIZEがバッファ・サイズを制御します。このパラメータは、ASMBUFSIZEまたはDBLOGREADERBUFSIZE (どちらを使用しているかによります)に設定されている値以上である必要があります。

値を大きくすると取得速度は向上しますが、Extractはより多くのメモリーを消費します。値を小さくすると、メモリーの使用量は減りますが、Extractはキャッシュ・サイズを超えるデータをディスクに保持する必要があるため、I/Oは増加します。

次に、有効範囲とデフォルト・サイズ(バイト)を示します。

Oracle:

最小: 8,192
最大: 10,000,000

デフォルトのバッファ・サイズはREDOデータのソースによって決定されます。

ファイルベースのREDOの場合、デフォルトは1000KB (1024000)です。
ASM REDOの場合、デフォルトは1000KB (1024000)です。
DBLOGREADER REDOの場合、デフォルトは2MB (2097152)です。
統合キャプチャ・モードのExtractの場合、デフォルトは1000KB (1024000)です。

DB2 LUW:

最小: 8,192
最大: 10,000,000
デフォルト: 204,800
前述の値は、4096ページ・サイズの倍数である必要があります。指定された値がこの要件を満たさない場合、Extractは値を切り捨てて倍数にします。

DB2 z/OS

最小: 36KB (36864)
最大: 32MB (33554432)
デフォルト: 2MB (2097152)
前述の値は、4096ページ・サイズの倍数である必要があります。指定された値がこの要件を満たさない場合、Extractは値を切り捨てて倍数にします。
それぞれのExtractは、そのExtractが接続するDB2 z/OSシステム上のECSAの固定68KBを使用します。

CHECKPOINTRETENTIONTIME days

Oracleの統合モードのExtractにのみ有効です。

パージされる前にExtractがチェックポイントを保持する日数を制御します。部分的な日数は、10進値を使用して指定されます。たとえば、8.25は8日と6時間を指定します。統合キャプチャ・モードのExtractのチェックポイントがパージされる場合、チェックポイントに対応するアーカイブ済REDOログ・ファイルのLogMinerデータ・ディクショナリ情報がパージされ、キャプチャ・プロセスのfirst_scn値は次のアーカイブ済REDOログの最初の変更に対応するSCN値にリセットされます。デフォルト値は7日、最小値は0.00001です。

CHECKTABLELEVELSUPPLOG

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Extractは、Oracle GoldenGateサプリメンタル・ログ・グループを作成するためにADD TRANDATAコマンドが発行されていない表を検出した場合にレポート・ファイルに警告を送信します。CHECKTABLELEVELSUPPLOGでは、表のユーザー定義ログ・グループ内のキー列が、ADD TRANDATAコマンドで作成されたログ・グループのキー列と同じか、そのスーパーセットであるかどうかも検証されます。キー列がない場合、Extractは異常終了するか、欠落している列のフェッチを試行します。デフォルトでは、CHECKTABLELEVELSUPPLOG検証は無効になります。

COMPLETEARCHIVEDLOGONLY | NOCOMPLETEARCHIVEDLOGONLY

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Extractのデフォルトのアーカイブ・ログ処理をオーバーライドします。このパラメータは、本番(ソース)アーカイブ・ログをセカンダリ・データベースにコピーし、データ・ソースとして使用するときに適用します。一部のOracleプログラムは、最初のバイトから最後のバイトまで順序どおりにアーカイブ・ログを構築せずに、たとえばまず最初の500MB、次に最後の500MB、そして最後に中間の1000MBをコピーする場合があります。Extractは、最初のバイトから読取りを開始した場合、バイト・シーケンスが中断する部分に到達したときに異常終了します。ファイル全体が書き込まれるまで待機させることにより、この問題を防止できます。

Extractは、完全にディスクに書き込まれるのを待たずにアーカイブ・ファイルの読取りを開始しますが、完了前にデータの取得を開始するかどうかは、COMPLETEARCHIVEDLOGONLYとNOCOMPLETEARCHIVEDLOGONLYのどちらが使用されるかに依存することに注意してください。

COMPLETEARCHIVEDLOGONLY: これは、ALO (アーカイブ・ログ専用)モードのデフォルトです。アーカイブ・ログが完全にディスクに書き込まれるのを待ってから、ExtractにREDOデータの処理を開始させます。通常モードでは、これを使用してデフォルトのNOCOMPLETEARCHIVEDLOGONLYをオーバーライドします。
NOCOMPLETEARCHIVEDLOGONLY: これは通常モードのデフォルトです。Extractは、アーカイブ・ログが使用可能になると、完全にディスクに書き込まれるのを待たずに、即座にアーカイブ・ログからのREDOデータの処理を開始します。ALOモードでは、これを使用してデフォルトのCOMPLETEARCHIVEDLOGONLYをオーバーライドします。

COMPLETEARCHIVEDLOGTIMEOUT seconds

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

COMPLETEARCHIVEDLOGONLYモードのExtractが、REDOログが完全にディスクに書き込まれたかどうかを検証できないときに、検証の再試行を待機する秒数を制御します。このオプションは、TRANLOGOPTIONSのCOMPLETEARCHIVEDLOGONLYオプションとともに使用します。デフォルトでは、このオプションは無効化されており、Extractはファイルがディスクに書き込まれたかどうかを検証できない場合、10秒後に異常終了します。検証では、最後のブロックからブロック・ヘッダーを読み取り、予測される順序番号と照合することにより、最後のブロックが書き込まれたかどうかを判断します。secondsには、0よりも大きい任意の値を使用します。デフォルトは20です。

DB2APIRETRY number of retries

ExtractがDB2のログ読取りAPI db2ReadLog()からエラーを受け取った場合、特定のエラーについてはAPIコールが再試行されます。この再試行の回数は、DB2APIRETRYを使用して変更します。デフォルトの再試行回数は3に設定されています。APIが再試行されるSQLコードは、SQLCODE -30108です。

DB2ZV11COMPATIBILITYMODE

DB2 z/OSのExtractに有効です。

Oracle GoldenGateを使用して一部の互換性モードのDB2 z/OSバージョン11から抽出すると、Extractプロセスで実際のデータベースのバージョンがプログラムによって決定されず、OGG-00551またはOGG-00804エラーが発生する場合があります。このオプションをExtractパラメータ・ファイルで使用して、正しいデータベース・バージョンを手動で設定します。

DBLOGREADER

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Extractは、Oracle 11.2.0.2およびそれ以降の11g R2バージョン時点で使用可能な新しいAPIを使用します。このAPIは、データベース・サーバーを使用してREDOおよびアーカイブ・ログにアクセスします。DBLOGREADERを使用して、通常のディスクおよびRAWディスク上にログをマイニングでき、Oracle ASMインスタンスに直接接続するかわりに使用できます。使用するデータベース・システムは、このAPIモジュールを含むライブラリを含み、かつ実行中である必要があります。この機能を使用するには、Extractデータベース・ユーザーはSELECT ANY TRANSACTION権限を持っている必要があります。

DBLOGREADERを使用する場合、Extractは最大4MBの読取りサイズを使用できます。これは、DBLOGREADERBUFSIZEオプションで制御されます。デフォルトのOCIバッファを使用するときの最大読取りサイズは、28672バイトです。これは、ASMBUFSIZEオプションで制御されます。バッファを大きくすると、REDO率が高い場合にExtractのパフォーマンスが向上する可能性があります。

DBLOGREADERをASMとともに使用する場合は、TRANLOGOPTIONSのASMUSERまたはASMUSERALIASとASMPASSWORDオプションを使用しないでください。このAPIは、USERIDまたはUSERIDALIASパラメータで指定されたユーザーおよびパスワードを使用します。ASMでのOracle GoldenGateの使用の詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』のクラシック・キャプチャ・モードでのASMストアド・ログのマイニングに関する項を参照してください。

ノート:

REDOおよびアーカイブ・ログが通常のディスクまたはRAWデバイス上にある場合は、DBLOGREADERを使用することもできます。

DBLOGREADERBUFSIZE size

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

ASMでトランザクション・ログの各読取り結果を保持する内部バッファへの読取り操作の最大サイズ(バイト)を制御します。値を大きくすると取得速度は向上しますが、Extractはより多くのメモリーを消費します。値を小さくすると、メモリーの使用量は減りますが、Extractはキャッシュ・サイズを超えるデータをディスクに保持する必要があるため、I/Oは増加します。

ソースASMインスタンスがOracle 11.2.0.2およびそれ以降の11g R2バージョンの場合は、DBLOGREADERBUFSIZEをDBLOGREADERオプションとともに使用します。これらのリリースで新しいASM APIを使用すると、古いリリースの場合よりもパフォーマンスが向上します。Oracleのリリースがこれらのリリースのいずれかではない場合、ASMBUFSIZEを使用する必要があります。

次に、有効範囲とデフォルト・サイズ(バイト)を示します。

最小: REDOログの1ブロックのサイズ
最大: 4MB

AIXでは、最大バッファ・サイズが1048576の場合、この最大サイズを超えるバッファを読み取ろうとすると、エラーになります。
デフォルト: 2MB (2097152)

ほとんどのケースでは、デフォルト値で十分に機能するはずです。

BUFSIZEオプションの値は、常に少なくともDBLOGREADERBUFSIZEの値以上である必要があります。

DLFAILOVER_TIMEOUT seconds

Oracleの統合モードのExtractに有効です。

ロール・トランジション後にスタンバイ・データベースの復帰を許可するための、構成可能なタイムアウト(秒)を指定します。これはHANDLEDLFAILOVERと一緒に使用して、統合Extractがロール・トランジションの直後に起動できるようにします。タイムアウト期間の終了時にスタンバイ・データベースがまだ使用できない場合、Extractは終了します。

デフォルトは300秒です。センチ秒またはミリ秒も使用できます。

DISABLESOFTEOFDELAY

OracleおよびDB2 LUWの統合モードまたはクラシック・モードのExtractにのみ有効です。

Extractパラメータ・ファイルでDISABLESOFTEOFDELAYを使用して、返すレコードがない状態でEOFステータスが報告されると、待機時間が有効になるように設定します。

[EXCLUDETAG [tag | NULL] | [EXCLUDETAG +]

Oracleの統合モードまたはクラシック・モードのExtractに有効です。

EXCLUDETAG tagでは、指定したREDOログでタグ付けされた各レコードを無視するようにExtractプロセスに指示します。Oracle Databaseのすべてのリリースがタグ付けをサポートしているとはかぎりませんが、このパラメータにはデータベース・リリースの制限がありません。古いバージョンと比較すると、新しいトレイル・ファイルにはタグ・トークンが含まれ、古いトレイル・リーダーの問題は発生しません。

EXCLUDETAG +では、REDOログでタグ付けされた各レコードを無視するようにExtractプロセスに指示します。

各レコードをタグ付けするには、Replicatパラメータ・ファイルでSETTAGオプションを指定してDBOPTIONSパラメータを使用します。これらのパラメータを使用して、双方向構成のReplicatの個別のレコードのサイクル(ループバック)を防いだり、他のトランザクションの取得をフィルタリングします。デフォルトのSETTAG値は00です。有効な値は、単一のOracle Streamsタグまたはプラス記号(+)です。タグ値の最大長は、16進数の桁で2000 (0-9 A-F)です。dbms_streams.set_tag操作はEXCLUDETAGでサポートされています。Streamsタグの詳細は、『Oracle Streamsレプリケーション管理者ガイド』のOracle Streamsタグに関する項を参照してください。

EXCLUDETRANS transaction

Oracleの統合Extractに有効です。

Replicatデータベース・ユーザーまたは他の任意のユーザーのトランザクション名を指定し、Extractによるこれらのトランザクションの取得を防ぎます。双方向処理で、データベース間でのデータのループを防止するために使用します。

SybaseおよびSQL Serverにのみ有効です。Replicatで使用されるデフォルトのトランザクション名はggs_replです。双方向同期の詳細は、『Oracle GoldenGateの管理』のアクティブ/アクティブ構成の概要に関する項を参照してください。

EXCLUDEUSER user

DB2 LUW、DB2 for z/OS、DB2 for iおよびOracleに有効です。

GETREPLICATESまたはIGNOREREPLICATESパラメータのルール適用対象となるトランザクションを特定するフィルタとして使用する、Replicatデータベース・ユーザーまたは他の任意のユーザーの名前を指定します。通常このオプションは、双方向またはカスケード処理構成で、除外または取得するReplicatトランザクションを特定するために使用します。ただしこのパラメータは、特定のビジネス・アプリケーションなど、その他のユーザーのトランザクションの特定にも使用できます。

EXCLUDEUSERとEXCLUDEUSERIDは、同一のパラメータ・ファイルで使用できます。どちらのパラメータでもワイルドカードは使用しないでください。

ユーザー名は有効である必要があります。Oracle GoldenGateは、データベースに問い合せて関連するユーザーIDを取得し、この数値識別子をユーザー名にマップします。そのため、名前解決がデフォルトのDYNAMICRESOLUTIONに設定されているときに、指定されたユーザーが削除および再作成された場合、EXCLUDEUSERは有効のままです。名前解決がNODYNAMICRESOLUTIONに設定されているときに同一のトランザクションが実行された場合、EXCLUDEUSERは無効になるため、EXCLUDEUSERを有効にするためにExtractを停止および再起動する必要があります。詳細は、DYNAMICRESOLUTION | NODYNAMICRESOLUTIONを参照してください。

z/OS上のDB2での考慮事項: z/OS上のDB2では、このユーザーは常にトランザクションのプライマリ許可IDで、通常はログオンした元のRACFユーザーのIDですが、トランザクション・プロセッサまたはDB2イグジットによって変更されているときは、別の許可IDの場合もあります。
Oracleでの考慮事項: OracleおよびDB2 LUWデータベースでは、複数のEXCLUDEUSER文を使用できます。指定されたすべてのユーザーは、GETREPLICATESまたはIGNOREREPLICATESルールの対象になるという意味で、Replicatユーザーと同一とみなされます。他のすべてのサポート対象データベースとは異なり、適切に操作するにはEXCLUDEUSERにIGNOREAPPLOPSパラメータを含める必要があります。

EXCLUDEUSERID Database_uid

OracleのExtractに有効です。

GETREPLICATESまたはIGNOREREPLICATESパラメータのルール適用対象となるトランザクションを特定するフィルタとして使用する、Replicatデータベース・ユーザーまたは他の任意のユーザーのデータベース・ユーザーID (uid)を指定します。

使用方法はEXCLUDEUSERと同じです。

Oracle_uidは、負でない整数で、最大値は2147483638です。ユーザーIDを取得するために問い合せることのできるシステムはいくつかあります。最も簡便なものはALL_USERSビューです。Oracle GoldenGateは、ユーザーIDを検証しません。指定したユーザーIDに関連付けられているユーザーが削除および再作成された場合、このユーザーには新しいユーザーIDが割り当てられるため、このユーザーにはEXCLUDEUSERIDは無効になります。

FAILOVERTARGETDESTID n

OracleのExtractに有効です。

Oracle Data Guardスタンバイ・データベースにまだ適用されていないREDOデータを抽出しない処理に関して、どのスタンバイ・データベースの後にOracle GoldenGate Extractプロセスがとどまるようにする必要があるかを指定します。適切な値for_FAILOVERTARGETDESTIDを特定するには、archive_log_destdatabase初期化パラメータを適切なアーカイブ・ログ宛先識別子であるnとともに使用します。最小値は0、最大値は32、デフォルト値は0です。

FETCHLOBIFERROR

クラシック・キャプチャ・モードのOracleのExtractに有効です。

REDOログからのLOBキャプチャの結果が、不完全なデータなどのエラーになる場合、Extractのデフォルトの異常終了をオーバーライドします。REDOログからLOBを読み取る際にエラーが発生する場合、Extractに、データベースからLOBをフェッチさせます。

注意:

フェッチが発生する前に値が削除された場合、ExtractによってNULLがトレイルに書き込まれます。フェッチの前に値が更新された場合、Extractによって更新された値が書き込まれます。これらの不正を回避するには、Extractのレイテンシを少なくしてください。プロセスのパフォーマンスのチューニングの詳細は、『Oracle GoldenGateの管理』のOracle GoldenGateのパフォーマンスのチューニングに関する項のガイドラインを参照してください。また、フェッチ・オプションの設定方法は、「FETCHOPTIONS」を参照してください。

「FORCEFETCHLOB」オプションも参照してください。

FETCHPARTIALLOB

Oracleの統合キャプチャ・モードのExtractに有効です。

Oracle以外のターゲットにレプリケートする場合、またはLOBイメージ全体が必要なその他の場合にこのオプションを使用します。REDOレコードからの部分的な変更オブジェクトを使用せずに、Extractに完全なLOBオブジェクトをフェッチさせます。デフォルトでは、データベース・ログマイニング・サーバーは、ソースLOBのすべてが更新されたか一部が更新されたかに応じて、LOBの全体または一部をExtractに送信します。LOBのスナップショットが確実に正しいものになるように、Oracle Flashback機能を表に対して有効にし、Extractが使用するように構成する必要があります。ExtractのFETCHOPTIONSパラメータはフェッチを制御し、USESNAPSHOT (NOUSESNAPSHOTがない場合のデフォルト)に設定する必要があります。Flashbackスナップショットがない場合、Extractは表からLOBをフェッチしますが、REDOレコードが生成された時点とは異なるイメージである可能性があります。

FETCHINLINESFLOB

クラシックExtractでこのオプションを使用して、LOBの暗号化、圧縮、重複解除が行われていない場合でも、インラインSECUREFILE LOBに対してフェッチを強制します。FETCHINLINESFLOBの後で予期される値はありません。

FETCHPARTIALXML

統合キャプチャ・モードのOracleのExtractに有効です。

Oracle以外のターゲットにレプリケートする場合、またはLOBイメージ全体が必要なその他の場合にこのオプションを使用します。REDOレコードからの部分的な変更イメージを使用せずに、Extractに完全なXMLドキュメントをフェッチさせます。デフォルトでは、データベース・ログマイニング・サーバーは、ソースXMLのすべてが更新されたか一部が更新されたかに応じて、XMLドキュメントの全体または一部をExtractに送信します。XMLのスナップショットが確実に正しいものになるように、Oracle Flashback機能を表に対して有効にし、Extractが使用するように構成する必要があります。ExtractのFETCHOPTIONSパラメータはフェッチを制御し、USESNAPSHOT (NOUSESNAPSHOTがない場合のデフォルト)に設定する必要があります。Flashbackスナップショットがない場合、Extractは表からXMLドキュメントをフェッチしますが、REDOレコードが生成された時点とは異なるイメージである可能性があります。

FILTERTABLE table

MySQLのExtractに有効です。

このオプションでは、Replicatが使用するチェックポイント表の完全修飾名を指定します。チェックポイント表上の操作は、ソースへのデータのループバックを防止する手段として、ローカルExtractによって無視されます。チェックポイント表の作成の詳細は、『Oracle GoldenGateの管理』のチェックポイント表の作成に関する項を参照してください。オブジェクト名やワイルドカードを正しく指定するには、『Oracle GoldenGateの管理』のデータベース・オブジェクト名でのワイルドカードの使用に関する項を参照してください。

FORCEFETCHLOB

Oracleのクラシックおよび統合キャプチャ・モードのExtractに有効です。

REDOログからLOBデータを取得するデフォルトの動作をオーバーライドします。デフォルトでは、データベースからLOBをフェッチさせます。

注意:

フェッチが発生する前に値が削除された場合、ExtractによってNULLがトレイルに書き込まれます。フェッチの前に値が更新された場合、Extractによって更新された値が書き込まれます。これらの不正を回避するには、Extractのレイテンシを少なくしてください。Oracle GoldenGateドキュメントにプロセスのパフォーマンス・チューニングのガイドラインが記載されています。また、フェッチ・オプションの設定方法の詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』の表とDDLからのフェッチ間の相互作用に関する項を参照してください。

GETCTASDML | NOGETCTASDML

CREATE TABLE AS SELECT (CTAS)機能を有効にします。GETCTASDMLが有効な場合、CTAS DMLはLogMinerから送信され、ターゲットでレプリケートされます。CTAS DDLの実行はターゲットで抑止されます。このパラメータは、DDLメタデータ・トリガーの使用中は有効にできません。CTAS機能を有効にして生成されるトレイル・ファイルは、12.1.2.1.0未満のバージョンのReplicatでは使用できません。

GETCTASDMLでは、CTASでCTASの挿入をリプレイできるため、レプリケーション中にOIDを保持できます。このパラメータは、統合ディクショナリでのみサポートされるため、トレイルを使用するには、ダウンストリームReplicatが12.1.2.1以上である必要があり、そうでないと、相違が生じる場合があります。

HANDLEDLFAILOVER

Oracleの統合Extractのみに有効です。

ファスト・スタート・フェイルオーバー・スタンバイ・データベースの適用進捗に基づいて、Extractがトレイル・データの書込みを抑制するかどうかを制御します。この目的は、データ損失のフェイルオーバーに対してExtractを安全に保つことです。Data Guard構成のデータ損失に対して、これとファスト・スタート・フェイルオーバー(FSFO)を使用している場合は、ロール・トランジション後に、FAILOVERTARGETDESTID Extractパラメータを設定して、スタンバイを接続できる場所にアーカイブ・ログの宛先をID指定する必要があります。

IGNOREDATACAPTURECHANGES | NOIGNOREDATACAPTURECHANGES

DB2 LUWに有効です

DATA CAPTURE CHANGESが設定されていない表をExtractがキャプチャするかどうかを制御します。IGNOREDATACAPTURECHANGESは、DATA CAPTURE CHANGESが設定されていない表を無視します。表がワイルドカードで指定されている場合に、変更取得セットが含まれている表の処理を継続するために使用します。スキップされた表に対する警告がエラー・ログに発行されます。デフォルトはNOIGNOREDATACAPTURECHANGESです。

IGNOREDIRECTLOADINSERTS

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

ExtractにすべてのOracleダイレクト・ロードINSERTを無視させます。デフォルトの動作(このパラメータなし)では、Oracleダイレクト・ロードINSERTを取得します。このオプションは、Oracle 10g以上のログと互換性があるOracleログに適用されます。

INCLUDEAUX (AUX_specification)

Oracle GoldenGate VAMSERVコンポーネントに、監査証跡の読取り時に指定したAUXトレイルのみキャプチャするように指示します。このパラメータは、一部のAUXトレイルがキャプチャするデータを含まず無視できることがわかっている場合にパフォーマンスを向上させることができます。このパラメータでは、キャプチャするAUXトレイルのみ指定します。

AUX_specificationは、キャプチャするAUXトレイルを表す数値です。複数のAUXトレイルを指定するには、カンマ区切りリストを使用します。たとえば、次の文にはAUXトレイルBB & CC = 1, 2が含まれます。

TRANLOGOPTIONS INCLUDEAUX (1, 2)

MATのみ含めるかすべてのAUXトレイルを除外するには、次の例のようにカッコ内にスペースを1つ配置します。

TRANLOGOPTIONS INCLUDEAUX ( )

INCLUDEREGIONID | INCLUDEREGIONIDWITHOFFSET

Oracleのどちらのキャプチャ・モードのExtractにも有効です。

これらのオプションは、TZR (US/Pacificなどのタイムゾーン・リージョンを表す)として指定されたOracleデータ型TIMESTAMP WITH TIME ZONEをサポートします。デフォルトでは、Extractは、タイムゾーン・リージョンが含まれる場合、TIMESTAMP WITH TIME ZONEで異常終了します。これらのオプションにより、ターゲット・データベース・タイプに基づいて、このタイムスタンプを処理できます。

ソースのデータ型がTIMESTAMPで、リージョンIDマッピング・トークンがあることが検出された場合、Extractは次のようにタイムスタンプを適用します。

ターゲットのOracleリリースでサポートされている場合、TIMESTAMP WITH TIME ZONEとTZRが適用されます。
Oracle以外のデータベース、または、TIMESTAMP WITH TIME ZONEとTZRをサポートしていない以前のリリースのOracleには、タイムスタンプとUTCオフセットが適用されます。

INCLUDEREGIONID: Oracleソースから、同じリリース以降のOracleターゲットにレプリケートする場合に使用します。INCLUDEREGIONIDを指定すると、Extractは、列索引と2バイトのTMZ値をタイムゾーン・マッピング・トークンとして追加し、それをYYYY-MM-DD HH:MI.SS.FFFFFF +00:00のUTCフォーマットでトレイルに出力します。
INCLUDEREGIONIDWITHOFFSET: v10g以降のOracleソースから10gより前のOracleターゲットに、または、OracleソースからOracleデータベースではないターゲットに、TZRとしてTIMESTAMP WITH TIME ZONEをレプリケートする場合に使用します。INCLUDEREGIONIDWITHOFFSETを指定すると、Extractは、タイムゾーン・リージョン値を、日時に基づいて夏時間を考慮する時間オフセットに変換します。タイムスタンプ・データは、ローカル時間で、YYYY-MM-DD HH:MI.SS.FFFFFF TZH:TZM (TZH:TZMは時間オフセットに変換されたリージョンID)のフォーマットで、トレイルに書き込まれます。

LOB_CHUNK_SIZE

SQL Server CDCキャプチャ方法で有効です。

LOB_CHUNK_SIZEは、ラージ・オブジェクトをサポートするCDCキャプチャ方法のために追加された新しいパラメータです。LOBデータのサイズが大きい場合、LOB_CHUNK_SIZEをデフォルトの4000バイトから最大で65535バイトまで調整できます。このようにフェッチ・サイズを増やすと、LOB全体をフェッチするために必要なトリップ回数が減少します。

例: TRANLOGOPTIONS LOB_CHUNK_SIZE 8000

INTEGRATEDPARAMS (parameter value [, ...])

Oracle StandardまたはEnterprise Edition 11.2.0.3以降の統合キャプチャ・モードのExtractに有効です。

Extractが統合キャプチャ・モードの場合、パラメータと値をOracle Databaseログマイニング・サーバーに渡します。入力は次のようにparameter valueの形式である必要があります。

TRANLOGOPTIONS INTEGRATEDPARAMS (downsream_real_time_mine Y)

有効なparameter指定とその値は次のとおりです。

max_sga_size: データベース・ログマイニング・サーバーによって使用されるSGAメモリーの量を指定します。正の整数をMB単位で指定できます。streams_pool_sizeが1GBより大きい場合、デフォルトは1GBです。それ以外の場合、streams_pool_sizeの75%がデフォルトになります。
parallelism: データベース・ログマイニング・サーバーをサポートしているプロセスの数を指定します。正の整数を指定できます。デフォルトは2です。
downstream_real_time_mine: 統合キャプチャがダウンストリーム・マイニング・データベースをリアルタイム・モードでマイニングするかどうかを指定します。値Yでは、リアルタイムの取得を指定し、スタンバイREDOログがダウンストリーム・マイニング・データベースで構成されている必要があります。値Nは、ダウンストリーム・マイニング・データベースに転送されたアーカイブ・ログから取得することを指定します。デフォルトはNです。
enable_procedural_replication: キャプチャでのプロシージャ・レプリケーションを有効にします。プロシージャ・レプリケーションはデフォルトでは無効です。値Yでプロシージャ・レプリケーションが有効になります。このオプションをいったんExtractでオンにすると、そのままになります。このパラメータ値を元に戻すことはできません。

LOGRETENTION [ENABLED [DAYS n] | SR | DISABLED]

Oracle Enterprise Editionのクラシック・キャプチャ・モードのExtractに有効です。

Extractがリカバリに必要とするログ・ファイルをOracle Recovery Manager (RMAN)が保持するかどうかを指定します。REGISTER EXTRACTコマンドを使用している場合、現在のデータベースSCNに基づいて、コマンドが発行された時点からログを保持します。ログは、手動で削除するまで保持されます。このパラメータは、データベース自体の中のRMANを有効化または無効化しません。

LOGRETENTIONに関するその他の情報:

Oracleフラッシュ・リカバリ記憶域がいっぱいの場合、Extractで必要とされていても、RMANによってアーカイブ・ログがパージされます。この制限は、Extract (および他のOracleレプリケーション・コンポーネント)の要件がデータベースへのREDOの可用性を妨げないようにするために存在します。
Extractに割り当てられていて、USERIDまたはUSERIDALIASパラメータで指定されているデータベース・ユーザーは、DBLOGINパラメータに必要な権限と同じ権限を持っている必要があります。
LOGRETENTIONでは、基盤の(ただし機能しない) Oracle Streamsキャプチャ・プロセスを利用します。そのため、データベースはOracleのEnterprise Editionリリース11g以上である必要があります。Oracle Standard EditionおよびExpress Editionはこの機能をサポートしていません。LOGRETENTION機能は、他のStreamsインストールと同時に動作できます。

ノート:

Oracle RACでRMANログ保存をサポートするには、Extractグループを追加する前にBUGFIX 11879974で提供されているデータベース・パッチをダウンロードおよびインストールする必要があります。

ENABLED [DAYS n]

ログ保持機能を有効化します。OracleデータベースのExtractがアーカイブ・ログ専用(ALO)モードの場合を除いて、これはデフォルトです。REGISTER EXTRACTコマンドをLOGRETENTIONオプションとともに使用して、Extractをデータベースに登録する必要があります。

デフォルトでは、ENABLEDはBounded RecoveryチェックポイントのSCNを適用し、そのポイントまで(そのポイントも含む)のログを保持します。このチェックポイントは、オープンしている最も古いnon-persistedトランザクションのログ・ファイルを表します。Bounded Recoveryの問題が永続データに影響する場合、オープンしている最も古いトランザクションを再処理するのに必要なログが使用できる必要があります。

DAYSオプションを使用すると、特定の日数(1から365までの整数)の間、ログを保持できます。DAYSのデフォルトは7日間です。

より保守的にするには、かわりにSRオプションを使用できます。Bounded Recovery機能の詳細は、BRを参照してください。

SR

ログ保持機能を有効化しますが、Extractが標準(通常)リカバリ・モードに戻るのに必要なログのSCNまで(そのSCNも含む)のログを保持します。標準モードでは、Extractは、メモリーにあったオープンしている最も古いトランザクションを含むログにアクセスする必要があります。SRを使用することは、Bounded Recoveryモード(デフォルト)で保持されるログより多いログを保持する保守的な方法ですが、Bounded Recoveryが失敗した場合にデータの可用性を確認します。REGISTER EXTRACTコマンドをLOGRETENTIONオプションとともに使用して、Extractをデータベースに登録する必要があります。

DISABLED

ログ保持機能を無効化します。OracleソースのExtractがアーカイブ・ログ専用(ALO)モードで動作している場合、これはデフォルト設定ですが、必要に応じてオーバーライドできます。REGISTER EXTRACTコマンドを使用してExtractを登録した場合は、ログ保持の無効化後にUNREGISTER EXTRACTコマンドを使用して関連するExtractグループをデータベースから登録解除します。

LOGSOURCE platform, [PATHMAP path]

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

REDOログまたはアーカイブ・ログ、またはその両方が、データベースをホストしているプラットフォーム以外のプラットフォームに保持されているときに、そのオペレーティング・システムおよびパス名(オプション)を指定します。LOGSOURCEを使用するときは、TRANLOGOPTIONS文全体を1行にまとめてください。アンパサンド(&)行終了文字を使用して行を複数に分割しないでください。

platform

REDOまたはアーカイブ・ログをホストするプラットフォームを指定します。有効な値は次のとおりです。

AIX
HPUX
LINUX
MVS
SOLARIS
VMS
WINDOWS
S390

正しいデータ位置を保持するために、指定したplatformとExtractを実行するプラットフォームは、エンディアン・オーダーとビット幅(32ビット、64ビットなど)が同一である必要があります。次に互換性のあるエンディアン・プラットフォームを示します。

ビッグ・エンディアン: AIX、HPUX、MVS、SOLARIS、S290
リトル・エンディアン: LINUX、VMS、WINDOWS

たとえば、ExtractをHPUXで実行している場合、LOGSOURCE platformをAIXに設定すると有効ですが、LINUXは無効です。

PATHMAP path

ログへのパスを指定します。

MAXWARNEOF seconds

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

警告メッセージを生成するまで、Extractが新しいログ・ファイルを待機する秒数を指定します。Extractは、特定の順序番号に対して警告メッセージを1つのみ生成します。MAXWARNEOFを指定しない場合、Extractはデフォルトで1時間待機します。値0を指定すると、Extractが待機した時間にかかわらず、警告メッセージは生成されません。最小値は0、デフォルト値は3600です。

MAXAUTOCMTTRANSSIZE (range, default)

DB2 for iにのみ有効です。

自動コミット・トランザクションの最大サイズの範囲を指定します。

DB2 for iの自動コミット・レコード(ジャーナル・エントリのCCIDが0と等しいもの)には、ジャーナル内のコミット・レコードがありません。そのため、Oracle GoldenGateでは、そうしたレコードを証跡に含めるために暗黙的なトランザクションを作成する必要があります。デフォルトでは複数のレコードを単一のトランザクションに含めることができますが、レコードごとに示されるIO時間の精度が損なわれます。これは、IO時間がトランザクションのコミットに基づいているためです。これにより、こうしたレコードの処理の全体的な効率が向上します。

このパラメータでは、暗黙的に作成されるトランザクションに含めるレコードの最大数を設定しますが、最大値に到達する前にジャーナル内で別のタイプのエントリが見つかった場合は、その数が少なくなることがあります。この動作によって、明示的にコミットされたレコードに属するレコードでチェックポイントが重複する問題を回避します。

このパラメータの値を1に設定すると、潜在的にExtractのスループットが低下しますが、自動コミットされるレコード(ジャーナル・エントリのCCIDが0)の証跡内の各レコードの正確なIO時間が示されます。このパラメータの値は、これらのレコードのトランザクションがメモリーにキャッシュされる可能性のある最大サイズにも影響します。この値を小さい値に設定すると、Extractが暗黙的なトランザクションごとにエントリの最大数を格納できる場合は、トランザクション・メモリーが少なくなります。定義により、そのような暗黙的なトランザクションは常に1つのみ存在できます。これは、その他のトランザクション・レコードでは、すでにメモリー内に存在する暗黙的なトランザクションに含まれるレコードの証跡への即時コミットが発生するためです。

デフォルトの範囲は1から10000です。デフォルト値は1000です。

MINEFROMACTIVEDG

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

ExtractでREDOをActive Data Guardインスタンスからマイニングできるように指定します。このパラメータがないと、Extractは異常終了してエラーになります。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。MINEFROMACTIVEDGはDBLOGREADERをサポートせず、ASMストレージでのREDOログの読取りについてASMUSERのみをサポートします。

MININGUSER {/ | user} [, MININGPASSWORD password]

[algorithm ENCRYPTKEY {key_name | DEFAULT}] [SYSDBA]]

Oracleの統合キャプチャ・モードのExtractに有効です。

ログマイニング・サーバーとやり取りするダウンストリームOracleマイニング・データベースにログインするための、Extractのログイン資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されていない場合にMININGUSERALIASオプションのかわりに使用できます。

ユーザーは、次を満たす必要があります。

dbms_goldengate_auth.grant_admin_privilegeで付与される権限を持っている。
このMININGUSERALIASに関連付けられているExtractグループに、MININGDBLOGINまたはMININGDBLOGINALIASおよびREGISTER EXTRACTまたはUNREGISTER EXTRACTコマンドを発行するユーザーである。
Extractが統合キャプチャ・モードである間は変更されない。

/

データベース・ユーザー・ログインではなく、Oracle用のオペレーティングシステム・ログインを使用するようにOracle GoldenGateに指示します。この引数は、データベースによってオペレーティングシステム・レベルでの認証が許可されている場合にのみ使用します。データベースレベルの認証をバイパスすることにより、アプリケーションのパスワードが頻繁に変更される場合に、Oracle GoldenGateパラメータ・ファイルを更新する必要がなくなります。

このオプションを使用するには、Oracle OS_AUTHENT_PREFIX初期化パラメータの値との関連で、正しいユーザー名がデータベースに存在している必要があります。OS_AUTHENT_PREFIXで指定されている値は、ユーザーのオペレーティング・システム・アカウント名の先頭に追加され、データベース名と比較されます。この2つの名前は一致する必要があります。

OS_AUTHENT_PREFIXが' ' (NULL文字列)に設定されている場合は、ユーザー名をIDENTIFIED EXTERNALLYとして作成する必要があります。たとえば、OSユーザー名がoggの場合は、次のようにしてデータベース・ユーザーを作成します。

CREATE USER ogg IDENTIFIED EXTERNALLY;

OS_AUTHENT_PREFIXがOPS$または別の文字列に設定されている場合は、ユーザー名は次のフォーマットで作成する必要があります。

OS_AUTHENT_PREFIX_value OS_user_name

たとえば、OSユーザー名がoggの場合は、次のようにしてデータベース・ユーザーを作成します。

CREATE USER ops$ogg IDENTIFIED BY oggpassword;

user

マイニング・データベース・ユーザー名またはSQL*Net接続文字列を指定します。

password

ユーザーのパスワードです。データベース・ユーザーのパスワードを指定するためにデータベース認証が必要な場合に使用します。パスワードがENCRYPT PASSWORDコマンドによって暗号化されている場合は、暗号化されたパスワードを指定します。それ以外の場合は、クリアテキストのパスワードを使用します。パスワードに大/小文字の区別がある場合は、そのように入力してください。ユーザーIDまたはパスワードのいずれかが変更されると、必要に応じて、パスワードの再暗号化など、Oracle GoldenGateパラメータ・ファイルの変更を行う必要があります。

algorithm

ENCRYPT PASSWORDでパスワードの暗号化に使用した暗号化アルゴリズムを指定します。次のいずれかになります。

AES128
AES192
AES256
BLOWFISH

ENCRYPTKEY {key_name | DEFAULT}

ENCRYPT PASSWORDで指定した暗号化キーを指定します。

ENCRYPTKEY key_nameは、ENCKEYS参照ファイル内のユーザー作成の暗号化キーの論理名を指定します。ENCRYPT PASSWORDがKEYNAME key_nameオプションとともに使用された場合に使用します。
ENCRYPTKEY DEFAULTを指定すると、Oracle GoldenGateでランダムなキーが使用されます。ENCRYPT PASSWORDがKEYNAME DEFAULTオプションとともに使用された場合に使用します。

SYSDBA

ユーザーがsysdbaとしてログインするように指定します。

MINEFROMSNAPSHOTSTBY | NOMINEFROMSNAPSHOTSTBY

Oracleに有効です。

スナップショット・スタンバイ・データベースによってアーカイブされたREDOからOracle GoldenGateがキャプチャできるかどうかを制御します。MINEFROMSNAPSHOTSTBYを使用すると、クラシック・キャプチャ・モードまたは統合キャプチャ・モードで、Extractをアップストリーム構成でスナップショット・スタンバイに対して実行できますが、スナップショット・スタンバイ・データベースは、そのREDOログを別のデータベースに転送しないため、ダウンストリーム構成での実行はサポートされていません。

デフォルトはNOMINEFROMSNAPSHOTSTBYであり、Extractはスナップショットであるデータベースから取得できません。Extractを物理スタンバイ・データベースに対して実行できず、そのソース・スナップショット・データベースを物理データベースに変更するとExtractは異常終了します。

MININGUSERALIAS alias

Oracleの統合キャプチャ・モードのExtractに有効です。

ログマイニング・サーバーとやり取りするダウンストリームOracleマイニング・データベースにログインするためにExtractが使用するログイン資格証明の別名を指定します。Oracle GoldenGate資格証明ストアが使用されている場合にMININGUSERのかわりに使用できます。

この別名は、次を満たす必要があります。

ローカルOracle GoldenGate資格証明ストアに格納されているデータベース・ユーザー・ログイン資格証明に関連付けられている。このユーザーは、dbms_goldengate_auth.grant_admin_privilegeで付与された権限を持っている必要があります。
このMININGUSERALIASに関連付けられているExtractグループのMININGDBLOGINまたはMININGDBLOGINALIASおよびREGISTER EXTRACTまたはUNREGISTER EXTRACTコマンドを発行するユーザーである。

この別名とユーザーは、Extractが統合キャプチャ・モードである間は変更しないでください。

MIXEDENDIAN [ON|OFF]

Oracle GoldenGateプライマリExtractと使用のDB2 LUWで有効

DB2 LUWのためのOracle GoldenGate Extractは、データベースとOracle GoldenGateが異なるバイト・オーダーのサーバーで稼働している状況でのクロスエンディアン・キャプチャをサポートしています。DB2 LUW データベース・バージョン10.5以上では、自動的にバイト・オーダーが検出されます。DB2 LUW 10.5の自動検出を無効にする必要がある場合は、このパラメータを指定することで上書きできます。バージョン10.1の場合は、クロスエンディアン・キャプチャのためにExtractパラメータ・ファイルでこのパラメータを使用する必要があります。デフォルトでは、バージョン10.1用の値はOFFに設定されています。

構文:

TRANLOGOPTIONS MIXEDENDIAN [ON|OFF]

ON: この設定の場合、ExtractはデータベースとOracle GoldenGateが異なるバイト・オーダーのサーバーで稼働していて、必要なバイト反転変換が実行されると見なします。

OFF: この設定の場合、ExtractはデータベースとOracle GoldenGateが同じバイト・オーダーのサーバーで稼働していて、バイト・オーダーの反転変換が実行されないと見なします。

NOFLUSH

DB2 z/OSに有効です。

ログ・バッファのフラッシュを防止します。

NOMANAGECDCCLENUP | MANAGECDCCLEANUP

SQL Serverに有効です。

CDCキャプチャ方法のSQL Server表のサプリメンタル・ロギング有効にする際には、CDCステージング表と他のCDCシステム表のデータをパージする必要があります。Oracle GoldenGate CDCクリーン・アップ・ジョブかSQL Server CDCクリーンアップ・ジョブのいずれかを使用して、これらの表をパージします。デフォルトでは、Extractの開始時にMANAGECDCCLEANUPは有効化されており、Extractに対してOracle GoldenGate CDCクリーン・アップ・ジョブの存在をチェックするように指示します。このアプローチをお薦めします。デフォルトでは、Extractはogg_cdc_cleanup_setup.batプログラムを使用してOracle GoldenGate CDCクリーン・アップ・ジョブが作成されている必要があります。そうでないとExtractが開始されません。

NOMANAGECDCCLEANUPオプションは、ExtractにOracle GoldenGate CDCクリーン・アップ・ジョブの存在をチェックしないよう指示します。

PATHMAP NFS_mount_point log_path

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

REDOログまたはアーカイブ・ログ、またはその両方が、データベースをホストしているシステム以外のシステムに保持されているときに、その場所を指定します。複数のPATHMAP文を使用できます。PATHMAPを使用するときは、TRANLOGOPTIONS文全体を1行にまとめてください。アンパサンド(&)行終了文字を使用して行を複数に分割しないでください。

PATHMAPは、このシステムがデータベースをホストしているシステムとは異なるプラットフォームの場合に、LOGSOURCEオプションとともに使用できます。

NFS_mount_point: ログが格納されるリモート・システムのNFSマウント・ポイントを指定します。
log_path: リモート・システム上のログのパス。パスはマウント・ポイント指定に従う必要があります。

PREPAREFORUPGRADETOIE | NOPREPAREFORUPGRADETOIE

Oracle用のOracle RACでクラシックExtractから統合Extractにアップグレードする場合に有効です。

Oracle RACでクラシックExtractから統合Extractにアップグレードする場合は、アップグレード対象のクラシックExtractを停止する前にPREPAREFORUPGRADETOIEオプションを設定し、アップグレードを続行する前に、パラメータが有効になっていることを示すレポート・ファイルの情報メッセージが表示されるまで待機する必要があります。アップグレード手順の詳細は、『Oracle GoldenGateのアップグレード』を参照してください。

PREPAREFORUPGRADETOIE

Extractパラメータ・ファイルのPREPAREFORUPGRADETOIEを設定するか(Extractの再起動が必要)、このコマンドを使用してGGSCIからExtractを実行できるように、動的に設定できます。

SEND EXTRACT extract_name TRANLOGOPTIONS PREPAREFORUPGRADETOIE

NOPREPAREFORUPGRADETOIE

必要に応じて、PREPAREFORUPGRADETOIEオプションを動的に無効にします。デフォルトはNOPREPAREFORUPGRADETOIEです。

PERFORMANCEPROFILE HIGH|MEDIUM

統合キャプチャ・モードのExtractに有効です。

統合キャプチャをチューニングします。HIGHおよびMEDIUM (デフォルト)に設定できます。パフォーマンスに影響するパラメータをまとめることで、パフォーマンスの向上に役立ちます。パフォーマンス・プロファイルをいったん設定すると、必要なスループットとレイテンシを達成するように、このオプションによって関連するパラメータが自動的に構成されます。

PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Oracle RACノードに障害が発生し、Extractがロールバックを取得できないときに発生する孤立トランザクションのパージを制御します。

PURGEORPHANEDTRANSACTIONS: 孤立したトランザクションをパージします。トランザクションは、パージの実行前に、自身の開始時間とノードの開始時間の比較によって孤立しているかどうかが検証され、ノードよりも開始時間が早いトランザクションはパージされます。
NOPURGEORPHANEDTRANSACTIONS: デフォルトです。孤立したトランザクションはパージされません。

QUERYTIMEOUT number

SQL Serverに有効です。

SQL Serverへの問合せで、タイムアウト・エラー・メッセージを報告するまでに結果を待機する時間を指定します。このオプションは整数値を使用して秒数を表します。デフォルトの問合せタイムアウト値は30秒です。最小値は0秒です(無限タイムアウト)。最大値は2147483645秒です。

次の例では、SQL Serverがタイムアウトまでに結果を60秒待つように指示しています。

TRANLOGOPTIONS QUERYTIMEOUT 60

QUERYRETRYCOUNT number

SQL ServerのExtractに有効です。

タイムアウト後に表のメタデータを取得するために問合せを再試行する回数を指定します。表を作成した長時間に及ぶトランザクションでは、タイムアウトが発生することがあります。システム表はロックされ、Extractの問合せは完了できなくなります。

デフォルトは、30秒の待機後に1回の再試行で、この再試行が失敗するとプロセスは異常終了します。 QUERYRETRYCOUNTでは、指定される入力値に従って30秒間隔で複数回再試行するように指定できます。すべての再試行が失敗すると、Extractは通常の接続エラー・メッセージとともに異常終了します。最小値(0)は無限です。最大値は1000です。デフォルトは1です。

次の例では、Extractは30秒間隔で4回問合せを試行します。

TRANLOGOPTIONS QUERYRETRYCOUNT 4

READQUEUESIZE size

MySQLに有効です。

トランザクション・データの内部キューのサイズをバイト単位で指定します。これによりパフォーマンスが向上します。有効な値は、1から214748364750000までの整数です。デフォルトは256バイトです。高い値に調整する前に、デフォルトから開始して、パフォーマンスを評価してください。

REDO_TRANSPORT_LAG_THRESHOLD seconds

ダウンストリーム・マイニング・モードの統合Extractに有効です。

REDOログが転送されるときに、ソース・データベースとターゲット・データベース間のネットワーク・レイテンシをモニタリングします。レイテンシが指定されたしきい値を超えると、レポート・ファイルに警告が表示され、ラグが通常レベルまで減少すると後続の情報メッセージが表示されます。

デフォルトのしきい値は10秒です。

詳細は、ソースからダウンストリーム・マイニング・データベースへのREDO転送の構成に関する項を参照してください

REQUIRELONGDATACAPTURECHANGES | NOREQUIRELONGDATACAPTURECHANGES

DB2 LUWに有効です。

DATA CAPTUREがNONE、またはINCLUDE LONGVAR COLUMNSのないCHANGESに設定され、パラメータ・ファイルに、一部またはすべての列値のビフォア・イメージを必要とするOracle GoldenGateパラメータ(GETBEFOREUPATES、NOCOMPRESSUPDATESおよびNOCOMPRESSDELETES)が含まれている場合に、Extractの応答を制御します。この2つのDATA CAPTURE設定では、LONGVAR列のビフォア値が記録されません。Extractがこれらの列を使用できない場合、ターゲット・データの整合性に影響が及ぶことがあります。

REQUIRELONGDATACAPTURECHANGES: Extractはエラーとともに異常終了します。
NOREQUIRELONGDATACAPTURECHANGES: Extractは警告を出しますが、データ・レコードの処理を継続します。

SOURCE_OS_TIMEZONE timezone

Oracleの統合キャプチャ・モードのExtractに有効です。

ソース・データベースのシステム・タイムゾーンを指定します。通常、データベースのシステム・タイム・ゾーンはオペレーティング・システムのデフォルトのタイムゾーンによって指定されますが、データベースの起動時にTZ環境変数を設定することでオーバーライドできます。このオプションは、ソース・データベースとExtractプロセスで別のシステム・タイムゾーンを使用する場合にのみ指定する必要があります。たとえば、ソース・データベースとExtractプロセスが異なるタイムゾーンの別のサーバー上で実行される、ダウンストリーム・キャプチャのデプロイメントの場合です。

このオプションの値はタイムゾーンのリージョン名またはUTCオフセット・フォームで指定できます。ソース・データベースで使用されるフォームと同じものを使用する必要があります。たとえば、ソース・データベースがAmerica/New_Yorkのようなリージョン名のフォームを使用する場合は、America/New_York、US/EasternまたはEST5EDTを指定する必要があります。また、ソース・データベースが-05:00のようなUTCオフセット・フォームを使用する場合は、構文(GMT)[+|-]hh[:mm]を使用する必要があります。たとえば、GMT-05:00または-5。

SUPPRESSNOOOPUPDATES

Oracle Database 12c (12.2)以降のExtractに有効です。

統合Extractでno-op更新をフィルタリングするかどうかを制御できます。デフォルトでは抑制されません。

TRANSCLEANUPFREQUENCY minutes

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Oracle GoldenGateが孤立トランザクションのスキャン、再スキャン、および削除の一連の動作を実行する間隔(分)を指定します。最初のスキャンでは、孤立していると思われるトランザクションをマーク付けします。2回目のスキャンで孤立していることを確認し、次にこれらのトランザクションを削除します。有効な値は1から43200分です。デフォルトは10分です。

TRANCOUNT

SQL Serverに有効です。

SQL Serverの表から一度にフェッチされるトランザクションの数を指定できます。トランザクションの数を表す整数値を指定します。最小値は1、最大値は100です。デフォルトは10です。

例:

TRANLOGOPTIONS TRANCOUNT 20

この例では、CDCが有効な表から一度に20件のトランザクションをフェッチするようにExtractに指示しています。

[TSLOOKUPBEGINLRI | TSLOOKUPENDLRI]

DB2 LUW v10.1以降に有効です。

これらのパラメータを使用してLRI範囲を指定すると、Extractは、ADDまたはALTER EXTRACTコマンドで指定したタイムスタンプをこの範囲内で検索します。これにより、Extractは、データベース・トランザクション・ログの特定のタイムスタンプの参照プロセスを最適化できます。TSLOOKUPBEGINLRIパラメータは必須ですが、TSLOOKUPENDLRIはオプションです。TSLOOKUPBEGINLRIなしでTSLOOKUPENDLRIのみを指定することは無効です。次に例を示します。

TRANLOGOPTIONS TSLOOKUPBEGINLRI 75200.666197, TSLOOKUPENDLRI  75207.666216 
TRANLOGOPTIONS TSLOOKUPBEGINLRI 75200.666197

指定されたLRI範囲の間で指定したタイムスタンプが失敗する場合、または指定したタイムスタンプがTSLOOKUPBEGINLRI LRIタイムスタンプの後に失敗する場合、Extractは、指定したタイムスタンプと等しいか、直前のタイムスタンプのレコードから起動します。

指定したタイムスタンプがTSLOOKUPBEGINLRI LRIタイムスタンプの前に失敗する場合、Extractは、指定したTSLOOKUPBEGINLRI LRIから起動されます。指定したタイムスタンプがTSLOOKUPENDLRIタイムスタンプの後に失敗する場合、Extractは異常終了します。TSLOOKUPENDLRIのみを指定すると、情報メッセージが表示され、Extractは、指定したタイムスタンプと等しいか、直前のタイムスタンプのレコードから起動します。

USENATIVEOBJSUPPORT | NOUSENATIVEOBJSUPPORT

Oracleの統合キャプチャ・モードのExtractに有効です。

統合キャプチャでは、ユーザー定義型(UDT)およびANYDATAデータ型のREDOベースのキャプチャが追加されています。これは、デフォルトで有効で、ソース・データベースのバージョンが12.1.0.1以上で、ソース・データベースの互換性が12.0.0.0.0以上の場合にのみ有効にできます。Oracle GoldenGateリリース12.1.2.1.0以降のReplicatを使用する必要があります。リリース12.1.0.1のソースまたはターゲット・データベースが使用されている場合、Oracle Bug#18038108のStreamsパッチをデータベースにインストールする必要があります。ネイティブ・サポートを使用するには、互換性を確保するため、すべてのOracleデータベースおよびOracle GoldenGateインスタンスがリリース12.1.0.1以上である必要があります。

REDOベースのキャプチャが有効になっているが、サポートされていない属性がUDTに含まれている場合、統合キャプチャはフェッチを使用してUDTのキャプチャを再試行します。キャプチャのサポートの制限の詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』のXMLデータ型に関する項を参照してください。CREATE TABLE AS SELECT (CTAS)文を使用してオブジェクト表を作成する場合は、オブジェクト表を完全にサポートするために、CTAS操作からDMLをキャプチャするように統合キャプチャを構成する必要があります。CTASの使用の詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』のOracle GoldenGateの導出オブジェクト名の処理方法に関する項を参照してください。

デフォルトはUSENATIVEOBJSUPPORTです(サポートされている場合)。

USE_ROOT_CONTAINER_TIMEZONE

このパラメータはCDB環境用です。CDB内の各PDBは、異なるデータベース・タイムゾーンを使用できます。データベース・タイムゾーンが使用可能な場合、Extractは統合ディクショナリからPDBのタイムゾーンを取得しようとします。タイムゾーン抽出には、マイニング・データベースでのパッチが必要です。パッチが使用可能でない場合、Extractはタイムゾーンを取得するためにPDBに問合せを送信します。データベース・パッチまたはPDBへの接続が使用可能でなく、このパラメータが指定されている場合、Extractによって、PDBデータベース・タイムゾーンはルート・コンテナのデータベース・タイムゾーンと同じであるとみなされます。

USEPREVRESETLOGSID | NOUSEPREVRESETLOGSID

Oracleのクラシック・キャプチャ・モードのExtractに有効です。

Extractが前のRESETLOG IDを現在のブランチとして取得するように指定します。デフォルトはNOUSEPREVRESETLOGSIDです。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。

VALIDATEINLINESFLOB

このオプションをクラシックExtractで使用して、REDO列値からLOBデータを抽出したときにインラインSECUREFILE LOBを検証します。VALIDATEINLINESFLOBの後で予期される値はありません。

VAMCOMPATIBILITY {3}

MySQL、SQL ServerおよびTeradataに有効です。

VAMモジュールとVAM APIが、必ず同じバージョンの列メタデータ構造を使用するようにします。新機能がVAM APIに追加されるにしたがい、列メタデータには新しい属性による拡張が必要になります。この状態が発生すると、新規バージョンが作成され、新規の列メタデータ属性が既存の属性に追加されます。新規バージョンの追加後、Teradata以外のすべてのデータベース実装が最新バージョンに更新することを求められます。最小値は1、最大値は1、デフォルト値は1です。

1: 値1は元のVAM APIメタデータ構造が使用中であることを意味します。この構造は元々Teradata用に作成され、他のデータベースとは別々の実装であり、Teradataのみが依然としてこのレベルを使用します。Extractとの下位互換性を維持するため、以前のバージョンのTAMモジュールを、VAMバージョニングが含まれる以後のリリースのExtractに対して実行中の場合、手動でVAMCOMPATIBILITYを1に設定することが必要なときがあります。VAMCOMPATIBILITY 1が必須なのに設定されていない場合、Extractはレポート・ファイルへのメッセージを示して異常終了します。
2: このVAMバージョンはSQL Serverの列メタデータ構造を追加しました。この値はVAMモジュールによって内部で設定されるため、TRANLOGOPTIONSを使用した手動設定は必要ありません。
3: これは現在のバージョン・レベルです。Teradata以外のすべてのデータベース(SQL Serverを含む)はこのレベルを使用し、VAMモジュール内で内部で設定するため、TRANLOGOPTIONSを使用した手動設定は必要ありません。

例

例1

次の例では、Oracleアーカイブ・ログの場所を指定します。

TRANLOGOPTIONS ALTARCHIVELOGDEST /fs1/oradata/archive/log2

例2

次のOracle例は、2人のユーザーを(1人は名前、1人はユーザーIDで)フィルタ処理します。これらのユーザーによって生成されたトランザクションは、GETREPLICATESまたはIGNOREREPLICATESルールに従って処理され、新しいトランザクション・バッファ・サイズが指定されます。

TRANLOGOPTIONS EXCLUDEUSER ggsrep, EXCLUDEUSERID 90, BUFSIZE 100000

例3

次に、データベースをホストするプラットフォームと別のプラットフォーム上にあるトランザクション・ログを処理する方法を示します。

ノート:

この文は、このドキュメントのスペースの制約によって、複数の行にまたがっています。

TRANLOGOPTIONS, LOGSOURCE VMS, PATHMAP DKA200:[RDBMS.ORACLE.ORA9201I.64.ADMIN.GGS.ARCH]
/net/deltan/uservol1/RDBMS.DIR/ORACLE.DIR/ORA9201I.DIR/
64.DIR/admin.DIR/ggs.DIR/ARCH.dir PATHMAP DKA200:[RDBMS.ORACLE.ORA9201I.64.ORADATA.GGS] 
/net/deltan/uservol1/rdbms.dir/oracle.dir/ora9201I.DIR/
64.dir/oradata.dir/ggs.dir

例4

次の例は、Oracle GoldenGate資格証明ストアのasmdomainドメインに別名asm1を指定することでASM資格証明を指定します。

TRANLOGOPTIONS ASMUSERALIAS asm1 DOMAIN asmdomain

例5

次の例は、ExtractがALTARCHIVELOGFORMATパラメータでフォーマット指定子%T、%Sおよび%Rを使用してアーカイブ・ログ名を形成する際の埋込み幅を指定する方法を示します。

TRANLOGOPTIONS ALTARCHIVELOGFORMAT ARC_%S_%R.%T
TRANLOGOPTIONS SEQPADLEN 12, RESETLOGSIDPADLEN 12, THREADPADLEN 5

例6

次の例は、EXCLUDETAGを使用してタグ指定子を使用する方法です。

TRANLOGOPTIONS EXCLUDETAG 00
TRANLOGOPTIONS EXCLUDETAG +
TRANLOGOPTIONS EXCLUDETAG 0952

例7

次の例では、TRANLOGOPTIONS FAILOVERTARGETDESTID Extractパラメータの使用方法を示します。

TRANLOGOPTIONS FAILOVERTARGETDESTID 2

SQL> show parameters log_archive_dest

NAME TYPE VA 
LUE 
------------------------------------ ----------- -- 
---------------------------- 
log_archive_dest_1 string location=USE_DB_RECOVERY_FILE_DEST, 
valid_for=(ALL_LOGFILES, ALL_ROLES) 
. 
log_archive_dest_2 string service="ggs2d", ASYNC NOAFFIRM delay=0 optional 
compression =disable max_failure=0 max_connections=1 reopen=300 
db_unique_name="GGS2D" net_timeout=30, 
valid_for=(online_logfile,all_roles)

2に設定される理由は、Oracle GoldenGateが後にとどまる必要のあるスタンバイ・データベースだからです。1番目のエントリ(log_archive_dest_1)はそのデータベースのローカル・アーカイブ・ログ用で、2番目のエントリはスタンバイ・データベース00用です

親トピック: Oracle GoldenGateパラメータ