Oracle® Fusion Middleware Oracle GoldenGateリファレンスfor Windows and UNIX 12c (12.2.0.1) E70112-04 |
|
前 |
次 |
REGISTER EXTRACT
では、次の目的で、プライマリExtractグループをOracleデータベースに登録します。
統合キャプチャ・モードを有効にする
マルチテナント・コンテナ・データベースから統合Extractするためのオプションを指定する
リカバリに必要なアーカイブ・ログを保持するため、Oracle Recovery Managerで動作するように、Extractをクラシック・キャプチャ・モードで有効にする
REGISTER EXTRACT
は、データ・ポンプExtractには無効です。
Extractグループをデータベースから登録解除するには、UNREGISTER EXTRACT
コマンドを使用します(UNREGISTER EXTRACTを参照してください)。
REGISTER EXTRACTの使用の詳細は、Oracle DatabaseのためのOracle GoldenGateのインストールおよび構成を参照してください。
構文
クラシックExtractの場合:
REGISTER EXTRACT group_name
LOGRETENTION
統合Extractの場合:
REGISTER EXTRACT group_mame DATABASE [CONTAINER (container[, ...]) | ADD CONTAINER (container[, ...]) | DROP CONTAINER (container[, ...])] [SCN system_change_number] {SHARE [ AUTOMATIC | extract | NONE]}
group_name
登録するExtractグループの名前。ワイルドカードは使用しないでください。
DATABASE
[
CONTAINER (
container
[, ...]) |
ADD CONTAINER (
container
[, ...]) |
DROP CONTAINER (
container
[, ...])
[
オプションを指定しないDATABASE
では、ExtractグループのCDB以外のデータベースからの統合キャプチャが可能になります。このモードでは、Extractは、論理変更レコード(LCR)の形式で変更データを受信するデータベース・ログマイニング・サーバーと統合します。ExtractはREDOログを読み取りません。Extractは、取得処理、変換およびその他の要件を実行します。DMLフィルタリングはLogminingサーバーによって実行されます。サポート情報および構成手順は、『Oracle GoldenGate Oracle DatabaseのためのOracle GoldenGateのインストールおよび構成』を参照してください。
DATABASE
を指定してREGISTER EXTRACT
を使用する前に、dbms_goldengate_auth.grant_admin_privilegeプロシージャを使用して付与した権限で、すべてのExtractにDBLOGIN
コマンドを使用します。ダウンストリーム構成がある場合は、MININGDBLOGINコマンドも発行する必要があります。登録するソース・データベースがCDBデータベースで、Extractがデータをフェッチする場合は、CONTAINER=>'ALL
'パラメータでgrant_admin_privilege
をコールする必要があります。
REGISTER EXTRACT
を使用した後で、ADD EXTRACT
をINTEGRATED TRANLOG
オプションとともに使用して、同じ名前のExtractグループを作成します。Extractグループを追加する前に登録する必要があります。
CONTAINER (
container
[, ...]
)
マルチテナント・コンテナ・データベース(CDB)の1つ以上のプラガブル・データベース(コンテナ)のリストに登録を適用します。1つ以上のプラガブル・データベースを、CONTAINER (pdb1, pdb2, pdb3)
のようにカッコで囲んだカンマ区切りリストとして指定します。すべてのプラガブル・データベースがデータベースに存在する必要があり、すべての名前をワイルドカードではなく明示的に指定する必要があります。
ADD CONTAINER (
container
[, ...]
)
指定したプラガブル・データベースを既存のExtractキャプチャ構成に追加します。1つ以上のプラガブル・データベースを、ADD CONTAINER (pdb1, pdb2, pdb3)
のようにカッコで囲んだカンマ区切りリストとして指定します。このオプションを指定してREGISTER EXTRACT
を発行する前に、Extractグループを停止します。
Oracleの場合、既存のExtractの特定のSCNでCONTAINER
を追加することはサポートされなくなりました。
DROP CONTAINER (
container
[, ...]
)
指定したプラガブル・データベースを既存のExtractキャプチャ構成から削除します。1つ以上のプラガブル・データベースを、DROP CONTAINER (pdb1, pdb2, pdb3)
のようにカッコで囲んだカンマ区切りリストとして指定します。このオプションを指定してREGISTER EXTRACT
を発行する前に、Extractグループを停止します。
LOGRETENTION
クラシックExtractのみに有効です。Extractがリカバリに必要とするログを保持するため、Oracle Recovery Manager (RMAN)で動作するように、Extractグループをクラシック・キャプチャ・モードで有効にします。Extractグループが統合キャプチャ用に構成されている場合、LOGRETENTION
は無視されます。
LOGRETENTION
は、Extractグループ専用の基礎となるOracle Streamsキャプチャ・プロセスを作成し、同様の名前を持ちます。このキャプチャは、ログ保存の目的でのみ使用します。
ログは、現在のデータベースSCNに基づいて、REGISTER EXTRACT
が発行された時点から保持されます。ログ保持機能は、TRANLOGOPTIONS
パラメータのLOGRETENTION
オプションで制御されます。
REGISTER EXTRACT
をLOGRETENTION
とともに使用する前に、DBLOGIN
コマンドをDBLOGINで示した権限で発行します。
SCN
system_change_number
Extractを登録して、過去の特定のシステム変更番号(SCN)でキャプチャを開始します。このオプションを使用しない場合、REGISTER EXTRACT
が発行されたときからキャプチャが開始されます。指定したSCNは、ログ・ファイルのディクショナリ作成操作の開始SCNに対応している必要があります。次の問合せを発行して、すべての有効なSCN値を検索できます。
SELECT first_change# FROM v$archived_log WHERE dictionary_begin = 'YES' AND standby_dest = 'NO' AND name IS NOT NULL AND status = 'A';
単独で使用する場合、SCN値はログ・ファイルのディクショナリ作成操作の開始SCNになります。
SHARE AUTOMATIC
またはSHARE
extract_name
と組み合せて使用した場合、指定したSCNはキャプチャ・セッションのstart_scn
になり、次の制限があります。
現在のSCN以下になるようにしてください。
既存のキャプチャの最小値(最初のSCN)より大きくなるようにしてください。
{SHARE [
AUTOMATIC |
extract
| NONE]}
Extractを登録し、指定したSCNでクローンを作成する既存のLogMinerデータ・ディクショナリのビルドに戻ります。これにより、既存のディクショナリのビルドを利用したExtractの高速作成が可能になります。
SHARE
はCDBでは使用できません。
次のGGSCIコマンドがサポートされています。
REGISTER EXTRACT extract database SCN #### SHARE AUTOMATIC REGISTER EXTRACT extract database SCN #### SHARE extract REGISTER EXTRACT extract database SHARE NONE REGISTER EXTRACT extract database SCN #### SHARE NONE
または
REGISTER EXTRACT extract DATABASE SHARE NONE REGISTER EXTRACT extract DATABASE SCN #### SHARE NONE
一方、次のGGSCIコマンドは、ダウンストリーム構成ではサポートされていません。
REGISTER EXTRACT extract DATABASE SHARE AUTOMATIC REGISTER EXTRACT extract DATABASE SHARE extract
AUTOMATIC
最も近い既存のキャプチャからクローンします。最適なクローン候補が見つからない場合は、新しいビルドが作成されます。
extract
指定したExtractで関連付けられているキャプチャ・セッションからクローンします。これが可能でない場合は、登録が完了しない旨のエラーが発生します。
NONE
新しいビルドをクローンまたは作成しないでください(これがデフォルトです)。
ダウンストリーム構成では、Extractへの登録時にSHARE
句をSCN
句と組み合せて使用する必要があります。
例
REGISTER EXTRACT sales LOGRETENTION
REGISTER EXTRACT sales DATABASE
REGISTER EXTRACT sales DATABASE CONTAINER (sales, finance, hr)
REGISTER EXTRACT sales DATABASE ADD CONTAINER (customers)
REGISTER EXTRACT sales DATABASE DROP CONTAINER (finance)
REGISTER EXTRACT sales DATABASE SCN 136589
ディクショナリのビルドの開始SCNは136589です。
REGISTER EXTRACT sales DATABASE SCN 67000 SHARE ext2
この場合の有効な開始SCNは67000で、必ずしも現在のSCNにはなりません。
REGISTER EXTRACT sales DATABASE CONTAINER (sales, finance, hr) SCN 136589