ADD REPLICAT

ADD REPLICATでは、Replicatグループを作成します。このコマンドでは、実行から実行までの処理の継続性を維持するためにチェックポイントを作成するオンライン・プロセス・グループが作成されます。このコマンドは、DESCオプションに入力するテキストを含む、すべてのキーワードおよび入力のサイズが、500バイトを超えることはできません。

Oracle GoldenGateでは、Oracle GoldenGateサービス・マネージャのインスタンスごとに、最大で5,000の同時実行ExtractおよびReplicatグループがサポートされます。サポートされているレベルで、INFO、STATUSなどのコマンドを使用してすべてのグループを完全に制御および表示できます。

Oracle GoldenGateでは、環境を効果的に管理するため、ExtractグループとReplicatグループの数(合計)を300以下のデフォルト・レベルに維持することをお薦めします。

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

構文

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, 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 AI Database内で使用できる適用処理機能を利用します。このモードでは、Replicatは次のように動作します:

Oracle GoldenGateトレイルを読み取ります。
データのフィルタリング、マッピングおよび変換を実行します。
(コミットされた順序で)ソース・データベースのDMLまたはDDLトランザクションを表す論理変更レコード(LCR)を構成します。
軽量ストリーミング・インタフェースを通じてデータベース・インバウンド・サーバーと呼ばれるターゲット・データベースのバックグラウンド・プロセスにアタッチします。
LCRをインバウンド・サーバーに送信し、そこからデータをターゲット・データベースに適用します。
次のいずれかの機能を使用する場合、統合モード(通常の統合またはパラレル統合)のReplicatを使用する必要があります:
- 自動競合検出および解決
- プロシージャ・レプリケーション
- DMLまたはDDLハンドラ

INTEGRATEDは、ローカルのEXTTRAIL指定のトレイルから読取りを行うオンライン変更同期Replicatに対して使用する必要があります。

チェックポイント表が存在する場合、統合モードの統合ReplicatとパラレルReplicatの両方で管理されます。ADD CHECKPOINTTABLEも参照してください。

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

統合モードでは、Replicatで次のパラメータはサポートされません:

BULKLOAD (初期ロードReplicatとして統合Replicatを使用しないでください)
GENLOADFILES
SHOWSYNTAX
MAXTRANSOPS (無視されます)

PARALLEL

サポートされているすべてのデータベースで有効です。

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

ノート: SybaseのパラレルReplicatを構成する場合は、管理サービスが断続的に切断されないように、バージョン16.0 SP3 PL15以上にアップグレードしてください。

COORDINATED [MAXTHREADS number]

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

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

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を参照してください

EXTTRAIL trail_name

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 AI Databaseに対して無効です。Oracleでは、チェックポイント表を使用することを強くお薦めします。統合モードおよび非統合モードのパラレルReplicatと調整Replicatには、チェックポイント表が必要です。

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

Oracle以外のターゲット・データベースの場合、NODBCHECKPOINTが指定されていると、Replicatグループでチェックポイント表にチェックポイントが書き込まれません。この引数は、GLOBALSファイルのすべてのデフォルトのCHECKPOINTTABLE指定よりも優先されます。この引数は、作成するReplicatグループでチェックポイント表を使用しない場合に必要です。

Oracle AI Databaseターゲットの場合、Oracle GoldenGate 26ai以上では、Replicatの追加時にNODBCHECKPOINTパラメータがサポートされません。Oracle GoldenGate 26aiへのアップグレード後に、Oracle AI Databaseの既存のReplicatがNODBCHECKPOINTで作成され、GLOBALSにデフォルトのデータベース・チェックポイントが指定されていない場合、Replicatは起動時に異常終了します。これを回避するには、次のいずれかのタスクを実行する必要があります:

オプション1: Oracleでは、GLOBALSにデフォルトのデータベース・チェックポイント表を指定することをお薦めします。

または

オプション2: チェックポイント表を指定して新しいReplicatを作成し、アップグレードしたReplicatを置き換えるSCNから再開します。

DESC ‘description’

グループの説明('Loads account_tab on Serv2'など)を指定します。説明は引用符で囲みます。

ENCRYPTIONPROFILE

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

CRITICAL

プロセスがデプロイメントにとってクリティカルかどうかを示します。

PROFILE

自動起動プロファイルの名前。

AUTOSTART

管理サービスの開始時に、管理対象プロセスを自動的に開始するかどうかを指定します。デフォルト値はYESです。

DELAY

プロセスが起動するまでに待機する時間(秒)。

AUTORESTART

終了する場合のプロセスの再起動方法を制御します。

RETRIES

再試行を中止するまでにタスクを再開する最大試行数。これはオプションです。

WAITSECONDS

再試行をカウントする期間(秒)。

RESETSECONDS

再試行をカウントする期間をリセットします。

DISABLEONFAILURE

TRUEに設定すると、再試行回数の上限に達した時点でタスクは無効になります。

例

次の例では、repsという名前の統合Replicatを追加します。出力を表示するには、INFOコマンドを使用します。

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

出力は次のようになります:

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

次に、repwという名前のパラレルReplicatを追加する例です。

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

出力は次のようになります:

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.