ADD REPLICAT

使用 ADD REPLICAT 來建立 Replicat 群組。此命令會建立線上處理群組，以建立檢查點，讓處理連續性從執行到執行都會維持不變。所有關鍵字與輸入的大小不得超過 500 個位元組，包括您為 DESC 選項輸入的任何文字。

對於 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 。

整合式 Replicat 或平行 Replicat 未以整合式模式維護 TRACETABLE。

在整合式模式下，Replicat 不支援下列參數：

BULKLOAD (請勿使用整合式 Replicat 作為初始載入 Replicat。)
GENLOADFILES
SHOWSYNTAX
MAXTRANSOPS (已忽略)

PARALLEL

適用於所有支援的資料庫。

新增平行模式的 Replicat。此模式的 Replicat 會平行套用異動以提高效能。此選項會考量異動之間的相依性。PARALLEL INTEGRATED Replicat 僅適用於 Oracle。它以整合模式新增平行 Replicat，就像是整合式 Replicat，可運用 Oracle AI Database 內所提供的套用處理功能。

注意：設定 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 敘述句中指定兩倍的繫線數目。這可讓您在工作負載增加時新增繫線，而不需要刪除並重新建立 Replicat 群組時，請參閱 TABLE \| MAP ，瞭解如何跨繫線分割工作負載的詳細資訊。

如果省略 MAXTHREADS，預設的繫線數目為 25。繫線數目上限為 500。

MAXTHREADS 與 MAXGROUPS 參數具有關係。MAXGROUPS 可控制每個 Oracle GoldenGate 執行處理允許的最大處理作業群組數目 (擷取和 Replicat)。每個 Replicat 執行緒都會被視為 MAXGROUPS 相關內容中的 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 Application Adapter 或 Oracle GoldenGate Big Data。

NODBCHECKPOINT 對目標 Oracle AI Database 無效。Oracle 強烈建議您使用檢查點表格。整合式模式與非整合式模式的平行及協調式 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 之後，如果使用 NODBCHECKPOINT 建立 Oracle AI Database 的現有 Replicat，且 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.