説明
TRANLOGOPTIONS
パラメータでは、Extractと、トランザクション・ログまたはトランザクション・データを渡すAPI(データベースやキャプチャ・モードによって異なる)とのやり取り方法を制御します。TRANLOGOPTIONS
文を同一のパラメータ・ファイル内で複数回使用することも、(オプションに許可されている場合は)同一のTRANLOGOPTIONS
文内で複数のオプションを指定することもできます。
各TRANLOGOPTIONS
オプションは、対象のデータベースに対してのみ使用してください。
構文
TRANLOGOPTIONS { [{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN} width] [ACTIVEDGFETCHTIMEOUTseconds
] [ACTIVESECONDARYTRUNCATIONPOINT | MANAGESECONDARYTRUNCATIONPOINT | NOMANAGESECONDARYTRUNCATIONPOINT] [ALLOWDATALOSS] [ALLOWTABLECOMPRESSION] [ALTARCHIVEDLOGFORMAT string] [INSTANCE instance] [THREADID id] [ALTARCHIVELOGDEST [PRIMARY] [INSTANCE instance] path] [ALTARCHIVELOGDEST ('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}] [ASMUSERALIASalias
[DOMAINdomain
]] [ASYNCTRANSPROCESSING buffer_size | NOASYNCTRANSPROCESSING] [BUFSIZE size] [CHECKPOINTRETENTIONTIMEdays
] [CHECKTABLELEVELSUPPLOG] [COMPLETEARCHIVEDLOGONLY] [COMPLETEARCHIVEDLOGTIMEOUTseconds
] [DBLOGREADER] [DBLOGREADERBUFSIZEsize
] [EXCLUDETAG [tag
| NULL] | [EXCLUDETAG +] [EXCLUDETRANStransaction
] [EXCLUDEUSER user] [EXCLUDEUSERID Oracle_uid] [FETCHLOBIFERROR] [FETCHPARTIALLOB] [FETCHPARTIALXML] [FILTERTABLE table] [FORCEFETCHLOB] [GETCTASDML | NOGETCTASDML] [HANDLEDLFAILOVER] [IGNOREDATACAPTURECHANGES | NOIGNOREDATACAPTURECHANGES] [IGNOREDIRECTLOADINSERTS] [INCLUDEAUX (AUX_specification
)] [INCLUDEREGIONID | INCLUDEREGIONIDWITHOFFSET] [INTEGRATEDPARAMS (parameter [, ...])] [LEGACYLOBREADING] [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] [MININGUSERALIASalias
[DOMAINdomain
]] [NODDLCHANGEWARNING] [NOFLUSH] [PATHMAPNFS_mount_point
log_path
] [PREPAREFORUPGRADETOIE | NOPREPAREFORUPGRADETOIE] [PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS] [QUERYRETRYCOUNT number] | [READQUEUESIZE size] [READTIMEOUT milliseconds] [REQUIRELONGDATACAPTURECHANGES | NOREQUIRELONGDATACAPTURECHANGES] [TRANSCLEANUPFREQUENCY minutes] [TSLOOKUPBEGINLRI | TSLOOKUPENDLRI] [USENATIVEOBJSUPPORT | NOUSENATIVEOBJSUPPORT] [USEPREVRESETLOGSID | NOUSEPREVRESETLOGSID] [VAMCOMPATIBILITY {1 | 2 | 3}] } [, ...]
{ACTIVATIONIDPADLEN | DATABASEIDPADLEN | THREADPADLEN | SEQPADLEN | RESETLOGSIDPADLEN}
width
(Oracle)クラシック・キャプチャ・モードのExtractに有効です
ExtractがALTARCHIVELOGFORMAT
パラメータでフォーマット指定子%A、%D、%T、%Sおよび%Rを使用してアーカイブ・ログ名を形成する際に最小のデフォルト埋込み長を指定します。対応する数値がフィールド幅より小さい場合は、左にゼロが埋め込まれます。表3-35に、各オプションに関連する指定子とデフォルトの長さを示します。
ACTIVEDGFETCHTIMEOUT
seconds
(Oracle)クラシック・キャプチャ・モードのExtractに有効です
v$database.current_scn
がこのタイムアウト間隔内にフェッチを発行する必要のあるレコードに関連付けられたコミットSCNを過ぎていない場合にExtractがタイムアウトになる間隔を秒単位で設定します。デフォルトは600秒です。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。
ACTIVEMANAGESECONDARYTRUNCATIONPOINT |
MANAGESECONDARYTRUNCATIONPOINT | NOMANAGESECONDARYTRUNCATIONPOINT
(SQL ServerおよびSybase) 2次切捨てポイントの管理方法を制御します。
ACTIVESECONDARYTRUNCATIONPOINT
SQL Serverに有効で、Sybaseではサポートされていません。
ExtractがSQL Serverトランザクション・レプリケーションまたはOracle以外の変更データ取得(CDC)実装と並行して実行されない場合、または非ネイティブSQL Serverログ・バックアップがデータベースに対して取られない場合、ACTIVESECONDARYTRUNCATIONPOINT
を使用します。これによってExtractでは、一度捕捉されたトランザクションを配布済とマーキングすることで、2次切捨てポイントを管理できるようになります。MANAGESECONDARYTRUNCATIONPOINT
モードの場合と異なり、ACTIVESECONDARYTRUNCATIONPOINT
モードのExtractはトランザクション・ログ・バックアップから読み取りません。したがって、どこのサードパーティのトランザクション・ログ・バックアップ・ソフトウェアでも使用できます。この構成で2次切捨てポイントを管理するExtractは1つだけのため、同じデータベースから取得する複数のExtractグループがある場合は、ACTIVESECONDARYTRUNCATIONPOINT
を使用しないでください。
MANAGESECONDARYTRUNCATIONPOINT
SQL 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次切捨てポイントを管理できるようになります。
NOMANAGESECONDARYTRUNCATIONPOINT
SQL ServerおよびSybaseに有効です。
SQL Serverの使用方法: ExtractがSQL Serverトランザクション・レプリケーションまたはOracle以外のCDC実装と平行して実行される場合、NOMANAGESECONDARYTRUNCATIONPOINT
を使用します。SQL Serverレプリケーションに2次切捨てポイントを管理させます。このパラメータを、同じデータベースに対する複数Extract構成内の少なくとも1つのExtractで使用する場合は、すべてのExtractグループで使用する必要があります。
Sybaseでの使用: NOMANAGESECONDARYTRUNCATIONPOINT
は、Sybaseトランザクション・ログを切り捨てないときに使用します。Extractは2次切捨てポイントを管理しません。このオプションは、Extractがデバッグ目的で以前のログ位置からSybaseトランザクション・ログの再読取りを行う必要があるときに使用できます。
ALLOWDATALOSS
(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
無効なREDOレコードによりエラーが発生した場合にクラシックExtractが処理を続行できるようにします。デフォルトでは、Extractはこれらのエラーで異常終了し、処理されない場合にデータ損失の原因となります。
ALLOWTABLECOMPRESSION
(DB2 LUWバージョン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
で何も指定されていない場合に他のすべてのスレッドに対して想定されます。
注意: INSTANCE またはTHREADID を使用するかわりに、ALTARCHIVELOGDEST オプションで各スレッドの一意のログ・ディレクトリを指定できます。(スレッド指定子を使用するログ名フォーマットを使用している場合も、一意のディレクトリの使用をお薦めします。) |
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はまず指定された場所を確認し、次にデフォルトの場所を確認します。
Oracleインスタンスには、複数のALTARCHIVELOGDEST
パラメータを指定できます。そのような場合、ExtractはALTARCHIVELOGDEST
で指定されている順番で各場所を検索します。
たとえば、次のパラメータ・ファイルからの引用では、Extractはインスタンスrac1
に関連するログを/disk1/node1/arch
で検索し、最初の検索に失敗すると、次は/disk2/node1/arch
で検索します。Extractは、rac1
のデフォルトの場所は確認しません。rac2
については、まず/disk1/node2/arch
を確認し、次にデフォルトの場所を確認します。
TRANLOGOPTIONS ALTARCHIVELOGDEST PRIMARY INSTANCE rac1 /disk1/node1/arch, ALTARCHIVELOGDEST INSTANCE rac1 /disk2/node1/arch, ALTARCHIVELOGDEST INSTANCE rac2 /disk1/node2/arch
path
代替ディレクトリのアーカイブ・ログの完全修飾パスを指定します。このディレクトリは、Oracle GoldenGateが実行されているノードにNFSマウントされている必要があります。このマウント・ポイントをALTARCHIVELOGDEST
に使用します。
PRIMARY
代替場所でログが見つからない場合に、Extractがデフォルトのログの場所を確認することを防ぎます。ALTARCHIVELOGDEST
パスのみが確認されます。PRIMARY
は、アーカイブ・ログ専用(ALO)モードで実行しているExtractのデフォルトで、それ以外の場合にはオプションです。
INSTANCE
instance
指定したALTARCHIVELOGDEST
動作を特定のOracleインスタンスに適用します。RACでこのオプションを使用する場合は、各ノードにALTARCHIVELOGDEST
パラメータを指定する必要があります。
THREADID
id
指定されたALTARCHIVELOGDEST
動作を特定のスレッド番号に適用します。
ALTARCHIVELOGDEST ("
path
" [FILESPEC "
file_pattern
"]
[[NOT] RECURSIVE])
(SQL Server)
Extractは、msdb表をログ・バックアップの場所に問い合せるのではなく、この場所以外のSQL Serverトランザクション・ログ・バックアップから読み取ります。このパラメータは、ログ・バックアップが元の宛先から移動されている場合に使用します。
パラメータ引数はカッコで囲みます。SQL ServerのExtractパラメータ・ファイルには、1つのTRANLOGOPTIONS ALTARCHIVELOGDEST
エントリのみ指定できます。複数のエントリが存在する場合は、最後のエントリのみが使用されます。
"path"
パス名を二重引用符で囲んでログ・バックアップに指定します。最後のバックスラッシュ(\)・デリミタの後に、ワイルドカード記号を使用できます。アスタリスク(*)は、ゼロまたはそれ以上の文字と一致します。疑問符(?)は一文字と一致します。
NOT RECURSIVE
を使用している場合は、このオプションを使用しないでください。
FILESPEC "
file_pattern"
"path"
で指定したバックアップ・パス内のファイル・パターンを指定します。ファイル・パターンは二重引用符で囲みます。アスタリスク(*)は、ゼロまたはそれ以上の文字と一致します。疑問符(?)は一文字と一致します。
バックスラッシュ(\)・デリミタは使用しないでください。バックスラッシュを使用すると他のパスも指定できますが、これは無効です。
[NOT] RECURSIVE
"path"
で指定されているファイルを再帰的に検索(すべてのサブディレクトリも検索)するかどうかを指定します。
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
(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 [
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 オプションを使用している場合は不要です。 |
パスワード・セキュリティ機能の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。
ASMUSERALIAS
alias
[DOMAIN
domain
]
(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
トランザクション・ログを読み取るASMインスタンスにログインするための資格証明を指定します。Oracle GoldenGate資格証明ストアが使用されている場合にASMUSER
のかわりに使用できます。
alias
ASMインスタンスへのログインに使用されるログイン資格証明の別名を指定します。この資格証明は、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日です。キャプチャ・チェックポイントの詳細は、Oracle Database XStreamガイドを参照してください。
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のインストールおよび構成を参照してください。
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タグの詳細は、『Oracle Streamsレプリケーション管理者ガイド』を参照してください。
EXCLUDETRANS
transaction
(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ユーザーと同一とみなされます。
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
は無効になります。
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レコードが生成された時点とは異なるイメージである可能性があります。
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 | 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)のフォーマットで、トレイルに書き込まれます。
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
です。
LEGACYLOBREADING
SQL ServerおよびSybaseに有効です。
VAMモジュールで、Extractバージョン11.1以前に使用されていたLOB格納メカニズムが使用されます。バージョン11.2.1より、別のLOB格納メカニズムが使用されています。
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行にまとめてください。アンパサンド(&)行終了文字を使用して行を複数に分割しないでください。
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
ログへのパスを指定します。
MAXREADSIZE
records
Sybaseに有効です。
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をサポートします。
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
としてログインするように指定します。
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
オプションとともに使用できます。
NFS_mount_point
ログが格納されるリモート・システムのNFSマウント・ポイントを指定します。
log_path
リモート・システム上のログのパス。パスはマウント・ポイント指定に従う必要があります。
PREPAREFORUPGRADETOIE
| NOPREPAREFORUPGRADETOIE
(Oracle) Oracle RACでクラシックExtractから統合Extractにアップグレードする場合に有効です。
Oracle RACでクラシックExtractから統合Extractにアップグレードする場合は、アップグレード対象のクラシックExtractを停止する前にPREPAREFORUPGRADETOIE
オプションを設定し、アップグレードを続行する前に、パラメータが有効になっていることを示すレポート・ファイルの情報メッセージが表示されるまで待機する必要があります。アップグレード手順の詳細は、『Oracle GoldenGate Oracle GoldenGateのアップグレードfor Windows and UNIX』を参照してください。
PREPAREFORUPGRADETOIE
Extractパラメータ・ファイルのPREPAREFORUPGRADETOIE
を設定するか(Extractの再起動が必要)、このコマンドを使用してGGSCIからExtractを実行できるように、動的に設定できます。
SEND EXTRACT
extract_name
TRANLOGOPTIONS PREPAREFORUPGRADETOIE
NOPREPAREFORUPGRADETOIE
必要に応じて、PREPAREFORUPGRADETOIE
オプションを動的に無効にします。デフォルトはNOPREPAREFORUPGRADETOIE
です。
PURGEORPHANEDTRANSACTIONS | NOPURGEORPHANEDTRANSACTIONS
(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
Oracle RACノードに障害が発生し、Extractがロールバックを取得できないときに発生する孤立トランザクションのパージを制御します。
PURGEORPHANEDTRANSACTIONS
孤立したトランザクションをパージします。トランザクションは、パージの実行前に、自身の開始時間とノードの開始時間の比較によって孤立しているかどうかが検証され、ノードよりも開始時間が早いトランザクションはパージされます。
NOPURGEORPHANEDTRANSACTIONS
デフォルトです。孤立したトランザクションはパージされません。
QUERYRETRYCOUNT
number
(SQL ServerのExtract)
タイムアウト後に表のメタデータを取得するために問合せを再試行する回数を指定します。表を作成した長時間に及ぶトランザクションでは、タイムアウトが発生することがあります。システム表はロックされ、Extractの問合せは完了できなくなります。
デフォルトは、30秒の待機後に1回の再試行で、この再試行が失敗するとプロセスは異常終了します。QUERYRETRYCOUNT
では、指定される入力値に従って30秒間隔で複数回再試行するように指定できます。すべての再試行が失敗すると、Extractは通常の接続エラー・メッセージとともに異常終了します。
次の例では、Extractは30秒間隔で4回問合せを試行します。
TRANLOGOPTIONS QUERYRETRYCOUNT 4
READQUEUESIZE
size
Sybaseに有効です。
トランザクション・データの内部キューのサイズをバイト単位で指定します。これによりパフォーマンスが向上します。有効な値は、10から50000までの整数です。デフォルトは512バイトです。高い値に調整する前に、10000から開始して、パフォーマンスを評価してください。
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は警告を出しますが、データ・レコードの処理を継続します。
[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のインストールおよび構成』を参照してください。
デフォルトはNOUSENATIVEOBJSUPPORT
で、統合キャプチャがデフォルトでUDTおよびANYDATA
のフェッチベースのキャプチャを使用します(クラシック・キャプチャと同様)。
USEPREVRESETLOGSID
| NOUSEPREVRESETLOGSID
(Oracle) クラシック・キャプチャ・モードのExtractに有効です。
Extractが前のRESETLOG
IDを現在のブランチとして取得するように指定します。デフォルトはNOUSEPREVRESETLOGSID
です。Oracle Data Guard環境でキャプチャする際にクラシック・キャプチャ・モードのExtractをサポートします。
VAMCOMPATIBILITY {1 | 2}
(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
を使用した手動設定は必要ありません。
例
次の例では、アーカイブ・ログの場所を指定します。
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