2.8 ADD REPLICAT
ADD REPLICAT
では、Replicatグループを作成します。SPECIALRUN
が指定されている場合を除き、ADD REPLICAT
は実行間の処理の継続性を維持するためにチェックポイントを作成するオンライン・プロセス・グループを作成します。
このコマンドでは、DESC
オプションに入力するテキストを含む、すべてのキーワードおよび入力のサイズは、500バイトを超えることはできません。
Oracle GoldenGateは、Oracle GoldenGate Managerインスタンス当たり、最大で5,000の同時ExtractおよびReplicatグループをサポートします。サポートされているレベルで、INFO
、STATUS
などのGGSCIコマンドですべてのグループを完全に制御および表示できます。Oracle GoldenGateでは、環境を効果的に管理するために、ExtractおよびReplicatグループの数(合計)をデフォルト・レベルの300以下に保つことが推奨されます。
(Oracle)INTEGRATED
オプションが使用されている場合を除き、このコマンドはReplicatグループを非統合モードで作成します。
Admin Client構文
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]]]
}]
[, EXTSEQNO sequence_number, EXTRBA rba]
{, CHECKPOINTTABLE owner.table | NODBCHECKPOINT}
[, PARAMS file_name]
[, REPORT file_name]
[, 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 ] ] ] ]
GGSCI構文
ADD REPLICAT group_name
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]]]
}]
[, EXTSEQNO sequence_number, EXTRBA rba]
{, CHECKPOINTTABLE owner.table | NODBCHECKPOINT}
[, PARAMS file_name]
[, REPORT file_name]
-
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
オプションとともに使用しないでください。 -
BEGIN {NOW |
yyyy-mm-dd[ hh:mm
[
:
ss
[.
cccccc
]]]}
-
証跡の初期チェックポイントを定義します。
-
EXTSEQNO
sequence_number
-
トレイル内のデータ処理開始ファイルの順序番号を指定します。順序番号を指定しますが、埋込みのために0を使用しないでください。たとえば、証跡ファイルが
\aa000000026
の場合は、EXTSEQNO 26
と指定します。指定しない場合、デフォルト値は0です。このオプションを使用しない場合、処理はデフォルトで証跡の最初から開始されます。
EXTSEQNO
を使用するには、EXTRBA
も使用する必要があります。このオプションを使用する前に、Oracleサポートに連絡してください。 -
EXTRBA
rba
-
EXTSEQNO
で指定したトレイル・ファイル内の相対バイト・アドレスを指定します。このオプションを使用する前に、Oracleサポートに連絡してください。 -
CHECKPOINTTABLE
owner.table
-
Oracle GoldenGate Applications AdapterまたはOracle GoldenGate Big Dataには無効です。
チェックポイント表の使用をお薦めします。統合モードと非統合モードのパラレルReplicatにはチェックポイント表が必要です。
このReplicatグループが、データベース内の指定した表にチェックポイントを書き込むように指定します。所有者と表名を指定します(例:
hr.hr_checkpoint
)。この引数は、GLOBALS
ファイルのすべてのデフォルトのCHECKPOINTTABLE
指定よりも優先されます。ADD CHECKPOINTTABLE
コマンドを使用して、最初にこの表を追加する必要があります。NODBCHECKPOINT
を指定すると、このReplicatグループはチェックポイント表にチェックポイントを書き込まなくなります。この引数は、GLOBALS
ファイルのすべてのデフォルトのCHECKPOINTTABLE
指定よりも優先されます。この引数は、作成中のReplicatグループとともにチェックポイントを使用しないときに指定する必要があります。 -
PARAMS
file_name
-
(Classic Architectureのみ)パラメータ・ファイルの保管場所を、Oracle GoldenGateディレクトリ内のデフォルトの
dirprm
以外に指定します。完全修飾パス名を指定します。 -
REPORT
file_name
-
処理レポート・ファイルの保管場所の完全パス名を、Oracle GoldenGateディレクトリ内のデフォルトの
dirrpt
以外に指定します。 -
DESC '
description
' -
グループの説明(
'Loads account_tab on Serv2
'など)を指定します。説明は引用符で囲みます。短縮キーワードDESC
または完全なキーワードDESCRIPTION
を使用できます。 -
ENCRYPTIONPROFILE
- Replicatの暗号化プロファイルの名前を指定します。
例: GGSCI
ADD REPLICAT sales, INTEGRATED, EXTTRAIL dirdat/rt
次の例では、Replicatを調整モードで作成します。任意の時点で並列処理に最大100スレッドまで使用できることを示しています。
ADD REPLICAT sales, COORDINATED MAXTHREADS 100, EXTTRAIL dirdat/rt
例: Admin Client
rep_int
という名前の統合Replicatを追加します。出力を表示するには、INFO
コマンドを使用します。OGG (https://localhost:15000 Atlanta as ggate@ORCL/PDB1) 28> add replicat rep_int, integrated, exttrail aa
2019-11-21T20:01:10Z INFO OGG-08100 REPLICAT (Integrated) added.
r_pri
という名前のパラレルReplicatを追加する例を次に示します。OGG (https://localhost:15000 Atlanta as ggate@ORCL/PDB1) 32> add replicat r_pri, integrated, parallel, exttrail aa, checkpointtable oggadmin.check_point_table
2019-11-21T20:07:26Z INFO OGG-08100 REPLICAT (Parallel) added.
親トピック: 共通コマンドライン・インタフェースのコマンド