プライマリ・コンテンツに移動
Oracle® GoldenGate Oracle GoldenGateリファレンスfor Windows and UNIX
12c (12.1.2)
E49845-08
  目次へ移動
目次
前
前 		 次
次		  

REGISTER EXTRACT

REGISTER EXTRACTでは、次の目的で、プライマリExtractグループをOracleデータベースに登録します。

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データ・ディクショナリのビルドに戻ります。これにより、既存のディクショナリのビルドを利用したキャプチャの高速作成が可能になります。

SHAREはCDBでは使用できません。

次のGGSCIコマンドがサポートされています。

REGISTER EXTRACT extract with database SCN #### SHARE AUTOMATIC 
REGISTER EXTRACT extract with database SCN #### SHARE extract 
REGISTER EXTRACT extract with database SHARE NONE 
REGISTER EXTRACT extract with database SCN #### SHARE NONE

または

REGISTER EXTRACT extract WITH DATABASE SHARE NONE
REGISTER EXTRACT extract WITH DATABASE SCN #### SHARE NONE

一方、次のGGSCIコマンドは、ダウンストリーム構成ではサポートされていません。

REGISTER EXTRACT extract WITH DATABASE SHARE AUTOMATIC
REGISTER EXTRACT extract WITH DATABASE SHARE extract
AUTOMATIC

最も近い既存のキャプチャからクローンします。最適なクローン候補が見つからない場合は、新しいビルドが作成されます。

extract

指定したExtractで関連付けられているキャプチャ・セッションからクローンします。これが可能でない場合は、登録が完了しない旨のエラーが発生します。

NONE

新しいビルドをクローンまたは作成しないでください(これがデフォルトです)。

ダウンストリーム構成では、Extractへの登録時にSHARE句をSCN句と組み合せて使用する必要があります。

例

例1   
REGISTER EXTRACT sales LOGRETENTION
例2   
REGISTER EXTRACT sales DATABASE
例3   
REGISTER EXTRACT sales DATABASE CONTAINER (sales, finance, hr)
例4   
REGISTER EXTRACT sales DATABASE ADD CONTAINER (customers)
例5   
REGISTER EXTRACT sales DATABASE DROP CONTAINER (finance)
例6   
REGISTER EXTRACT sales DATABASE SCN 136589

ディクショナリのビルドの開始SCNは136589です。

例7   
REGISTER EXTRACT sales DATABASE SCN 67000 SHARE ext2

この場合の有効な開始SCNは67000で、必ずしも現在のSCNにはなりません。

例8   
REGISTER EXTRACT sales DATABASE CONTAINER (sales, finance, hr) SCN 136589
  前
前 		 次
次
  目次へ移動
目次