Extrakt zum erstmaligen Laden mit SOURCEISTABLE instanziieren

Verwenden Sie diese Prozedur für einen Extract für das anfängliche Laden mit dem Parameter SOURCEISTABLE. Diese Prozedur ist nicht für die Instanziierung mit Oracle Data Pump oder einer bestimmten Instanziierungsmethode gedacht. Bei diesem Verfahren wird HANDLECOLLISIONS anstelle einer genauen Positionierung verwendet, sodass die Quelldatenbank aktiv bleiben kann, während die anfänglichen Daten geladen werden.

In den Beispielen werden eine Oracle-Quelle und ein Oracle-Ziel, das Schema HR und die folgenden Trailnamen verwendet:

• AA: Quelltrail für fortlaufende Änderungsdaten.
• BB: Zieltrail für laufende Änderungsdaten.
• CC: Quelltrail für Daten zum erstmaligen Laden.
• DD: Zieltrail für Daten zum erstmaligen Laden.

Hinweis: Ersetzen Sie die Beispielaliasnamen, URLs, Hosts, Ports, Schemanamen und Trailnamen durch Werte aus Ihrer Umgebung.

Schritt 1: Erstellen und starten Sie den primären TRANLOG Extract

Stellen Sie eine Verbindung zum Quell-Deployment her. Aktivieren Sie für eine Oracle-Quelle zusätzliches Logging, erstellen und registrieren Sie den integrierten primären Extract, und starten Sie ihn, bevor Sie mit dem ersten Laden beginnen. Zeichnen Sie die von REGISTER EXTRACT zurückgegebene Registrierungs-SCN auf. Führen Sie den Befehl nicht erneut aus, um diesen Wert abzurufen.

ADMINCLIENT: Source deployment
OGG (not connected) 1> CONNECT https://<source-admin-url> AS <deployment-user> PASSWORD "<deployment-password>"
OGG (https://<source-admin-url> source_deployment) > DBLOGIN USERIDALIAS <source-db-alias>
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD SCHEMATRANDATA hr

Wenn Logging für ausgewählte Tabellen anstelle des gesamten Schemas erforderlich ist, verwenden Sie ADD TRANDATA für diese Tabellen. Beispiel:

ADD TRANDATA hr.*

Erstellen und registrieren Sie den primären Extract, und erstellen Sie dann die zugehörige Parameterdatei:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTRACT extprim INTEGRATED TRANLOG BEGIN NOW
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > REGISTER EXTRACT extprim DATABASE
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > EDIT PARAMS extprim

Parameterdatei für primären Extract (EXTPRIM):

EXTRACT extprim
USERIDALIAS <source-db-alias>
EXTTRAIL AA
TABLE hr.*;

Erstellen Sie den lokalen Quelltrail, und starten Sie den primären Extract:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTTRAIL AA EXTRACT extprim MEGABYTES 2000
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > START EXTRACT extprim

Verwenden Sie für eine Containerdatenbank die entsprechenden dreiteiligen Objektnamen oder eine gültige SOURCECATALOG-Anweisung. Verwenden Sie für andere Quelldatenbanktypen die datenbankspezifische Registrierungs-, Logging- und Startpositionssyntax.

Schritt 2: Initial-Load-Extract erstellen und starten

Der Extract beim erstmaligen Laden ist ein Aufgabenextrakt. Es liest die Quelltabellen und schreibt die Datensätze in den lokalen Initial-Load-Trail CC. Die Oracle-spezifische SQLPREDICATE "AS OF SCN"-Klausel wählt den Tabelleninhalt am gewählten konsistenten Punkt aus.

Stellen Sie vor dem erstmaligen Laden von Replicat sicher, dass alle Transaktionen, die beim Start des primären TRANLOG Extract geöffnet waren, festgeschrieben wurden. Transaktionen, die offen bleiben, werden weder vom Extract für den erstmaligen Ladevorgang noch vom Extract für den primären TRANLOG erfasst und können verloren gehen.

Erstellen Sie den Extract zum erstmaligen Laden und die zugehörige Parameterdatei:

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTRACT extinit SOURCEISTABLE
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > EDIT PARAMS extinit

Extract-Parameterdatei (EXTINIT) beim erstmaligen Laden:

EXTRACT extinit
USERIDALIAS <source-db-alias>
EXTFILE CC MEGABYTES 2000 PURGE
TABLE hr.*, SQLPREDICATE "AS OF SCN <instantiation-scn>";

Ab Oracle GoldenGate 26ai löst eine TABLE-Anweisung mit Platzhaltern in einem Extract mit anfänglichem Ladevorgang keine Ansichten auf. Um eine View einzuschließen, geben Sie sie separat ohne Platzhalter an. Beispiel:

TABLE hr.employees_view;

Starten und überwachen Sie den Extract beim erstmaligen Laden:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > START EXTRACT extinit
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > INFO EXTRACT extinit DETAIL
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > VIEW REPORT extinit

Schritt 3: Erstellen und starten Sie die Verteilungsservicepfade

Erstellen Sie die Pfade aus dem Quell-Deployment. Die URI SOURCE identifiziert den Quellverteilungsservice und den lokalen Trail. Die URI TARGET identifiziert den Zielempfängerservice und den Zieltrail. Die Quell- und Zieltrailnamen müssen mit den Trails übereinstimmen, die für den entsprechenden Stream erstellt wurden.

Erstellen Sie den Pfad für laufende Änderungsdaten (AA bis BB):

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment) > ADD DISTPATH aabb SOURCE trail://<source-dist-host>:<source-dist-port>/services/v2/sources?trail=AA TARGET wss://<target-recv-host>:<target-recv-port>/services/v2/targets?trail=BB
OGG (https://<source-admin-url> source_deployment) > START DISTPATH aabb
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH aabb DETAIL

Erstellen Sie den Pfad für Daten zum erstmaligen Laden (CC bis DD):

OGG (https://<source-admin-url> source_deployment) > ADD DISTPATH ccdd SOURCE trail://<source-dist-host>:<source-dist-port>/services/v2/sources?trail=CC TARGET wss://<target-recv-host>:<target-recv-port>/services/v2/targets?trail=DD
OGG (https://<source-admin-url> source_deployment) > START DISTPATH ccdd
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH ccdd DETAIL

Bei einem gesicherten Ziel, das eine Pfadauthentifizierung erfordert, hängen Sie die folgende Klausel an jeden ADD DISTPATH-Befehl an:

AUTHENTICATION USERIDALIAS <target-path-alias> DOMAIN <target-path-domain>

Lassen Sie DOMAIN aus, wenn sich der Alias in der Standarddomain befindet. Alias und Domain müssen für die Zielpfadauthentifizierung im Quell-Deployment konfiguriert werden.

Wenn Sie das Legacy-Protokoll ogg anstelle von ws oder wss verwenden, geben Sie auch die entsprechende Option TARGETTYPE im Befehl ADD DISTPATH an.

Schritt 4: Erstellen und starten Sie das Initial-Load-Replicat

Stellen Sie eine Verbindung zum Ziel-Deployment her, erstellen Sie die Checkpoint-Tabelle, und fügen Sie ein nicht integriertes Replicat zum erstmaligen Laden hinzu, das den Zieltrail DD liest. Das Replicat kann gestartet werden, bevor der Trail zum erstmaligen Laden eintrifft. Es wartet auf Daten aus DD, nachdem der Verteilungspfad ausgeführt wurde.

ADMINCLIENT: Target deployment
OGG (not connected) 1> CONNECT https://<target-admin-url> AS <deployment-user> PASSWORD "<deployment-password>"
OGG (https://<target-admin-url> target_deployment) > DBLOGIN USERIDALIAS <target-db-alias>
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD REPLICAT repinit EXTTRAIL DD CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > EDIT PARAMS repinit

Replicat-Parameterdatei (REPINIT) erstmalig laden:

REPLICAT repinit
USERIDALIAS <target-db-alias>
MAP hr.*, TARGET hr.*;

Starten und überwachen Sie das Replicat zum erstmaligen Laden:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > START REPLICAT repinit
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repinit DETAIL

Schritt 5: Schließen Sie das anfängliche Laden ab und entfernen Sie einmalige Objekte

Warten Sie, bis der Extract des anfänglichen Ladevorgangs das Ende der Eingabe erreicht hat. Der Pfad CC zu DD hat alle Datensätze an DD zugestellt, und REPINIT hat sie angewendet. Verwenden Sie die folgenden Prüfungen:

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment) > INFO EXTRACT extinit DETAIL
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH ccdd DETAIL

ADMINCLIENT: Target deployment
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repinit DETAIL
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > SEND REPLICAT repinit, LOGEND

Entfernen Sie nach der Validierung der Ergebnisse des erstmaligen Ladevorgangs nur den einmaligen Pfad und die Prozessobjekte. Behalten Sie den primären Extract EXTPRIM und den primären Pfad AABB bei.

Aus dem Quell-Deployment:

STOP DISTPATH ccdd
DELETE DISTPATH ccdd
STOP EXTRACT extinit
DELETE EXTRACT extinit

Stoppen Sie REPINIT im Ziel-Deployment, wenn es noch ausgeführt wird, und löschen Sie es anschließend:

STOP REPLICAT repinit
DELETE REPLICAT repinit

DELETE EXTRACT erfordert die entsprechende Anmeldung bei der Quelldatenbank für Oracle, und DELETE REPLICAT erfordert die Anmeldung bei der Zieldatenbank. Beim Löschen einer Prozessgruppe werden nicht unbedingt die Parameterdatei oder Traildateien gelöscht. Verwalten Sie beibehaltene Artefakte über die unterstützten Administrationsvorgänge des Deployments.

Schritt 6: Erstellen und starten Sie das primäre Replicat mit HANDLECOLLISIONS

Erstellen Sie das primäre Replicat auf dem Ziel. Diese Prozedur verwendet HANDLECOLLISIONS, während das primäre Replicat Änderungen anwendet, die sich mit den Daten zum erstmaligen Laden überschneiden können.

Verwenden Sie für einen HANDLECOLLISIONS-Workflow ein nicht integriertes primäres Replicat, sofern unterstützt. Verwenden Sie HANDLECOLLISIONS nicht mit einem integrierten Oracle Replicat. Verwenden Sie eine genaue Instanziierungsmethode, wenn ein integriertes Replicat erforderlich ist.

ADMINCLIENT: Target deployment
OGG (https://<target-admin-url> target_deployment) > DBLOGIN USERIDALIAS <target-db-alias>
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD REPLICAT repprim EXTTRAIL BB CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > EDIT PARAMS repprim

Parameterdatei für primäres Replicat (REPPRIM):

REPLICAT repprim
USERIDALIAS <target-db-alias>
HANDLECOLLISIONS
MAP hr.*, TARGET hr.*;

Primäres Replicat starten und überwachen:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > START REPLICAT repprim
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repprim DETAIL
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH aabb DETAIL

Nachdem das primäre Replicat die Änderungen abgeholt und verarbeitet hat, die beim ersten Laden in die Queue gestellt wurden, deaktivieren Sie HANDLECOLLISIONS:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > SEND REPLICAT repprim, NOHANDLECOLLISIONS

SEND REPLICAT ... NOHANDLECOLLISIONS deaktiviert die Kollisionsbehandlung für die aktuelle Ausführung, entfernt HANDLECOLLISIONS jedoch nicht aus der Parameterdatei. Entfernen Sie HANDLECOLLISIONS vor dem nächsten Neustart aus der Parameterdatei, oder fügen Sie NOHANDLECOLLISIONS vor den betroffenen MAP-Anweisungen hinzu.