1. Oracle GoldenGateコマンドライン・インタフェース・リファレンス
  2. 共通コマンドライン・インタフェースのコマンド
  3. ALTER REPLICAT

2.19 ALTER REPLICAT

ALTER REPLICATでは、ADD REPLICATコマンドで作成したReplicatグループの属性を変更します。このコマンドを使用する前に、STOP REPLICATコマンドを発行してReplicatを停止してください。これが調整Replicatグループの場合、threadIDオプションが使用されていないかぎり、ALTERはすべてのスレッドに対して有効です。

ノート:

ALTER REPLICATでは、通常のReplicatモードから調整モードへの切替えはサポートされません。プロセスを停止し、すべての経路データがターゲットに適用されていることを確認して、トレイルを新しいトレイルにロールオーバーし、Replicatグループを調整モードで削除および再作成してから、プロセスを再開する必要があります。

構文

 ALTER REPLICAT
          group-name|
          [, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
           ]|
          option [, . . .]
          {, SPECIALRUN                   |                 
          EXTFILE         file-name  |                 
          EXTTRAIL        trail-name }                
         [, PARAMS file_name]
         [, REPORT file_name]
         [, BEGIN           {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]                 
         [, EXTSEQNO        trail-sequence-number, EXTRBA trail-offset-number ]
                          
         [, 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[threadID]

変更するReplicatグループの名前、または調整Replicatのスレッドの名前。スレッドを指定するには、完全スレッド名(ALTER REPLICAT fin003, EXTSEQNO 53など)を使用します。

スレッドIDを指定しない場合、ALTERはReplicatグループのすべてのスレッドに有効になります。

option [, . . .]

これを使用して、ADD REPLICATコマンドで構成された説明またはサービス・オプション(CHECKPOINTTABLEオプションとNODBCHECKPOINTオプションを除く)を変更します。

CHECKPOINTTABLEを指定してReplicatを変更し、CHECKPOINTTABLEを指定して(または指定せずに)レプリケートするオプションはありません。ただし、統合Replicatから非統合Replicatに切り替える場合は、次の例に示すように、チェックポイント表なしで非統合Replicatを使用できます。
adminclient> add replicat rep_y, integrated   , exttrail eb, nodbcheckpoint
adminclient> alter replicat rep_y, nonintegrated, checkpointtable ggadmin.ggs_ckpt
PARALLEL

Oracleのみ。

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

INTEGRATED

Replicatを非統合モードから統合モードへ切り替えます。現在処理中のトランザクションは切替えの実施前に適用されます。統合モードから非統合モードへのReplicatの切替えに関する項を参照してください。

NONINTEGRATED, CHECKPOINTTABLE owner.table

(Oracle)Replicatを統合モードから非統合モードに切り替えます。

CHECKPOINTTABLEに対し、チェックポイント表の所有者と名前を指定します。この表は、NONINTEGRATEDを指定してALTER EXTRACTを発行する前に、ADD CHECKPOINTTABLEコマンドで作成しておく必要があります。統合Replicatの詳細は、使用する適用方法の判断に関する項を参照してください。

SPECIALRUN

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

EXTFILE file_name

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

EXTTRAIL trail_name

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

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

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

NOW

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

yyyy-mm-dd[ hh:mm[:ss[.cccccc]]]

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

EXTSEQNO sequence_number

トレイル内のデータ処理開始ファイルの順序番号を指定します。順序番号を指定しますが、埋込みのために0を使用しないでください。たとえば、証跡ファイルが\aa000000026の場合は、EXTSEQNO 26と指定します。指定しない場合、デフォルト値は0です。

このオプションを使用しない場合、処理はデフォルトで証跡の最初から開始されます。EXTSEQNOを使用するには、EXTRBAも使用する必要があります。このオプションを使用する前に、Oracleサポートに連絡してください。

EXTRBA rba

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

PARAMS file_name

パラメータ・ファイルの保管場所を、Oracle GoldenGateディレクトリ内のデフォルトのdirprm以外に指定します。完全修飾パス名を指定します。

REPORT file_name

処理レポート・ファイルの保管場所の完全パス名を、Oracle GoldenGateディレクトリ内のデフォルトのdirrpt以外に指定します。

DESC 'description'

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

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

プロセスがデプロイメントにとって重要かどうかを示します。

PROFILE

Administration Serviceの「Profile」ページを使用してプロファイルを作成した場合は、デフォルトまたはカスタムのプロファイルを選択するオプションがあります。

AUTOSTART

このオプションは、起動時にプロセスを開始する場合に選択します。

DELAY

プロセスを開始するまでの待機時間(秒)。

AUTORESTART

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

RETRIES

再試行操作が取り消されるまでタスクを再起動する最大回数。これはオプションです。

WAITSECONDS
再試行を実行するまでの待機時間を指定します。
RESETSECONDS
再試行の待機時間をリセットします。
DISABLEONFAILURE

このオプションを有効にすると、再試行回数の上限に達した時点でタスクが無効になります。

例

ALTER REPLICAT finance, EXTSEQNO 53
ALTER REPLICAT finance, EXTRBA 0
ALTER REPLICAT finance, BEGIN 2011-01-07 08:00:00
ALTER REPLICAT finance, INTEGRATED
ALTER REPLICAT finance, NONINTEGRATED, CHECKPOINTTABLE ogg.checkpt
ALTER REPLICAT fin001, EXTSEQNO 53

親トピック: 共通コマンドライン・インタフェースのコマンド