1. Oracle GoldenGateコマンドライン・インタフェース・リファレンス
  2. 管理クライアント・コマンドライン・インタフェース・コマンド
  3. ADD REPLICAT

ADD REPLICAT

ADD REPLICATでは、Replicatグループを作成します。SPECIALRUNが指定されている場合を除き、ADD REPLICATは実行間の処理の継続性を維持するためにチェックポイントを作成するオンライン・プロセス・グループを作成します。

このコマンドでは、DESCオプションに入力するテキストを含む、すべてのキーワードおよび入力のサイズは、500バイトを超えることはできません。

Oracle GoldenGateは、Oracle GoldenGate Service Managerインスタンス当たり、最大で5,000の同時ExtractおよびReplicatグループをサポートします。サポートされているレベルで、INFO、STATUSなどのコマンドを使用してすべてのグループを完全に制御および表示できます。

Oracle GoldenGateでは、環境を効果的に管理するために、ExtractおよびReplicatグループの数(合計)をデフォルト・レベルの300以下に保つことが推奨されます。

(Oracle)INTEGRATEDオプションが使用されている場合を除き、このコマンドはReplicatグループを非統合モードで作成します。

構文

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, SPECIALRUN |
    , EXTFILE file_name |
    , EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table} 
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART 
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]
group_name

Replicatグループ名。オプションを指定しないと、クラシックReplicatが作成されます。調整およびパラレルReplicatグループ名は最大5文字を使用できます。標準Replicatグループ名は最大8文字まで使用できます。

INTEGRATED

(Oracle)Replicatを統合モードで作成します。このオプションがない場合、ADD REPLICATはReplicatを非統合(クラシック)モードで作成します。このオプションはパラレルReplicatでも機能します。このモードでは、ReplicatプロセスはOracle Databaseで使用可能な適用プロセス機能を利用します。このモードでは、Replicatは次のように動作します。

  • Oracle GoldenGate証跡を読み取ります。

  • データのフィルタリング、マッピング、および変換を実行します。

  • ソース・データベースDMLまたはDDLトランザクションを(コミットされた順序で)表す論理変更レコード(LCR)を作成します。

  • データベース・インバウンド・サーバーと呼ばれるターゲット・データベースのバックグラウンド・プロセスに、軽いストリーミング・インタフェースを介してアタッチします。

  • データがターゲット・データベースに適用されるインバウンド・サーバーにLCRを転送します。

  • 次の機能のいずれかを使用する場合は、統合モードのReplicat (通常統合またはパラレル統合)を使用する必要があります。

    • 自動競合検出および解決

    • プロシージャ・レプリケーション

    • DMLハンドラまたはDDLハンドラ

INTEGRATEDをSPECIALRUNまたはEXTFILEオプションとともに使用しないでください。INTEGRATEDはローカルEXTTRAILが指定されたトレイルから読み取るオンライン変更同期Replicatに対して使用する必要があります。

統合モードの統合ReplicatとパラレルReplicatの両方にチェックポイント表が存在する場合は、その表が維持されます。「ADD CHECKPOINTTABLE」を参照してください。

TRACETABLEは、統合モードの統合ReplicatまたはパラレルReplicatでは維持されません。

統合モードでは、Replicatは次のパラメータをサポートしません。

  • BULKLOAD (初期ロードReplicatとして統合Replicatを使用しないでください)

  • SPECIALRUN

  • GENLOADFILES

  • SHOWSYNTAX

  • MAXTRANSOPS (無視されます)

PARALLEL

Oracle、SQL Server、MySQL、Db2、TimesTen、PostgreSQLおよびTeradataに有効です。

パラレル・モードでReplicatを追加します。このモードでは、Replicatはトランザクションをパラレルに適用するため、パフォーマンスが向上します。トランザクション間の依存関係が考慮されます。PARALLEL INTEGRATED ReplicatはOracleでのみ有効です。これは、Oracle Database内で使用できる適用処理機能を利用する統合Replicatと同様に、統合モードでパラレルReplicatを追加します。

COORDINATED [MAXTHREADS number]

Replicatを調整モードで作成します。調整Replicatは並列処理できるようにマルチスレッド化されます。このオプションはコーディネータ(グループ名で識別)と、デフォルトまたはMAXTHREADSで指定した最大数の処理スレッドを追加します。依存関係がコーディネータにより計算されて調整され、SQL処理がスレッドにより実行されます。

COORDINATED Replicatを作成するには、チェックポイント表が必要です。

COORDINATEDをSPECIALRUNまたはEXTFILEオプションとともに使用しないでください。COORDINATEDはローカルEXTTRAILが指定されたトレイルから読み取るオンライン変更同期Replicatに対して使用する必要があります。

ノート:

調整Replicatのグループ名には5文字のみ使用できます。
MAXTHREADS number

このReplicatグループが生成できる処理スレッドの最大数を指定します。これらのスレッドはすべて起動時に作成されますが、パラメータ・ファイルのMAP文に指定した内容により、これらのスレッドの一部またはすべては、指定した時間でワークロードを処理します。一般的なルールとして、ワークロードを分割するときに、MAP文で指定するスレッド数の2倍を指定します。これにより、ワークロードが増加した場合に、Replicatグループを削除して再作成する必要なくスレッドを追加できます。スレッド間にワークロードを分割する方法の詳細は、TABLE | MAPを参照してください。

MAXTHREADSを省略した場合、スレッドのデフォルト数は25です。スレッドの最大数は500です。

MAXTHREADSにはMAXGROUPSパラメータとの関連性があります。MAXGROUPSは、Oracle GoldenGateのインスタンスごとに使用できるプロセス・グループ(ExtractおよびReplicat)の最大数を制御します。各Replicatスレッドは、MAXGROUPSのコンテキストでは1つのReplicatグループと想定されます。したがって、Oracle GoldenGateインスタンス内のExtractおよびReplicatグループの数、プラスMAXTHREADSの値は、MAXGROUPSの値を超えることはできません。MAXGROUPSを参照してください

SPECIALRUN

Replicat特別実行をタスクとして作成します。SPECIALRUN、EXTFILEまたはEXTTRAILを指定する必要があります。ExtractがSPECIALRUNモードの場合は、START REPLICATコマンドでReplicatを起動しないでください。このオプションはINTEGRATEDまたはCOORDINATEDオプションとともに使用しないでください。

EXTFILE file_name

Extractパラメータ・ファイルで指定されている抽出ファイルの相対名または完全修飾名を指定します。このオプションをINTEGRATED Replicatで使用しないでください。

EXTTRAIL trail_name

ADD RMTTRAILまたはADD EXTTRAILコマンドで作成されたトレイルの相対名または完全修飾名を指定します。

BEGIN {NOW | yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

証跡の初期チェックポイントを定義します。

NOW

グループが作成されたときから変更のレプリケートを開始します。

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

特定の時刻から変更の抽出を開始します。

EXTRBA extrba

Db2 z/OSに有効です。

EXTSEQNOで指定したトレイル・ファイル内の相対バイト・アドレスを指定します。このオプションを使用する前に、Oracleサポートに連絡してください。

CHECKPOINTTABLE owner.table | NODBCHECKPOINT}

Oracle GoldenGate Applications AdapterまたはOracle GoldenGate Big Dataには無効です。

NODBCHECKPOINTは、ターゲットOracleデータベースで有効ではありません。チェックポイント表を使用することをお薦めします。統合および非統合モードのパラレルおよび調整Replicatにはチェックポイント表が必要です。

このReplicatグループが、データベース内の指定した表にチェックポイントを書き込むように指定します。ggadmin.ggs_checkpointのように、所有者と表名を含めます。この引数は、GLOBALSファイルのすべてのデフォルトのCHECKPOINTTABLE指定よりも優先されます。ADD CHECKPOINTTABLEコマンドを使用して、最初にこの表を追加する必要があります。

NODBCHECKPOINTを指定すると、Replicatグループはチェックポイント表にチェックポイントを書き込まなくなります。この引数は、GLOBALSファイルのすべてのデフォルトのCHECKPOINTTABLE指定よりも優先されます。この引数は、作成中のReplicatグループとともにチェックポイントを使用しないときに指定する必要があります。

DESC 'description'

グループの説明('Loads account_tab on Serv2'など)を指定します。説明は引用符で囲みます。短縮キーワードDESCまたは完全なキーワードDESCRIPTIONを使用できます。

ENCRYPTIONPROFILE
Replicatの暗号化プロファイルの名前を指定します。

例

次の例は、repeという名前の統合Replicatを追加します。出力を表示するには、INFOコマンドを使用します。
ADD REPLICAT repe, INTEGRATED, EXTTRAIL ea
出力は次のように表示されます。
2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.
repsという名前のパラレルReplicatを追加する例を次に示します。
ADD REPLICAT repe, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint
出力には次が表示されます。
2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.