| Oracle® Fusion Middleware Oracle GoldenGateリファレンスfor Windows and UNIX 12c (12.2.0.1) E70112-04 |
|
![]() 前 |
![]() 次 |
適用対象
Extract
説明
TRANLOGOPTIONSパラメータでは、Extractと、トランザクション・ログまたはトランザクション・データを渡すAPI(データベースやキャプチャ・モードによって異なる)とのやり取り方法を制御します。TRANLOGOPTIONS文を同一のパラメータ・ファイル内で複数回使用することも、(オプションに許可されている場合は)同一のTRANLOGOPTIONS文内で複数のオプションを指定することもできます。
各TRANLOGOPTIONSオプションは、対象のデータベースに対してのみ使用してください。
デフォルト
なし
構文
TRANLOGOPTIONS {
[{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN} width]
[ADGTIMEOUT seconds]
[ACTIVESECONDARYTRUNCATIONPOINT | MANAGESECONDARYTRUNCATIONPOINT | NOMANAGESECONDARYTRUNCATIONPOINT]
[ALLOWTABLECOMPRESSION]
[ALTARCHIVEDLOGFORMAT string] [INSTANCE instance] [THREADID id]
[ALTARCHIVELOGDEST [PRIMARY] [INSTANCE instance] path]
[ALTARCHIVELOGONLY ('path' FILESPEC 'file_pattern']
[[[NOT] RECURSIVE] [PRIMARY])]
[ALTLOGDEST path]
[ARCHIVEDLOGONLY]
[{ASMBUFSIZE size | DBLOGREADERBUFSIZE size}]
[ASMUSER SYS@ASM_instance, ASMPASSWORD password
[algorithm ENCRYPTKEY {key_name | DEFAULT}]
[ASMUSERALIAS alias [DOMAIN domain]]
[ASYNCTRANSPROCESSING buffer_size | NOASYNCTRANSPROCESSING]
[BUFSIZE size]
[CHECKPOINTRETENTIONTIME days]
[CHECKTABLELEVELSUPPLOG]
[COMPLETEARCHIVEDLOGONLY]
[COMPLETEARCHIVEDLOGTIMEOUT seconds]
[DBLOGREADER]
[DBLOGREADERBUFSIZE size]
[EXCLUDETAG [tag | NULL] | [EXCLUDETAG +]
[EXCLUDETRANS transaction]
[EXCLUDEUSER user]
[EXCLUDEUSERID Oracle_uid]
[FAILOVERTARGETDESTID n]
[FETCHLOBIFERROR]
[FETCHPARTIALLOB]
[FETCHPARTIALXML]
[FILTERTABLE table]
[FORCEFETCHLOB]
[GETCTASDML | NOGETCTASDML]
[HANDLEDLFAILOVER]
[IGNOREDATACAPTURECHANGES | NOIGNOREDATACAPTURECHANGES]
[IGNOREDIRECTLOADINSERTS]
[INCLUDEAUX (AUX_specification)]
[INCLUDEREGIONID | INCLUDEREGIONIDWITHOFFSET]
[INTEGRATEDPARAMS (parameter [, ...])]
[LOGRETENTION [ENABLED | SR | DISABLED]
[LOGSOURCE platform, [PATHMAP path]]
[MAXREADSIZE records]
[MAXWARNEOF seconds]
[MINEFROMACTIVEDG | NOMINEFROMACTIVEDG]
[MINEFROMSNAPSHOTSTBY | NOMINEFROMSNAPSHOTSTBY]
[MININGUSER {/ | user}[, MININGPASSWORD password]
[algorithm ENCRYPTKEY {key_name | DEFAULT}] [SYSDBA]
[MININGUSERALIAS alias [DOMAIN domain]]
[NODDLCHANGEWARNING]
[NOFLUSH]
[PATHMAP NFS_mount_point log_path]
[PREPAREFORUPGRADETOIE | NOPREPAREFORUPGRADETOIE]
[PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS]
[QUERYRETRYCOUNT number] |
[READQUEUESIZE size]
[READTIMEOUT milliseconds]
[REQUIRELONGDATACAPTURECHANGES | NOREQUIRELONGDATACAPTURECHANGES]
[TRANSCLEANUPFREQUENCY minutes]
[TSLOOKUPBEGINLRI | TSLOOKUPENDLRI]
[USENATIVEOBJSUPPORT | NOUSENATIVEOBJSUPPORT]
[USEPREVRESETLOGSID | NOUSEPREVRESETLOGSID]
[USE_ROOT_CONTAINER_TIMEZONE]
[VAMCOMPATIBILITY {1 | 2 | 3}]
}
[, ...]
{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN} width(Oracle)クラシック・キャプチャ・モードのExtractに有効です
ExtractがALTARCHIVELOGFORMATパラメータでフォーマット指定子%A、%D、%T、%Sおよび%Rを使用してアーカイブ・ログ名を形成する際に最小のデフォルト埋込み長を指定します。対応する数値がフィールド幅より小さい場合は、左にゼロが埋め込まれます。表3-35に、各オプションに関連する指定子とデフォルトの長さを示します。
表3-35 アーカイブ・ログ指定子とデフォルトの埋込み長
| オプション | 指定子 | デフォルトの埋込み長 |
|---|---|---|
|
%A |
8 |
|
%D |
8 |
|
%T |
Windowsでは3、その他のプラットフォームでは4 |
|
%S |
Windowsでは5、その他のプラットフォームでは10 |
|
%R |
10 |
ADGTIMEOUT seconds(Oracle)クラシック・キャプチャ・モードのExtractに有効です
v$database.current_scnが処理する必要のあるレコードに関連付けられたコミットSCNを過ぎていない場合にExtractがタイムアウトになる間隔を秒単位で設定します。デフォルトは30秒です。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。
ACTIVEMANAGESECONDARYTRUNCATIONPOINT | MANAGESECONDARYTRUNCATIONPOINT | NOMANAGESECONDARYTRUNCATIONPOINT(SQL ServerおよびSybase) 2次切捨てポイントの管理方法を制御します。
ACTIVESECONDARYTRUNCATIONPOINTSQL Serverに有効で、Sybaseではサポートされていません。
ExtractがSQL Serverトランザクション・レプリケーションまたはOracle以外の変更データ取得(CDC)実装と並行して実行されない場合、または非ネイティブSQL Serverログ・バックアップがデータベースに対して取られない場合、ACTIVESECONDARYTRUNCATIONPOINTを使用します。これによってExtractでは、一度捕捉されたトランザクションを配布済とマーキングすることで、2次切捨てポイントを管理できるようになります。MANAGESECONDARYTRUNCATIONPOINTモードの場合と異なり、ACTIVESECONDARYTRUNCATIONPOINTモードのExtractはトランザクション・ログ・バックアップから読み取りません。したがって、どこのサードパーティのトランザクション・ログ・バックアップ・ソフトウェアでも使用できます。この構成で2次切捨てポイントを管理するExtractは1つだけのため、同じデータベースから取得する複数のExtractグループがある場合は、ACTIVESECONDARYTRUNCATIONPOINTを使用しないでください。
MANAGESECONDARYTRUNCATIONPOINTSQL ServerおよびSybaseに有効です。
SQL Serverの使用方法: ExtractがSQL Serverトランザクション・レプリケーションまたはOracle以外のCDC実装と平行して実行されない場合、MANAGESECONDARYTRUNCATIONPOINTを使用します。これによってOracle GoldenGateでは、ハイウォータ・マーク(このマークより古いトランザクションは配布済と想定される)を使用して2次切捨てポイントを保持できるようになります。
このメソッドでは、データベース・トランザクション・ログがExtractによって使用可能および読取り可能であることが必要です。トランザクション・ログ・バックアップ要件の詳細は、SQL ServerのためのOracle GoldenGateのインストールおよび構成を参照してください。このパラメータを、同じデータベースに対する複数Extract構成内の少なくとも1つのExtractで使用する場合は、すべてのExtractグループで使用する必要があります。
Sybaseの使用方法: ExtractがSybase Replication Serverと平行して実行されない場合、MANAGESECONDARYTRUNCATIONPOINTを使用します。これによってExtractでは2次切捨てポイントを管理できるようになります。
NOMANAGESECONDARYTRUNCATIONPOINTSQL ServerおよびSybaseに有効です。
SQL Serverの使用方法: ExtractがSQL Serverトランザクション・レプリケーションまたはOracle以外のCDC実装と平行して実行される場合、NOMANAGESECONDARYTRUNCATIONPOINTを使用します。SQL Serverレプリケーションに2次切捨てポイントを管理させます。このパラメータを、同じデータベースに対する複数Extract構成内の少なくとも1つのExtractで使用する場合は、すべてのExtractグループで使用する必要があります。
Sybaseでの使用: NOMANAGESECONDARYTRUNCATIONPOINTは、Sybaseトランザクション・ログを切り捨てないときに使用します。Extractは2次切捨てポイントを管理しません。このオプションは、Extractがデバッグ目的で以前のログ位置からSybaseトランザクション・ログの再読取りを行う必要があるときに使用できます。
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 instanceOracle 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(SQL Server) クラシック・キャプチャ・モードのExtractに有効です。
デフォルト以外の場所に存在するときに、Extractにアーカイブ・ログまたはバックアップOracleトランザクション・ログの場所を示します。Extractはまず指定された場所を確認し、次にデフォルトの場所を確認します。
path代替ディレクトリのアーカイブ・ログの完全修飾パスを指定します。このディレクトリは、Oracle GoldenGateが実行されているノードにNFSマウントされている必要があります。このマウント・ポイントをALTARCHIVELOGDESTに使用します。
PRIMARY代替場所でログが見つからない場合に、Extractがデフォルトのログの場所を確認することを防ぎます。ALTARCHIVELOGDESTパスのみが確認されます。PRIMARYは、アーカイブ・ログ専用(ALO)モードで実行しているExtractのデフォルトで、それ以外の場合にはオプションです。
INSTANCE instance指定したALTARCHIVELOGDEST動作を特定のOracleインスタンスに適用します。RACでこのオプションを使用する場合は、各ノードにALTARCHIVELOGDESTパラメータを指定する必要があります。
THREADID id指定されたALTARCHIVELOGDEST動作を特定のスレッド番号に適用します。
ALTARCHIVELOGONLY ("path" [FILESPEC "file_pattern"][[NOT] RECURSIVE])(Oracle)
Extractは、msdb表をログ・バックアップの場所に問い合せるのではなく、この場所以外のOracleトランザクション・ログ・バックアップから読み取ります。このパラメータは、ログ・バックアップが元の宛先から移動されている場合に使用します。
パラメータ引数はカッコで囲みます。
"path"パス名を二重引用符で囲んでログ・バックアップに指定します。最後のバックスラッシュ(\)・デリミタの後に、ワイルドカード記号を使用できます。アスタリスク(*)は、ゼロまたはそれ以上の文字と一致します。疑問符(?)は一文字と一致します。
NOT RECURSIVEを使用している場合は、このオプションを使用しないでください。
FILESPEC "file_pattern""path"で指定したバックアップ・パス内のファイル・パターンを指定します。ファイル・パターンは二重引用符で囲みます。アスタリスク(*)は、ゼロまたはそれ以上の文字と一致します。疑問符(?)は一文字と一致します。
バックスラッシュ(\)・デリミタは使用しないでください。バックスラッシュを使用すると他のパスも指定できますが、これは無効です。
[NOT] RECURSIVE"path" で指定されているファイルを再帰的に検索(すべてのサブディレクトリも検索)するかどうかを指定します。
ALTARCHIVELOGDEST ("path”[[NOT] RECURSIVE])(SQL Server)
デフォルトで、Extractは、MSDBデータベースに問い合せて必要なトランザクション・ログ・バックアップのディスク上の名前と場所を確認します(ACTIVESECONDARYTRUNCATIONPOINTを使用している場合は除く)。なんらかの理由でログ・バックアップが元の場所から移動していたり、リモート共有のパスとして参照される必要がある場合(リモート・サーバー上でALOモードで稼働中のExtractの場合)、ALTARCHIVELOGDESTオプションを使用して新しいトランザクション・ログのネーミング規則またはファイル拡張子を指定します(このどちらかが変更されている場合)。
パラメータ引数はカッコで囲みます。SQL ServerのExtractパラメータ・ファイルには、1つのTRANLOGOPTIONS ALTARCHIVELOGDESTエントリのみ指定できます。複数のエントリが存在する場合は、最後のエントリのみが使用されます。
ALTLOGDEST path(MySQL)
MySQLのログ索引ファイルの場所を指定します。Extractは、データベースのデフォルトの場所ではなく、この場所でログ・ファイルを探します。データベース構成にログの完全パス名が含まれていない場合、またはマシンに複数のMySQLがインストールされている場合に、ALTLOGDESTを使用できます。Extractではログ索引ファイルを読み取り、読取りが必要なバイナリ・ログ・ファイルが検索されます。ALTLOGDESTを使用する場合、Extractでは、ログと索引は同じ場所にあるとみなされます。
ディレクトリの完全パス名を指定します。Windowsでは、次の例のように、パスに空白が含まれる場合にパスを二重引用符で囲みます。
TRANLOGOPTIONS ALTLOGDEST "C:\Program Files\MySQL\MySQL Server 5.1\log\test.index"
ARCHIVEDLOGONLY(SQL Server) クラシック・キャプチャ・モードのExtractに有効です。
ARCHIVEDLOGONLYを使用すると、Extractはトランザクション・ログ・バックアップから排他的に読み取ります。このパラメータはExtractをアーカイブ・ログ専用(ALO)モードに設定し、データベース・サーバー以外の異なるWindowsサーバー上でExtractを実行できるようにします。ALOモードはACTIVESECONDARYTRUNCSTIONPOINTパラメータと互換性がありません。アーカイブ・ログ専用モードの詳細は、『SQL ServerのためのOracle GoldenGateのインストールおよび構成』を参照してください。
(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ブロックのサイズ
最大: 4 MB
デフォルト: 2 MB (2097152)
BUFSIZEオプションの値は、常に少なくともDBLOGREADERBUFSIZEの値以上である必要があります。
ASMUSER SYS@ASM_instance, ASMPASSWORD password [algorithmENCRYPTKEY {key_name | DEFAULT}](Oracle) クラシック・キャプチャ・モードのExtractに有効です。
トランザクション・ログを読み取るASMインスタンスにログインするための資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されていない場合にASMUSERALIASのかわりに使用できます。
SYS@ASM_instance接続文字列のASMインスタンスを指定します。ユーザーはSYSである必要があります。
passwordENCRYPT PASSWORDコマンドの結果からコピーした暗号化パスワードです。
algorithmパスワードの暗号化に使用した暗号化アルゴリズムを、AES128、AES192、AES256またはBLOWFISHの中から指定します。
ENCRYPTKEY key_nameENCKEYS参照ファイル内のユーザー作成の暗号化鍵の論理名を指定します。ENCRYPT PASSWORDがKEYNAME key_nameオプションとともに使用された場合に使用します。
ENCRYPTKEY DEFAULT指定すると、Oracle GoldenGateでランダムな鍵が使用されます。ENCRYPT PASSWORDがKEYNAME DEFAULTオプションとともに使用された場合に使用します。
注意:
このパラメータは、標準のUSERIDパラメータのかわりには使用できません。ASM環境では、両方のパラメータが必要です。ASMUSERは、ログを読み取るためにDBLOGREADERオプションを使用している場合は不要です。
パスワード・セキュリティ機能の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
ASMUSERALIAS alias [DOMAIN domain](Oracle) クラシック・キャプチャ・モードのExtractに有効です。
トランザクション・ログを読み取るASMインスタンスにログインするための資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されている場合にASMUSERのかわりに使用できます。
aliasASMインスタンスへのログインに使用されるログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。使用する別名が不明な場合は、INFO CREDENTIALSTOREコマンドを発行して資格証明ストアの内容を調べることができます。INFO CREDENTIALSTOREを参照してください。
DOMAIN domain資格証明ストア内の指定した別名に割り当てるドメインを指定します。
資格証明ストアの詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
注意:
このパラメータは、標準のUSERIDALIASパラメータのかわりには使用できません。ASM環境では、両方のパラメータが必要です。ASMUSERALIASは、ログを読み取るためにDBLOGREADERオプションを使用している場合は不要です。
ASYNCTRANSPROCESSING buffer_size | NOASYNCTRANSPROCESSING(Oracle) 統合キャプチャ・モードのExtractに有効です。
統合キャプチャを非同期処理モードで実行するか、同期処理モードで実行するかを制御し、Extractが非同期モードの場合のバッファ・サイズを制御します。
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:
最小: 40,960
最大: 33,554,432
デフォルト: 131,072
前述の値は、4096ページ・サイズの倍数である必要があります。指定された値がこの要件を満たさない場合、Extractは値を切り捨てて倍数にします。
システム管理者に依頼して、新しいバッファ・サイズをサポートするために十分なECSA領域を確保してください。
CHECKPOINTRETENTIONTIME days(Oracle) 統合モードのExtractのみに有効です。
パージされる前にExtractがチェックポイントを保持する日数を制御します。部分的な日数は、10進値を使用して指定されます。たとえば、8.25は8日と6時間を指定します。統合キャプチャ・モードのExtractのチェックポイントがパージされる場合、チェックポイントに対応するアーカイブ済REDOログ・ファイルのLogMinerデータ・ディクショナリ情報がパージされ、キャプチャ・プロセスのfirst_scn値は次のアーカイブ済REDOログの最初の変更に対応するSCN値にリセットされます。デフォルトは7日です。キャプチャ・チェックポイントの詳細は、を参照してください。
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よりも大きい任意の値を使用します。
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のインストールおよび構成を参照してください。 注意:
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ブロックのサイズ
最大: 4 MB
AIXでは、最大バッファ・サイズが1048576の場合、この最大サイズを超えるバッファを読み取ろうとすると、エラーになります。
デフォルト: 2 MB (2097152)
ほとんどのケースでは、デフォルト値で十分に機能するはずです。
BUFSIZEオプションの値は、常に少なくともDBLOGREADERBUFSIZEの値以上である必要があります。
[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タグの詳細は、を参照してください。
EXCLUDETRANS transaction(統合Extract、Sybase、SQL Server)
Replicatデータベース・ユーザーまたは他の任意のユーザーのトランザクション名を指定し、Extractによるこれらのトランザクションの取得を防ぎます。双方向処理で、データベース間でのデータのループを防止するために使用します。
Replicatが使用するデフォルトのトランザクション名はggs_replですが、EXCLUDETRANSでは任意のトランザクションを指定できます。双方向同期の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
EXCLUDEUSER user(DB2 LUW、DB2 z/OS、Oracle、Sybase)
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データベースでは、複数のEXCLUDEUSER文を使用できます。指定されたすべてのユーザーは、GETREPLICATESまたはIGNOREREPLICATESルールの対象になるという意味で、Replicatユーザーと同一とみなされます。他のすべてのサポート対象データベースとは異なり、適切に操作するにはEXCLUDEUSERにIGNOREAPPLOPSパラメータを含める必要があります。
EXCLUDEUSERID Database_uid(Informix、Oracle) Extractに有効です。
GETREPLICATESまたはIGNOREREPLICATESパラメータのルール適用対象となるトランザクションを特定するフィルタとして使用する、Replicatデータベース・ユーザーまたは他の任意のユーザーのデータベース・ユーザーID (uid)を指定します。GETREPLICATESまたはIGNOREREPLICATESパラメータはInformixではサポートされません。
使用方法は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とともに使用します。
FETCHLOBIFERROR(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
REDOログからのLOBキャプチャの結果が、不完全なデータなどのエラーになる場合、Extractのデフォルトの異常終了をオーバーライドします。REDOログからLOBを読み取る際にエラーが発生する場合、Extractに、データベースからLOBをフェッチさせます。
注意:
フェッチが発生する前に値が削除された場合、ExtractによってNULLがトレイルに書き込まれます。フェッチの前に値が更新された場合、Extractによって更新された値が書き込まれます。これらの不正を回避するには、Extractのレイテンシを少なくしてください。チューニング・プロセスのパフォーマンスについては、Oracle GoldenGateの管理for Windows and UNIXのガイドラインを参照してください。また、フェッチ・オプションの設定方法は、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レコードが生成された時点とは異なるイメージである可能性があります。
FETCHPARTIALXML(Oracle) 統合キャプチャ・モードのExtractに有効です。
Oracle以外のターゲットにレプリケートする場合、またはLOBイメージ全体が必要なその他の場合にこのオプションを使用します。REDOレコードからの部分的な変更イメージを使用せずに、Extractに完全なXMLドキュメントをフェッチさせます。デフォルトでは、データベース・ログマイニング・サーバーは、ソースXMLのすべてが更新されたか一部が更新されたかに応じて、XMLドキュメントの全体または一部をExtractに送信します。XMLのスナップショットが確実に正しいものになるように、Oracle Flashback機能を表に対して有効にし、Extractが使用するように構成する必要があります。ExtractのFETCHOPTIONSパラメータはフェッチを制御し、USESNAPSHOT (NOUSESNAPSHOTがない場合のデフォルト)に設定する必要があります。Flashbackスナップショットがない場合、Extractは表からXMLドキュメントをフェッチしますが、REDOレコードが生成された時点とは異なるイメージである可能性があります。
ADGAPPLYCHECKFREQ secondsOracleの統合Extractに有効です。ADGのキャッチ・アップを確認する各フェッチ・チェック間でExtractが待機する秒数を指定します。数値を小さくするとレイテンシは向上しますが、current_scn from v$databaseの問合せ数は増加します。デフォルト値は3秒で、最大値は120秒です。
ADGCRETRYCOUNT numberOracleの統合Extractに有効です。ADGのキャッチ・アップの待機時に、ExtractがADGの進捗または進捗がない理由を報告するまでの、Extractの試行回数を指定します。この値にFETCHCHECKFREQを乗算することで、ADGの進捗を報告するおおよその頻度が決まります。
FILTERTABLE table(MySQLおよびSQL/MXのExtract)
このオプションでは、Replicatが使用するチェックポイント表の完全修飾名を指定します。チェックポイント表上の操作は、ソースへのデータのループバックを防止する手段として、ローカルExtractによって無視されます。チェックポイント表の作成の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。オブジェクト名とワイルドカードを正しく指定するには、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
FORCEFETCHLOB(Oracle)クラシックおよび統合キャプチャ・モードのExtractに有効です。
REDOログからLOBデータを取得するデフォルトの動作をオーバーライドします。デフォルトでは、データベースからLOBをフェッチさせます。
注意:
フェッチが発生する前に値が削除された場合、ExtractによってNULLがトレイルに書き込まれます。フェッチの前に値が更新された場合、Extractによって更新された値が書き込まれます。これらの不正を回避するには、Extractのレイテンシを少なくしてください。Oracle GoldenGateドキュメントにプロセスのパフォーマンス・チューニングのガイドラインが記載されています。また、フェッチ・オプションの設定方法は、Oracle DatabaseのためのOracle GoldenGateのインストールおよび構成を参照してください。
GETCTASDML | NOGETCTASDMLCREATE 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オフセットが適用されます。
INCLUDEREGIONIDOracleソースから、同じリリース以降のOracleターゲットにレプリケートする場合に使用します。INCLUDEREGIONIDを指定すると、Extractは、列索引と2バイトのTMZ値をタイムゾーン・マッピング・トークンとして追加し、それをYYYY-MM-DD HH:MI.SS.FFFFFF +00:00のUTCフォーマットでトレイルに出力します。
INCLUDEREGIONIDWITHOFFSETv10g以降のOracleソースから10gより前のOracleターゲットに、または、OracleソースからOracleデータベースではないターゲットに、TZR としてTIMESTAMP WITH TIME ZONEをレプリケートする場合に使用します。INCLUDEREGIONIDWITHOFFSETを指定すると、Extractは、タイムゾーン・リージョン値を、日時に基づいて夏時間を考慮する時間オフセットに変換します。タイムスタンプ・データは、ローカル時間で、YYYY-MM-DD HH:MI.SS.FFFFFF TZH:TZM (TZH:TZMは時間オフセットに変換されたリージョンID)のフォーマットで、トレイルに書き込まれます。
INTEGRATEDPARAMS (parameter value [, ...])(Oracle) 統合キャプチャ・モードのExtractに有効です(Oracle StandardまたはEnterprise Edition 11.2.0.3以降)。
Extractが統合キャプチャ・モードの場合、パラメータと値をOracleデータベース・ログマイニング・サーバーに渡します。入力は次のように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です。
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パラメータに必要な権限と同じ権限を持っている必要があります。詳細は、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グループをデータベースから登録解除します。詳細は、UNREGISTER EXTRACTを参照してください。
LOGSOURCE platform, [PATHMAP path](Oracle) クラシック・キャプチャ・モードのExtractに有効です。
REDOログまたはアーカイブ・ログ、またはその両方が、データベースをホストしているプラットフォーム以外のプラットフォームに保持されているときに、そのオペレーティング・システムおよびパス名(オプション)を指定します。LOGSOURCEを使用するときは、TRANLOGOPTIONS文全体を1行にまとめてください。アンパサンド(&)行終了文字を使用して行を複数に分割しないでください。
platformREDOまたはアーカイブ・ログをホストするプラットフォームを指定します。有効な値:
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ログへのパスを指定します。
MAXREADSIZE recordsSybaseに有効です。
Extractでトランザクション・ログから一度に読み取られるレコードの数を指定します。パフォーマンスの向上に使用できます。有効な値は、1から50000までの整数です。デフォルトは256レコードです。このパラメータを高い値に調整するときは注意してください。これにより、Extractが2次切捨てポイントを調整する頻度が減り、ログ・データが蓄積されることがあります。高い値に調整する前に、10000から開始して、パフォーマンスを評価してください。
MAXWARNEOF seconds(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
警告メッセージを生成するまで、Extractが新しいログ・ファイルを待機する秒数を指定します。Extractは、特定の順序番号に対して警告メッセージを1つのみ生成します。MAXWARNEOFを指定しない場合、Extractはデフォルトで1時間待機します。値0を指定すると、Extractが待機した時間にかかわらず、警告メッセージは生成されません。
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パラメータ・ファイルの変更を行う必要があります。
algorithmENCRYPT 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としてログインするように指定します。
Oracle GoldenGateのセキュリティ・オプションの詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
MINEFROMSNAPSHOTSTBY | NOMINEFROMSNAPSHOTSTBY(Oracle)スナップショット・スタンバイ・データベースによりアーカイブされたREDOからOracle GoldenGateが取得できるかどうかを制御します。MINEFROMSNAPSHOTSTBYを使用すると、クラシック・キャプチャ・モードまたは統合キャプチャ・モードで、Extractをアップストリーム構成でスナップショット・スタンバイに対して実行できますが、スナップショット・スタンバイ・データベースは、そのREDOログを別のデータベースに転送しないため、ダウンストリーム構成での実行はサポートされていません。
デフォルトはNOMINEFROMSNAPSHOTSTBYであり、Extractはスナップショットであるデータベースから取得できません。Extractを物理スタンバイ・データベースに対して実行できず、そのソース・スナップショット・データベースを物理データベースに変更するとExtractは異常終了します。
MININGUSERALIAS alias(Oracle) 統合キャプチャ・モードのExtractに有効です。
ログマイニング・サーバーとやり取りするダウンストリームOracleマイニング・データベースにログインするためにExtractが使用するログイン資格証明の別名を指定します。Oracle GoldenGate資格証明ストアが使用されている場合にMININGUSERのかわりに使用できます。
この別名は、次を満たす必要があります。
ローカルOracle GoldenGate資格証明ストアに格納されているデータベース・ユーザー・ログイン資格証明に関連付けられている。資格証明ストアの詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。このユーザーは、dbms_goldengate_auth.grant_admin_privilegeで付与された権限を持っている必要があります。
このMININGUSERALIASに関連付けられているExtractグループのMININGDBLOGINまたはMININGDBLOGINALIASおよびREGISTER EXTRACTまたはUNREGISTER EXTRACTコマンドを発行するユーザーである。
この別名とユーザーは、Extractが統合キャプチャ・モードである間は変更しないでください。
NODDLCHANGEWARNING(SQL Server)
Extractがデータを取得するソース・オブジェクトにDDL操作が実行されたときに、Extractが警告を記録することを防ぎます。デフォルトは警告のレポートであるため、問題を修正できます。Oracle GoldenGateは、SQL ServerのDDLキャプチャとレプリケーションをサポートしないため、ソースとターゲットのメタデータが一定に保たれる必要があります。DDL変更によってExtractが異常終了しなくても、このような変更が発生するたびに警告が記録されます。NODDLCHANGEWARNINGを使用すると、Oracle GoldenGateログにこのようなメッセージが蓄積されることを防止できます。
NOFLUSH(DB2 z/OS)
ログ・バッファのフラッシュを防止します。
PATHMAP NFS_mount_point log_path(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
REDOログまたはアーカイブ・ログ、またはその両方が、データベースをホストしているシステム以外のシステムに保持されているときに、その場所を指定します。複数のPATHMAP文を使用できます。PATHMAPを使用するときは、TRANLOGOPTIONS文全体を1行にまとめてください。アンパサンド(&)行終了文字を使用して行を複数に分割しないでください。
PATHMAPは、このシステムがデータベースをホストしているシステムとは異なるプラットフォームの場合に、LOGSOURCEオプションとともに使用できます。
PREPAREFORUPGRADETOIE | NOPREPAREFORUPGRADETOIE (Oracle) Oracle RACでクラシックExtractから統合Extractにアップグレードする場合に有効です。
Oracle RACでクラシックExtractから統合Extractにアップグレードする場合は、アップグレード対象のクラシックExtractを停止する前にPREPAREFORUPGRADETOIEオプションを設定し、アップグレードを続行する前に、パラメータが有効になっていることを示すレポート・ファイルの情報メッセージが表示されるまで待機する必要があります。アップグレード手順の詳細は、『Oracle GoldenGate Oracle GoldenGateのアップグレードfor Windows and UNIX』を参照してください。
PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
Oracle RACノードに障害が発生し、Extractがロールバックを取得できないときに発生する孤立トランザクションのパージを制御します。
QUERYRETRYCOUNT number(SQL ServerのExtract)
タイムアウト後に表のメタデータを取得するために問合せを再試行する回数を指定します。表を作成した長時間に及ぶトランザクションでは、タイムアウトが発生することがあります。システム表はロックされ、Extractの問合せは完了できなくなります。
デフォルトは、30秒の待機後に1回の再試行で、この再試行が失敗するとプロセスは異常終了します。 QUERYRETRYCOUNTでは、指定される入力値に従って30秒間隔で複数回再試行するように指定できます。すべての再試行が失敗すると、Extractは通常の接続エラー・メッセージとともに異常終了します。
次の例では、Extractは30秒間隔で4回問合せを試行します。
TRANLOGOPTIONS QUERYRETRYCOUNT 4
READQUEUESIZE sizeMySQLおよびSybaseに有効です。
トランザクション・データの内部キューのサイズをバイト単位で指定します。これによりパフォーマンスが向上します。有効な値は、3から1500までの整数です。デフォルトは256バイトです。高い値に調整する前に、デフォルトから開始して、パフォーマンスを評価してください。
REQUIRELONGDATACAPTURECHANGES | NOREQUIRELONGDATACAPTURECHANGES(DB2 LUW)
DATA CAPTUREがNONE、またはINCLUDE LONGVAR COLUMNSのないCHANGESに設定され、パラメータ・ファイルに、一部またはすべての列値のビフォア・イメージを必要とするOracle GoldenGateパラメータ(GETBEFOREUPATES、NOCOMPRESSUPDATESおよびNOCOMPRESSDELETES)が含まれている場合に、Extractの応答を制御します。この2つのDATA CAPTURE設定では、LONGVAR列のビフォア値が記録されません。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は、指定したタイムスタンプと等しいか、直前のタイムスタンプのレコードから起動します。
TRANSCLEANUPFREQUENCY minutes(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
Oracle GoldenGateが孤立トランザクションのスキャン、再スキャン、および削除の一連の動作を実行する間隔(分)を指定します。最初のスキャンでは、孤立していると思われるトランザクションをマーク付けします。2回目のスキャンで孤立していることを確認し、次にこれらのトランザクションを削除します。有効な値は1から43200分です。デフォルトは10分です。
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 GoldenGate Oracle DatabaseのためのOracle GoldenGateのインストールおよび構成』を参照してください。CREATE TABLE AS SELECT (CTAS)文を使用してオブジェクト表を作成する場合は、オブジェクト表を完全にサポートするために、CTAS操作からDMLをキャプチャするように統合キャプチャを構成する必要があります。CTASの使用の情報は、『Oracle GoldenGate Oracle Databaseのための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をサポートします。
VAMCOMPATIBILITY {3}(MySQL、SQL M/X、SQL Server、Sybase、Teradata)
VAMモジュールとVAM APIが、必ず同じバージョンの列メタデータ構造を使用するようにします。新機能がVAM APIに追加されるにしたがい、列メタデータには新しい属性による拡張が必要になります。この状態が発生すると、新規バージョンが作成され、新規の列メタデータ属性が既存の属性に追加されます。新規バージョンの追加後、Teradata以外のすべてのデータベース実装が最新バージョンに更新することを求められます。
値1は元のVAM APIメタデータ構造が使用中であることを意味します。この構造は元々Teradata用に作成され、他のデータベースとは別々の実装であり、Teradataのみが依然としてこのレベルを使用します。Extractとの下位互換性を維持するため、以前のバージョンのTAMモジュールを、VAMバージョニングが含まれる以後のリリースのExtractに対して実行中の場合、手動でVAMCOMPATIBILITYを1に設定することが必要なときがあります。VAMCOMPATIBILITY 1が必須なのに設定されていない場合、Extractはレポート・ファイルへのメッセージを示して異常終了します。
このVAMバージョンはSQL Serverの列メタデータ構造を追加しました。この値はVAMモジュールによって内部で設定されるため、TRANLOGOPTIONSを使用した手動設定は必要ありません。
これは現在のバージョン・レベルです。Teradata以外のすべてのデータベース(SQL Serverを含む)はこのレベルを使用し、VAMモジュール内で内部で設定するため、TRANLOGOPTIONSを使用した手動設定は必要ありません。
例
次の例では、Oracleアーカイブ・ログの場所を指定します。
TRANLOGOPTIONS ALTARCHIVELOGDEST /fs1/oradata/archive/log2
次のOracle例は、2人のユーザーを(1人は名前、1人はユーザーIDで)フィルタ処理します。これらのユーザーによって生成されたトランザクションは、GETREPLICATESまたはIGNOREREPLICATESルールに従って処理され、新しいトランザクション・バッファ・サイズが指定されます。
TRANLOGOPTIONS EXCLUDEUSER ggsrep, EXCLUDEUSERID 90, BUFSIZE 100000
次の例では、SQL ServerまたはSybase環境でReplicatトランザクション名を除外します。
TRANLOGOPTIONS EXCLUDETRANS ggs_repl
次に、データベースをホストするプラットフォームと別のプラットフォーム上にあるトランザクション・ログを処理する方法を示します。
注意:
この文は、このドキュメントのスペースの制約によって、複数の行にまたがっています。
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
次の例は、Oracle GoldenGate資格証明ストアのasmdomainドメインに別名asm1を指定することでASM資格証明を指定します。
TRANLOGOPTIONS ASMUSERALIAS asm1 DOMAIN asmdomain
次の例は、ExtractがALTARCHIVELOGFORMATパラメータでフォーマット指定子%T、%Sおよび%Rを使用してアーカイブ・ログ名を形成する際の埋込み幅を指定する方法を示します。
TRANLOGOPTIONS ALTARCHIVELOGFORMAT ARC_%S_%R.%T TRANLOGOPTIONS SEQPADLEN 12, RESETLOGSIDPADLEN 12, THREADPADLEN 5
次の例は、EXCLUDETAGを使用してタグ指定子を使用する方法です。
TRANLOGOPTIONS EXCLUDETAG 00 TRANLOGOPTIONS EXCLUDETAG + TRANLOGOPTIONS EXCLUDETAG 0952
次の例では、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用です
次の例では、SQL ServerでALOモードのリモートExtractキャプチャに使用するネットワーク共有へのトランザクション・ログ・バックアップのパスを設定する方法を示します。
TRANLOGOPTIONS ALTARCHIVELOGDEST ("\\RemoteServerName\SQLBackups")