1. Oracle GoldenGateクラシックのドキュメント
  2. Extract
  3. Extractの構成
  4. オンラインExtractグループの作成

オンラインExtractグループの作成

オンラインExtractグループを作成するには、ソース・システムでGGSCIを実行し、ADD EXTRACTコマンドを発行します。コマンド引数はすべてカンマで区切ります。構文には、次の2つの形態があります。

標準、パッシブまたはデータ・ポンプExtractグループを作成するための構文

ADD EXTRACT group
{, datasource}
{, BEGIN start_point} | {position_point}
[, PASSIVE]
[, THREADS n]
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

説明:

  • groupは、Extractグループの名前です。グループ名は必須です。

  • datasourceは、抽出するデータのソースを指定する場合に必要です。次のいずれかを使用します。

    • TRANLOGでは、データソースとしてトランザクション・ログを指定します。Oracle Enterprise Editionでこのオプションを使用する場合は、ADD EXTRACTを使用する前に(かつ、DELETE EXTRACTを発行してExtractグループを削除する前に)、Extractデータベース・ユーザー(または同じ権限を持つユーザー)としてDBLOGINコマンドを発行する必要があります。

      z/OS上で稼働するDB2では、bsdsオプションを使用して、トランザクション・ログのブートストラップ・データセットのファイル名を指定します。

    • INTEGRATED TRANLOGでは、このExtractが統合キャプチャ・モードで動作して、Oracle Databaseログマイニング・サーバーから論理変更レコード(LCR)を受信することを指定します。このパラメータは、Oracle Databaseにのみ適用されます。

    • EXTTRAILSOURCE trail nameでは、ローカル証跡の相対名または完全修飾名を指定します。データ・ポンプを作成する場合に使用します。データ・ポンプは、Oracle GoldenGateの任意の抽出方法と組み合せて使用できます。

  • BEGIN start_pointでは、処理のための初期チェックポイントおよび開始ポイントを確定してオンラインExtractグループを定義します。このポイントより前に開始されたトランザクションは、破棄されます。次のいずれかを使用します。

    • NOWは、グループを作成するためにADD EXTRACTコマンドが実行された時点(統合モードのOracle Extractの場合は、REGISTER EXTRACTコマンドでグループが登録された時点から)のタイムスタンプが指定された変更の抽出を開始します。ADD EXTRACT文よりも前にOracle GoldenGateの証跡に取得されたデータを回避しない場合は、データ・ポンプExtractにNOWを使用しないでください。

      YYYY-MM-DD HH:MM[:SS[.CCCCCC ]]は、開始ポイントとして正確なタイムスタンプを指定するための書式です。レプリケーションまたはロギングが有効化された時点より後の開始ポイントを使用してください。

  • position_pointでは、特定のトランザクション・ログ・ファイル内で処理を開始する特定の位置を指定します。データベースで使用する特定の構文は、『Oracle GoldenGateリファレンス』のADD EXTRACTに関する項を参照してください。

  • PASSIVEでは、グループがパッシブExtractであることを示します。PASSIVEを使用する場合、別名Extractも使用する必要があります。このオプションは、他のADD EXTRACTオプション内に任意の順序で配置できます。

  • THREADS nは、ExtractがOracle Real Application Cluster (RAC)におけるクラシック・キャプチャ・モードで動作している場合に必要です。クラスタで使用するREDOログ・スレッドの数を指定します。

  • PARAMS pathnameは、このグループのパラメータ・ファイルをOracle GoldenGateディレクトリのdirprmサブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。

  • REPORT pathnameは、このグループのプロセス・レポートをOracle GoldenGateディレクトリのdirrptサブディレクトリ以外の場所に格納する場合に必要です。完全修飾名を指定します。デフォルトの場所をお薦めします。

  • DESC 'description'では、グループの説明を指定します。

別名Extractグループを作成するための構文

ADD EXTRACT group
, RMTHOST {host | IP address}
, {MGRPORT port} | {PORT port}
[, RMTNAME name]
[, DESC 'description']

説明:

  • RMTHOSTでは、このグループを別名Extractとして識別し、リモート・ホストのDNS名またはそのIPアドレスを指定します。

  • MGRPORTでは、Managerが稼働しているリモート・システムのポートを指定します。動的Collectorを使用する場合、このオプションを使用します。

  • PORTでは、静的Collectorのポートを指定します。静的Collectorを実行する場合にのみ、MGRPORTのかわりに使用します。

  • RMTNAMEでは、パッシブExtractの名前を指定します(別名Extractの名前と異なる場合)。

  • DESC 'description'では、グループの説明を指定します。

例5-4 ログベース取得のためのExtractグループの追加

この例では、financeという名前のExtractグループを作成します。抽出は、このグループが作成された時刻に生成されたレコードから開始されます。 

ADD EXTRACT finance, TRANLOG, BEGIN NOW

例5-5 データ・ポンプExtractグループの追加

この例では、financeという名前のデータ・ポンプExtractグループを作成します。Oracle GoldenGateトレイルc:\ggs\dirdat\ltから読み取ります。 

ADD EXTRACT finance, EXTTRAILSOURCE c:\ggs\dirdat\lt

例5-6 パッシブExtractグループの追加

この例では、financeという名前のパッシブExtractグループを作成します抽出は、このグループが作成された時刻に生成されたレコードから開始されます。このグループはパッシブとしてマークされるため、ターゲットの別名ExtractがこのExtractへの接続を開始します。 

ADD EXTRACT finance, TRANLOG, BEGIN NOW, PASSIVE

例5-7 パッシブ・データ・ポンプExtractグループの追加

この例では、financeという名前のデータ・ポンプExtractグループを作成します。これは、Oracle GoldenGateの証跡c:\ggs\dirdat\ltから読み取るパッシブ・データ・ポンプExtractです。このデータ・ポンプはパッシブとしてマークされるため、ターゲットの別名Extractがこのデータ・ポンプへの接続を開始します。 

ADD EXTRACT finance, EXTTRAILSOURCE c:\ggs\dirdat\lt, PASSIVE

例5-8 別名Extractグループの追加

この例では、aliasという別名Extractグループを作成します。

ADD EXTRACT alias, RMTHOST sysA, MGRPORT 7800, RMTNAME finance

例5-9 Oracleのための統合モードでのプライマリExtractの追加

この例では、Oracleソース・データベース用に統合キャプチャ・モードでExtractを作成し、開始ポイントを、ExtractグループがREGISTER EXTRACTコマンドによってOracleデータベースに登録された時刻に設定します。統合キャプチャは、Oracleデータベースに対してのみ使用できます。 

ADD EXTRACT finance INTEGRATED TRANLOG, BEGIN NOW