ADD REPLICAT

Mit ADD REPLICAT können Sie eine Replicat-Gruppe erstellen. Mit diesem Befehl wird eine Onlineprozessgruppe erstellt, die Checkpoints erstellt, um die Verarbeitungskontinuität von der Ausführung bis zur Ausführung zu erhalten. Er darf höchstens 500 Byte für alle Schlüsselwörter und Eingaben enthalten, einschließlich des für die Option DESC eingegebenen Textes.

Oracle GoldenGate unterstützt bis zu 5.000 nebenläufige Extract- und Replicat-Gruppen pro Oracle GoldenGate Service Manager-Instanz. At the supported level, all groups can be controlled and viewed in full using commands such as the INFO and STATUS commands.

Oracle GoldenGate empfiehlt für eine effektive Verwaltung der Umgebung, nicht mehr als den Standardwert von 300 Extract- und Replicat-Gruppen (kombiniert) zu verwenden.

(Oracle) Wenn Sie nicht die Option INTEGRATED verwenden, erstellt dieser Befehl eine Replicat-Gruppe im nicht integrierten Modus.

Syntax

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

Der Name der Replicat-Gruppe. Wenn Sie keine Option angeben, wird ein klassisches Replicat erstellt. Der Name einer koordinierten und parallelen Replicat-Gruppe darf maximal fünf Zeichen enthalten. Der Name einer regulären Replicat-Gruppe darf bis zu acht Zeichen enthalten.

INTEGRATED

(Oracle) Erstellt das Replicat im integrierten Modus. Without this option, ADD REPLICAT creates the Replicat in non-integrated (classic) mode. Diese Option kann auch für paralleles Replicat eingesetzt werden. In diesem Modus nutzt der Replicat-Prozess die in Oracle AI Database verfügbare Apply-Verarbeitungsfunktionalität. In diesem Modus führt Replicat folgende Aktionen aus:

INTEGRATED muss für ein Replicat mit Onlinesynchronisation von Änderungen verwendet werden, das die Daten aus einem mit EXTTRAIL angegebenen Trail liest.

Sowohl beim integrierten Replicat als auch beim parallelen Replicat im integrierten Modus wird eine vorhandene Checkpoint-Tabelle beibehalten. Siehe auch ADD CHECKPOINTTABLE.

TRACETABLE wird nicht vom integrierten Replicat oder parallelen Replicat im integrierten Modus beibehalten.

Im integrierten Modus unterstützt Replicat keinen der folgenden Parameter:

PARALLEL

Gültig für alle unterstützten Datenbanken.

Fügt das Replicat im parallelen Modus hinzu. In diesem Modus wendet Replicat Transaktionen parallel an, um die Performance zu verbessern. Dabei werden Abhängigkeiten zwischen Transaktionen berücksichtigt. PARALLEL INTEGRATED-Replicat ist nur für Oracle gültig. Damit wird das parallele Replicat im integrierten Modus hinzugefügt. Dies wendet wie ein integriertes Replicat die in der Oracle AI Database verfügbare Apply-Verarbeitungsfunktionalität an.

Hinweis: Stellen Sie beim Konfigurieren von parallelem Replicat für Sybase sicher, dass Sie ein Upgrade auf Version 16.0 SP3 PL15 und höher durchführen, um zu verhindern, dass der Administrationsservice intermittierend getrennt wird.

COORDINATED [MAXTHREADS number]

Erstellt das Replicat im koordinierten Modus. Ein koordiniertes Replicat weist mehrere Threads auf, um die parallele Verarbeitung zu ermöglichen. Mit dieser Option fügen Sie den Koordinator (durch den Gruppennamen identifiziert) und die maximale Anzahl an Verarbeitungsthreads hinzu, die per Standardwert oder mit MAXTHREADS angegeben werden. Abhängigkeiten werden vom Koordinator berechnet und koordiniert, und die SQL-Verarbeitung wird von den Threads ausgeführt.

Zur Erstellung eines COORDINATED-Replicats ist eine Checkpoint-Tabelle erforderlich.

COORDINATED muss für ein Replicat mit Onlinesynchronisation von Änderungen verwendet werden, das die Daten aus einem mit EXTTRAIL angegebenen Trail liest. Hinweis: Der Gruppenname eines koordinierten Replicats darf maximal fünf Zeichen enthalten.

MAXTHREADS number

Gibt die maximale Anzahl an Verarbeitungsthreads an, die diese Replicat-Gruppe starten kann. Diese Threads werden allesamt beim Start erstellt. Je nachdem, was in den MAP-Anweisungen in der Parameterdatei angegeben ist, wird die Workload allerdings jeweils von einigen oder allen dieser Threads verarbeitet. Als allgemeine Regel werden empfohlen, die doppelte Anzahl an Threads anzugeben, die Sie in den MAP-Anweisungen beim Partitionieren der Workload angegeben haben. So können Sie Threads hinzufügen, falls die Workload zunimmt, ohne dass sie die Replicat-Gruppe löschen und neu erstellen müssen. Weitere Informationen zum Partitionieren der Workload über Threads hinweg finden Sie unter TABLE \| MAP.

Die Standardanzahl an Threads beträgt 25, wenn MAXTHREADS ausgelassen wird. Die maximale Anzahl von Threads beträgt 500.

MAXTHREADS ist mit dem Parameter MAXGROUPS verknüpft. MAXGROUPS steuert die maximale Anzahl an Prozessgruppen (Extract und Replicat), die pro Oracle GoldenGate-Instanz zulässig sind. Jeder Replicat-Thread gilt im Kontext von MAXGROUPS als Replicat-Gruppe. Daher kann die Anzahl von Extract- und Replicat-Gruppen in der Oracle GoldenGate-Instanz plus dem Wert von MAXTHREADS den Wert von MAXGROUPS nicht überschreiten (siehe MAXGROUPS)

EXTTRAIL trail_name

Gibt den relativen oder vollqualifizierten Namen eines Trails an, der mit dem Befehl ADD EXTTRAIL erstellt wurde.

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

Definiert einen anfänglichen Checkpoint im Trail.

NOW

Beginnt mit der Replikation von Änderungen ab dem Zeitpunkt der Gruppenerstellung.

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

Beginnt an einem bestimmten Zeitpunkt mit dem Extrahieren von Änderungen.

EXTRBA extrba

Gültig für Db2 z/OS.

Gibt die relative Byteadresse in der Traildatei, die von EXTSEQNO angegeben wird. Verwenden Sie diese Option erst nach Rücksprache mit Oracle Support.

CHECKPOINTTABLE {owner.table NODBCHECKPOINT}

Nicht gültig für Oracle GoldenGate Applications Adapter oder Oracle GoldenGate Big Data.

NODBCHECKPOINT ist für Oracle AI Database-Ziel nicht gültig. Oracle empfiehlt dringend die Verwendung einer Checkpoint-Tabelle. Paralleles und koordiniertes Replicat im integrierten und nicht integrierten Modus erfordern eine Checkpointtabelle.

Gibt an, dass diese Replicat-Gruppe Checkpoints in die angegebene Tabelle in der Datenbank schreibt. Fügen Sie den Eigentümer und Tabellennamen wie in ggadmin.ggs_checkpoint hinzu. Dieses Argument setzt jede CHECKPOINTTABLE-Standardspezifikation in der Datei GLOBALS außer Kraft. Die Tabelle muss zunächst mit dem Befehl ADD CHECKPOINTTABLE hinzugefügt werden.

Wenn Sie bei Nicht-Oracle-Zieldatenbanken NODBCHECKPOINT angeben, schreibt die Replicat-Gruppe keine Checkpoints in eine Checkpointtabelle. Dieses Argument setzt jede CHECKPOINTTABLE-Standardspezifikation in der Datei GLOBALS außer Kraft. Das Argument ist erforderlich, wenn Sie keine Checkpoint-Tabelle mit der zu erstellenden Replicat-Gruppe verwenden möchten.

Bei Oracle AI Database-Zielen unterstützt Oracle GoldenGate 26ai und höher den Parameter NODBCHECKPOINT nicht, wenn ein Replicat hinzugefügt wird. Wenn nach dem Upgrade auf Oracle GoldenGate 26ai das vorhandene Replicat für Oracle AI Database mit NODBCHECKPOINT erstellt wurde und kein Standard-Datenbank-Checkpoint in GLOBALS angegeben wurde, wird Replicat beim Start abgebrochen. Um das zu vermeiden, müssen Sie folgende Aufgaben ausführen:

Option 1: Oracle empfiehlt, dass Sie eine Standard-Datenbank-Checkpoint-Tabelle in GLOBALS angeben

oder

Option 2: Erstellen Sie ein neues Replicat mit angegebener Checkpointtabelle, und starten Sie von der SCN neu, die das upgegradete Replicat ersetzt.

DESC ‘description’

Gibt eine Beschreibung der Gruppe ein, wie 'Loads account_tab on Serv2'. Schließen Sie die Beschreibung in Anführungszeichen ein.

ENCRYPTIONPROFILE

Gibt den Namen des Verschlüsselungsprofils für das Replicat an.

CRITICAL

Gibt an, ob der Prozess für das Deployment kritisch ist.

PROFILE

Name des Profils für den automatischen Start.

AUTOSTART

Gibt an, ob der verwaltete Prozess automatisch beim Start des Administrationsservice gestartet werden muss. Der Standardwert ist YES.

DELAY

Wartezeit in Sekunden bis zum Starten des Prozesses.

AUTORESTART

Steuert, wie der Prozess nach einer Beendigung neu gestartet wird.

RETRIES

Die maximale Anzahl der Wiederholungen bei Neustarts der Aufgabe, bevor Wiederholungsversuche abgebrochen werden. Diese Einstellung ist optional.

WAITSECONDS

Die Dauer (in Sekunden), während der Wiederholungsversuche gezählt werden.

RESETSECONDS

Setzt die Dauer, während der Wiederholungsversuche gezählt werden, zurück.

DISABLEONFAILURE

Wenn dieser Wert auf TRUE gesetzt ist, wird die Aufgabe deaktiviert, nachdem die maximale Anzahl an Wiederholungen erreicht wurde.

Beispiele

Im folgenden Beispiel wird das integrierte Replicat reps hinzugefügt. Die Ausgabe wird mit dem Befehl INFO angezeigt.

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

Ausgabe:

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

Im folgenden Beispiel wird das parallele Replicat repw hinzugefügt.

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

Ausgabe:

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