Extract hinzufügen

Erfahren Sie mehr über die Voraussetzungen und Überlegungen zum Hinzufügen eines Extract.

Bevor Sie mit dem Hinzufügen eines Extract beginnen, stellen Sie sicher, dass die folgenden Einstellungen konfiguriert sind:

Jetzt können Sie einen Extract für Ihr Deployment hinzufügen.

Überlegungen zum Erstellen eines Extract, wenn vorherige Extract-Traildateien vorhanden sind

Bildschirm "Exportinformationen"

Nachdem Sie sich bei der Microservices-Homepage angemeldet haben, klicken Sie in der Spalte "Erstellen" auf das +, um den Assistenten Exporte hinzufügen zu öffnen.

Wählen Sie im Fenster Extraktionsinformationen den Extraktionstyp aus. Je nach Datenbankplattform können die verfügbaren Extrakttypen Integrierter Extract, Change Data Capture Extract und Initial Load Extract sein.

Wenn Sie den Downstreamextrakt für Oracle AI Database einrichten müssen, aktivieren Sie den Schalter Downstreamextrakt.

Wählen Sie den zu erstellenden Extract-Typ aus, und geben Sie Folgendes an:

Klicken Sie anschließend auf Weiter.

Exportbildschirm registrieren - PostgreSQL- und Yugabyte-Datenbanken

Hinweis: Oracle GoldenGate Extract for Oracle, verschiedene PostgreSQL-Varianten und Yugabyte-Datenbank müssen registriert werden. Die Konfigurationsoptionen zur Registrierung des Extract werden jedoch auf verschiedenen Bildschirmen angezeigt, während der Extract hinzugefügt wird.

Hinweis: Siehe auch Richtlinien und Einschränkungen für den PGOUTPUT-Plug-in-Typ.

Konfigurieren Sie im Fenster Export registrieren die folgenden Optionen, und klicken Sie auf Registrieren:

Klicken Sie auf Weiter, nachdem die Extract-Registrierung erfolgreich war.

Es wird eine Meldung angezeigt, dass der Extract erfolgreich registriert wurde.

Klicken Sie anschließend auf Weiter.

Extract für PostgreSQL- und Yugabyte-Datenbanken vom Admin-Client registrieren

Ein Extract für PostgreSQL muss bei der Datenbank registriert und ein reserviertes Replikationsslot erteilt werden. Replikationsslots werden über die Datenbankkonfigurationseinstellung max_replication_slots zugewiesen und können wie unter Datenbankkonfiguration beschrieben konfiguriert werden.

Befolgen Sie diese Anweisungen, um einen Extract zu registrieren. Die Exportregistrierung muss vor der Erstellung eines Extract erfolgen. Weitere Informationen finden Sie unter REGISTER EXTRACT in der Referenz zur Befehlszeilenschnittstelle für Oracle GoldenGate.

  1. Melden Sie sich beim Deployment an, und melden Sie sich dann beim Zugangsdatenalias für die Quelldatenbank an.

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Registrieren Sie den Extract, der intern einen Replikations-Slot für den Extract erstellt. Extraktnamen dürfen nicht mehr als 8 alphanumerische Zeichen enthalten.

    REGISTER EXTRACT *extname*

    Um Extract explizit mit dem Plug-in pgoutput zu registrieren, müssen Sie den Plug-in-Typ pgoutput angeben:

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

Sie können einen Extract auch über die Oracle GoldenGate MA-Weboberfläche registrieren. Siehe Extract hinzufügen.

Richtlinien und Einschränkungen für PGOUTPUT-Plug-in-Typ

Richtlinien für die Konfiguration des PGOUTPUT-Plug-in-Typs

Befolgen Sie diese Richtlinien, wenn Sie den Plug-in-Typ für PostgreSQL festlegen:

Einschränkungen

Die folgenden Einschränkungen gelten bei der Auswahl eines Plug-in-Typs für PostgreSQL:

Bildschirm "Exportoptionen"

Hinweis: Auf diesem Bildschirm können Sie den Extract für Oracle AI Database registrieren. Wenn Sie einen Extract für PostgreSQL hinzufügen, wird die Extract-Registrierung im Bildschirm "Extract registrieren" abgeschlossen.

Konfigurieren Sie im Fenster Extraktionsoptionen die folgenden Einstellungen:

Extract für Oracle beim Admin-Client registrieren

Befolgen Sie diese Anweisungen, um einen Extract zu registrieren. Die Exportregistrierung muss vor der Erstellung eines Extract erfolgen.

Stellen Sie sicher, dass Sie mit dem Befehl DBLOGIN mit der Datenbank verbunden sind.

Weitere Informationen finden Sie unter [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3) in der Befehlszeilenschnittstellenreferenz für Oracle GoldenGate.

  1. Melden Sie sich mit dem Admin-Client beim Deployment an, und melden Sie sich dann beim Zugangsdatenalias für die Quelldatenbank an.

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    Wenn Sie den Befehl CONNECT ausführen, ändert sich die Eingabeaufforderung von "nicht verbunden" in "https://servername:port deployment_name", wie im folgenden Beispiel dargestellt:

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. Melden Sie sich mit dem Befehl DBLOGIN bei der Datenbank an:

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Registrieren Sie den Extract. Die Extract-Namen dürfen nicht mehr als 8 alphanumerische Zeichen enthalten.

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

Sie können einen Extract auch im Hintergrund registrieren, während Sie einen Extract über die Oracle GoldenGate MA-Weboberfläche erstellen. Weitere Informationen finden Sie unter Extract hinzufügen.

Downstream-Erfassungsbildschirm

Nur für Oracle gültig.

Wenn Sie im Fenster Informationen extrahieren die Option Downstream Capture ausgewählt haben, wird das Fenster mit den Optionen für Downstream Capture angezeigt. Konfigurieren Sie die Downstream-Mining-Datenbankverbindung für den Downstream-Extrakt auf diesem Bildschirm.

Hinweis: Downstream Capture mit ADG unterstützt keinen Extract pro PDB.

Klicken Sie anschließend auf Weiter.

Bildschirm "Verwaltete Optionen"

Konfigurieren Sie im Fenster Verwaltete Optionen die Optionen für den automatischen Start und den automatischen Neustart für den Extract-Prozess. Die folgende Tabelle enthält eine Aufstellung dieser Optionen:

Die folgende Tabelle enthält eine Aufstellung dieser Optionen:

Option Beschreibung
Profilname

Gibt den Namen des Profils für den automatischen Start und den automatischen Neustart an. Sie können die Standardoptionen oder benutzerdefinierte Optionen auswählen.

Wenn Sie bereits ein Profil erstellt haben, können Sie auch dieses Profil auswählen. Wenn Sie die Option "Benutzerdefiniert" auswählen, können Sie ein neues Profil direkt in diesem Abschnitt einrichten.
Kritisch für den Deployment-Zustand

(Nur Oracle) Aktivieren Sie diese Option, wenn das Profil für den Deployment-Zustand kritisch ist.

Hinweis:

Diese Option wird nur bei der Extract- oder Replicat-Erzeugung und nicht beim Einrichten der verwalteten Prozesse in der Seite "Profile" angezeigt.

Autom. Start Aktiviert den automatischen Start für den Prozess.
Startverzögerung Wartezeit in Sekunden bis zum Starten des Prozesses
Automatischer Neustart Konfiguriert, wie der Prozess neu gestartet wird, falls er beendet wird
Max. Wiederholungsversuche Geben Sie an, wie oft maximal erneut versucht werden soll, den Prozess zu starten.
Verzögerung bei Wiederholungen Zeitverzögerung beim Versuch, den Prozess zu starten
Zeitfenster bei Wiederholungen Der Zeitraum, in dem versucht wird, den Prozess zu starten
Neustart nur bei Fehler Wenn dieser Wert auf "true" gesetzt wird, wird die Aufgabe nur neu gestartet, wenn sie nicht erfolgreich war.
Bei Erschöpfung der Wiederholungsversuche Aufgabe deaktivieren Wenn dieser Wert auf "true" gesetzt ist, wird die Aufgabe deaktiviert, nachdem alle Versuche zum Neustart des Prozesses ausgeschöpft wurden.

Klicken Sie anschließend auf Weiter.

Maske "Parameterdatei extrahieren"

Sie können die Parameterdatei im Textbereich bearbeiten, um die gewünschten Tabellendaten aufzulisten, die Sie erfassen möchten. Beispiel für eine Extract-Parameterdatei:

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

Klicken Sie auf Erstellen und ausführen, um den Extract zu erstellen und zum Starten zu verwenden. Wenn Sie Erstellen auswählen, wird der Extract erstellt. Sie müssen ihn jedoch über die Extract-Optionen starten.

Sie kehren entweder zur Administration Service-Homepage oder zur Seite "Extract" zurück, auf der alle erstellten Extracts aufgelistet sind.

Parameterdatei für Extract erstellen

Befolgen Sie diese Anweisungen, um eine Parameterdatei für einen Extrakt zu erstellen.

  1. (nur MySQL) Wenn Oracle GoldenGate für MySQL auf einem Windows-Server und auf einem Linux-Server (für OGG-Version unter 23.10.x) ausgeführt wird, der sich auf einem Remotehost von den Datenbankserver, stellen Sie sicher, dass ihre Zeitzonen identisch sind. Wenn nicht, verwenden Sie den Parameter SETENV(TZ) in Extract, und legen Sie ihn auf die Zeitzone des Datenbankservers fest.

    Weitere Informationen zum TZ-Format finden Sie im SETENV-Parameter im Referenzhandbuch für Parameter und Funktionen.

    Weitere Informationen finden Sie unter folgenden Links:

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. Geben Sie auf dem Quellsystem den folgenden Befehl ein:

    EDIT PARAMS extract_name

    Wo:

    extract_name ist entweder der Name des Extract, den Sie mit dem Befehl ADD EXTRACT erstellt haben, oder der vollqualifizierte Name der Parameterdatei, wenn Sie beim Erstellen der Gruppe einen alternativen Speicherort definiert haben.

  3. Geben Sie die Parameter in der in der folgenden Tabelle angegebenen Reihenfolge ein, und beginnen Sie mit einer neuen Zeile für jede Parameteranweisung. Einige Parameter gelten nur für bestimmte Konfigurationen.

    Parameter Beschreibung
    EXTRACT group
    • group ist der Name der Extract-Gruppe, die Sie mit dem Befehl ADD EXTRACT erstellt haben.
    		Konfiguriert Extract als Onlineprozess mit Checkpoints.
    [, USERIDALIAS alias options ] Informationen zum Angeben von Datenbankzugangsdaten finden Sie unter [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05).
    ENCRYPTTRAIL algorithm Verschlüsselt alle Trails, die nach diesem Eintrag angegeben werden.
    SOURCECATALOG Gibt einen Standardcontainer in einer mehrmandantenfähigen Oracle-Containerdatenbank oder in SEQUENCE-Anweisungen an. Ermöglicht die Verwendung von zweiteiligen Namen (schema.object), bei denen andernfalls dreiteilige Namen für diese Datenbanken erforderlich wären. Sie können mehrere Instanzen dieses Parameters verwenden, um verschiedene Standardcontainer oder -kataloge für verschiedene Sets von TABLE- oder SEQUENCE-Parametern anzugeben.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    Gibt den vollqualifizierten Namen eines Objekts oder eine vollqualifizierte Spezifikation mit Platzhaltern für mehrere Objekte an. Wenn die Datenbank eine mehrmandantenfähige Oracle-Containerdatenbank ist, muss der Objektname den Namen des Containers oder Katalogs enthalten, es sei denn, SOURCECATALOG wird verwendet.

    • schema ist der Schemaname oder ein mit Platzhaltern versehenes Set von Schemas.

    • object ist der Tabellenname oder eine Gruppe mit Platzhaltern.

    • library ist der IBM i-Bibliotheksname oder ein mit Platzhaltern versehenes Bibliothekset.

    • file ist der physische Dateiname von IBM i oder ein Satz physischer Dateien mit Platzhaltern.

    • member ist der Name des physischen IBM i-Dateielements oder eine Gruppe von Elementnamen mit Platzhaltern. Bei der Verwendung des nativen IBM i-Namensformats (Bibliothek/Datei mit optionalem Element) sind nur Platzhalter ein Name mit mindestens einem gültigen Zeichen gefolgt von einem abschließenden Sternchen (*) oder *ALL, das mit einem beliebigen Namen übereinstimmt.

    Hinweis:

    Der Elementname ist optional und muss angegeben werden, wenn die Elementnamen im Trail als Teil des Objektnamens geschrieben werden müssen. Ohne Elementnamen werden alle Elemente in einer physischen Datei implizit als einzelnes Objekt im Trail zusammengeführt.

    Informationen zum Angeben von Objektnamen in Parameterdateien finden Sie unter Objektnamen in Oracle GoldenGate-Eingabe angeben.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 Parameter, die in Verbindung miteinander verwendet werden können, um bestimmte Objekte aus einer Platzhalterangabe in der zugehörigen TABLE-Anweisung auszuschließen.

  4. Geben Sie die entsprechenden optionalen Extract-Parameter ein, die in den Oracle GoldenGate-Parametern aufgeführt sind.

  5. Speichern und schließen Sie die Parameterdatei.

In der folgenden Beispiel-Extract-Parameterdatei werden verschiedene Konfigurationsparameter und Optionen für Extract erläutert:

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

Zusätzliche Parameteroptionen für den Export

Erfahren Sie mehr über zusätzliche Parameter, die möglicherweise für Ihre Extract-Konfiguration erforderlich sind.

Extract verwendet einen Datenbank-Logmining-Server in der Mining-Datenbank, um den Redo-Stream der Quelldatenbank zu ermitteln. Sie können spezifische Parameter für den Logmining-Server festlegen, indem Sie den Parameter TRANLOGOPTIONS mit der Option INTEGRATEDPARAMS in der Extract-Parameterdatei verwenden.

Hinweis: Ausführliche Informationen und Nutzungsrichtlinien für diese Parameter finden Sie im Abschnitt "DBMS_CAPTURE_ADM" in der Oracle AI Database PL/SQL Packages and Types Reference.

Die folgenden Parameter können mit INTEGRATEDPARAMS festgelegt werden:

Siehe Serverressourcen verwalten.