Verteilungspfad hinzufügen

Ein Verteilungspfad sendet die Transaktionsdaten aus einem Extract an ein Replicat.

Wann wird ein Verteilungspfad verwendet?

Verwenden Sie einen Verteilungspfad, wenn Sie Daten in einer verteilten Deployment-Umgebung replizieren müssen. Ein Verteilungspfad sendet die Transaktionsdaten aus dem Extract an das Replicat. Beim Erstellen und Ausführen eines Verteilungspfads wird im Empfangsservice des Ziel-Deployments automatisch ein Empfangspfad erstellt. Der Empfangspfad empfängt die Transaktionsdaten vom Verteilungsservice des Quell-Deployments.

Das Quell-Deployment ist das Deployment, in dem Sie den Verteilungspfad erstellen. Das Ziel-Deployment ist das Deployment, an das die extrahierten Daten und Trails gesendet werden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie GoldenGate-Verbindungen für jedes Deployment erstellen, mit dem Sie eine Verbindung herstellen möchten, und weisen Sie sie dann dem Deployment zu, von dem der Pfad stammt. Beispiel: Das Deployment, in dem Sie den Verteilungspfad oder den vom Ziel initiierten Empfangspfad erstellen.

Andernfalls tritt in IAM-fähigen Deployments der Fehler auf:

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

Verteilungspfad erstellen und ausführen (26ai)

Wenn Sie den GoldenGate-Zugangsdatenspeicher verwenden, müssen Sie einen Benutzer hinzufügen, mit dem das Quell-Deployment eine Verbindung zu einem Ziel-Deployment herstellt. Wenn Sie den IAM-Zugangsdatenspeicher verwenden, überspringen Sie diese Schritte.

  1. Melden Sie sich in der Ziel-Deployment-Konsole an, und rufen Sie die Seite Benutzeradministration über die linke Navigationsleiste auf.

  2. Wählen Sie Neuen Benutzer hinzufügen aus, und führen Sie folgende Schritte aus:

    • Authentifiziert von: Wählen Sie Kennwort aus der Dropdown-Liste aus.

    • Rolle: Wählen Sie Operator aus der Dropdown-Liste aus.

    • Benutzername: Geben Sie Ihren Benutzernamen ein.

    • Kennwort und Kennwort bestätigen: Geben Sie das mit diesem Benutzer verknüpfte Kennwort an.

  3. Öffnen Sie die Quell-Deployment-Konsole, und navigieren Sie im linken Navigationsmenü zu Pfadverbindungen.

  4. Wählen Sie Pfadverbindung hinzufügen aus, und führen Sie die folgenden Schritte aus:

    • Zugangsdatenalias: Geben Sie einen Alias ein.

    • Benutzer-ID: Geben Sie den Namen des in Schritt 2 erstellten Benutzers ein

    • Kennwort und Kennwort bestätigen: Geben Sie das mit diesem Benutzer verknüpfte Kennwort aus Schritt 2 ein.

  5. Klicken Sie auf Weiterleiten.

So fügen Sie einen Verteilungspfad in GoldenGate 26ai hinzu:

  1. Wählen Sie auf der Homepage der OCI GoldenGate-Deployment-Konsole die Option Erstellen (Plussymbol) für Verteilungspfade aus.

  2. Füllen Sie im Bereich "Pfad hinzufügen" die Felder Pfadinformationen nach Bedarf aus, und wählen Sie Weiter aus:

    1. Geben Sie den Pfadnamen ein, und geben Sie einen Namen für den Pfad.

    2. (Optional) Geben Sie eine Beschreibung ein, um den Zweck dieses Pfads zu beschreiben und die betroffenen Extract- und Replicats aufzulisten.

  3. Geben Sie auf der Seite Quelloptionen die Felder nach Bedarf ein, und wählen Sie Weiter aus:

    • Wählen Sie den Quellextrakt aus der Dropdown-Liste aus.

    • Geben Sie den Trailnamen ein.

    • Geben Sie das Unterverzeichnis ein, wenn der Trail voraussichtlich an einem anderen Ort als dem Standardwert liegt.

    • Die generierte Quell-URI wird automatisch basierend auf den angegebenen Informationen generiert. Wählen Sie "Bearbeiten" (Stiftsymbol), um die URI bei Bedarf zu ändern.

    • Wählen Sie ein Verschlüsselungsprofil aus. Das Profil "Lokales Wallet" wird standardmäßig ausgewählt, wenn kein Verschlüsselungsprofil erstellt wurde.

    • Wählen Sie unter Beginn den Ausgangspunkt für das Verarbeiten aus:

      • Position in Log

      • Now

      • Benutzerdefinierte Zeit

      • CSN (bei oder nach)

    • Geben Sie die Lfd Nr ein.

    • Geben Sie den RBA-Offset ein.

  4. Füllen Sie auf der Seite Zieloptionen die Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Wählen Sie ein Zielprotokoll aus:

      • ws

      • wss

      • ogg

    • (Optional) Aktivieren Sie Reverse-Proxy aktiviert, um mit einem Reverse-Proxys eine Verbindung zum Ziel herzustellen.

    • Zieltyp (nur Logg-Zielprotokoll)

      • Manager

      • Collector

      • Empfangsservice

    • Geben Sie den Zielhost ein.

    • Geben Sie die Portnummer des Ziel-Deployments ein.

    • Geben Sie den Trailnamen für die Zieltraildatei ein.

    • Geben Sie das Unterverzeichnis ein, wenn sich der Trail an einem anderen Ort als dem Standardspeicherort befindet.

    • Geben Sie die maximale Trailgröße ein.

    • Wählen Sie einen Zielverschlüsselungsalgorithmus aus, mit dem der Trail an das Ziel-Deployment gesendet wird:

      • NONE

      • AES128

      • AES192

      • AES256

    • Aktivieren Sie Verschlüsselung ändern, um Änderungen am Verschlüsselungsalgorithmus zuzulassen.

    • Generierte Ziel-URI wird automatisch basierend auf den angegebenen Informationen generiert. Wählen Sie "Bearbeiten" (Stiftsymbol), um die URI bei Bedarf zu ändern.

    • Wählen Sie eine Zielauthentifizierungsmethode aus (nur WSS-Zielprotokoll)

      • UserID-Alias

        Hinweis: Erstellen Sie Zugangsdaten mit dem IAM-Benutzer, wenn Sie eine Verbindung zu einem IAM-fähigen Deployment über ein GoldenGate-Zugangsdatenspeicher-Deployment herstellen. Stellen Sie sicher, dass der Benutzer im IAM-Identitätsstreifen vorhanden ist.

      • OAuth

        Hinweis: Wählen Sie in IAM-fähigen Mandanten OAuth aus, wenn eine Verbindung zu einem anderen IAM-fähigen Deployment hergestellt wird.

      • Zertifikat

    • Wählen Sie eine Domain aus.

    • Wählen Sie den Alias mit der Oracle GoldenGate-Benutzer-ID und dem Kennwort aus.

    • Wählen Sie einen Zieltyp aus:

      • GGFormat (Standard)

      • SQL

      • XML

      • Nur Text

  5. Füllen Sie auf der Seite Erweiterte Optionen die Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Aktivieren Sie Netzwerkkomprimierung aktivieren, um den Komprimierungsschwellenwert festzulegen.

    • Wählen Sie EOF-Verzögerung aus.

      Hinweis: Auf Linux-Plattformen können die Standardeinstellungen beibehalten werden. Auf Nicht-Linux-Plattformen müssen Sie diese Einstellung jedoch möglicherweise für Netzwerke mit hoher Bandbreite oder hoher Latenz bzw. für Netzwerke mit Quality of Service-(QoS-)Einstellungen (DSCP und Time of Service (ToS)) anpassen

    • Wählen Sie die Checkpointhäufigkeit aus, um die Häufigkeit des Pfads festzulegen, der den Checkpoint ausführt (in Sekunden).

    • Geben Sie die TCP-Flush-Byte (in Byte) ein.

    • Geben Sie TCP Flush Seconds (in Sekunden) ein.

    • Wählen Sie den Differentiated Services Code Point (DSCP).

    • Wählen Sie den Servicetyp (TOS) aus.

    • Aktivieren Sie TCP_NODELAY, um Verzögerungen bei der Verwendung der Nagle-Option zu vermeiden.

    • Aktivieren Sie Schnellbestätigung, um eine schnelle Bestätigung nach dem Empfang von Daten zu senden.

    • Aktivieren Sie TCP_CORK, um die Verwendung der Nagle-Algorithmuskorkoption zuzulassen.

    • Geben Sie die Systempuffergröße zwecks Ablaufsteuerung ein, um den Wert für die Sendepuffergröße festzulegen.

    • Geben Sie die Systemempfangs-Puffergröße ein, um den Wert für die Empfangspuffergröße für die Ablaufsteuerung festzulegen.

    • Legen Sie das Timeout für Keep Alive fest.

  6. Füllen Sie auf der Seite Filteroptionen die folgenden Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Geben Sie einen Regelnamen ein.

    • Wählen Sie eine Regelaktion aus:

      • Ausschließen filtert Daten basierend auf den ausgewählten Optionen heraus.

      • Einschließen: Daten basierend auf angegebenen Optionen einschließen.

    • Wählen Sie einen Filtertyp aus:

      • Objekttyp: Wählen Sie einen der drei Objekttypen aus: DML, DDL und Prozedur

      • Objektnamen: Wählen Sie diese Option aus, um einen vorhandenen Objektnamen anzugeben. Ob eine dreiteilige Namenskonvention erforderlich ist, hängt davon ab, ob Sie eine CDB verwenden. Bei CDB müssen Sie eine 3-teilige Benennungskonvention verwenden. Andernfalls ist eine 2-teilige Konvention obligatorisch. Die 3-teilige Konvention umfasst container, schema, object. Die 2-teilige Konvention umfasst schema, object name.

      • Featurename der Prozedur: Wählen Sie diese Option aus, um sie basierend auf dem vorhandenen Funktionsnamen der Prozedur zu filtern.

      • Spaltenbasiert: Wenn Sie diese Option auswählen, wird die Option angezeigt, mit der Sie den Tabellen- und Spaltennamen eingeben können, für den die Regel gilt. Sie können nach dem Spaltenwert nach LT-, GT-, EQ-, LE-, GE- und NE-Bedingungen filtern. Sie können auch angeben, ob gefilterte Daten ein Before-Image oder After-Image enthalten sollen.

      • Tag: Wählen Sie diese Option, um den Filter basierend auf Tags festzulegen.

      • Chunk-ID: Zeigt die Konfigurationsdetails von Datenbank-Shards an. Die Details können jedoch nicht bearbeitet werden.

    • Wählen Sie Negieren, um eine vorhandene Regel zu negieren.

    • Wählen Sie Hinzufügen, um die Regel hinzuzufügen.

  7. Füllen Sie auf der Seite Verwaltete Optionen die optionalen Felder nach Bedarf aus.

    • Aktivieren Sie Kritisch, um diesen Pfad für High Availability zu konfigurieren.

    • Aktivieren Sie Automatischer Neustart, um die Verzögerungsoptionen für den automatischen Neustart und den automatischen Neustart anzupassen.

  8. Wählen Sie Erstellen und ausführen aus, um den Pfad sofort auszuführen. Wählen Sie Erstellen aus, um den Pfad zu einem späteren Zeitpunkt manuell auszuführen.

Sie kehren zur Homepage zurück, auf der Sie den Status des Pfadprozesses anzeigen können.

Verteilungspfad erstellen und ausführen (21c)

Fügen Sie Zugangsdaten hinzu, mit denen ein Quell-Deployment (das Deployment, in dem Sie diesen Pfad erstellen) eine Verbindung zu einem Ziel-Deployment herstellen kann:

  1. Melden Sie sich in der Ziel-Deployment-Konsole an, und greifen Sie über das Navigationsmenü über die Seite Administrator auf sie zu.

  2. Wählen Sie Benutzer hinzufügen aus, und erstellen Sie einen Benutzer, mit dem das Quell-Deployment eine Verbindung zum Ziel-Deployment herstellen kann. Weisen Sie diesem Benutzer die Rolle Operator zu.

  3. Öffnen Sie die Quell-Deployment-Konsole, und navigieren Sie zur Seite Konfiguration.

  4. Wählen Sie auf der Registerkarte "Datenbank" die Option Zugangsdaten hinzufügen aus. Geben Sie dann folgende Informationen in die Felder aus:

    • Zugangsdatendomain: Geben Sie einen Namen für diese Verbindung ein

    • Zugangsdatenalias: Geben Sie einen Alias ein

    • Benutzer-ID: Geben Sie den Namen des in Schritt 2 erstellten Benutzers ein

    • Kennwort und Kennwort bestätigen: Geben Sie das mit diesem Benutzer verknüpfte Kennwort aus Schritt 2 ein.

  5. Klicken Sie auf Weiterleiten.

So fügen Sie einen Verteilungspfad hinzu:

  1. Wählen Sie in der OCI GoldenGate-Deployment-Konsole den Verteilungsservice aus.

  2. Wählen Sie auf der Seite "Überblick" des Verteilungsservice die Option Pfad hinzufügen (Plussymbol).

  3. Füllen Sie die Felder auf der Seite "Pfad hinzufügen" wie folgt aus:

    1. Geben Sie unter Pfadname einen Namen für den Pfad an.

    2. (Optional) Geben Sie unter Beschreibung eine kurze Beschreibung zum Zweck dieses Pfades an.

    3. (Optional) Aktivieren Sie Reverse-Proxy aktiviert, um mit einem Reverse-Proxys eine Verbindung zum Ziel herzustellen.

    4. Wählen Sie unter Quelle den Extract-Namen aus der Dropdown-Liste.

    5. Wählen Sie unter Trailname den Extract-Traill in der Dropdown-Liste aus.

    6. Unter Generierte Quell-URI wird die URI basierend auf den angegebenen Extract-Informationen automatisch generiert. Wählen Sie "Bearbeiten" (Stiftsymbol), um die URI bei Bedarf zu ändern.

    7. Wählen Sie unter Zielauthentifizierungsmethode die Authentifizierungsmethode für die Ziel-URI aus:

      • OAuth: Wählen Sie diese Option, wenn die Quell- und Ziel-Deployments IAM aktiviert sind. Diese Option verwendet die Clientzugangsdaten für die Authentifizierung vom Verteilungsservice beim Empfangsservice.

        Hinweis: Wählen Sie in Mandanten mit aktiviertem IAM die Option OAuth aus, wenn eine Verbindung zu einem anderen IAM-fähigen Deployment hergestellt wird.

      • UserID-Alias: Diese Option verwendet einen UserID-Alias, den Sie auf dem Oracle GoldenGate-Ziel erstellen können, um eine Verbindung herzustellen.

        Hinweis: Erstellen Sie Zugangsdaten mit dem IAM-Benutzer, wenn Sie eine Verbindung zu einem IAM-fähigen Deployment über ein GoldenGate-Zugangsdatenspeicher-Deployment herstellen. Stellen Sie sicher, dass der Benutzer im IAM-Identitätsstreifen vorhanden ist.

    8. Wählen Sie unter Ziel ein Datenübertragungsprotokoll in der Dropdown-Liste aus:

      • wss: Web Socket Secure ist die Standardoption. Wenn diese Option ausgewählt ist, müssen Sie die folgenden Felder ausfüllen:

        • Zielhost

        • Portnummer

        • Trailname

        • Deployment-Name (Reverse-Proxy aktiviert)

        • URI-Pfad (Reverse-Proxy aktiviert)

        • Domain

        • Aliasname

      • ogg: Wenn Sie diese Option auswählen, müssen Sie die folgenden Felder auszufüllen:

        • Zielhost

        • Portnummer

        • Trailname

        • Deployment-Name (Reverse-Proxy aktiviert)

        • URI-Pfad (Reverse-Proxy aktiviert)

      • ws: Wenn sie ausgewählt sind, müssen Sie die folgenden Felder ausfüllen:

        • Zielhost

        • Portnummer

        • Trailname

        • Deployment-Name (Reverse-Proxy aktiviert)

        • URI-Pfad (Reverse-Proxy aktiviert)

        • Domain

        • Aliasname

    9. Unter Generierte Ziel-URI wird die URI automatisch anhand der angegebenen Informationen aufgefüllt. Wählen Sie "Bearbeiten" (Stiftsymbol), um die URI bei Bedarf zu ändern.

    10. Wählen Sie unter "Zielverschlüsselungsalgorithmus" einen Verschlüsselungsalgorithmus für den Zieltrail aus:

      • Kein Wert

      • AES128

      • AES192

      • AES256

    11. Wählen Sie unter Netzwerkkomprimierung aktivieren diese Option aus, um den Komprimierungsschwellenwert festzulegen.

    12. Geben Sie unter Sequenzlänge die Länge der Trailsequenznummer an.

    13. Geben Sie unter Trailgröße (MB) die maximale Größe für eine Datei in einem Trail ein.

    14. Aktivieren sie die Option Trailformat konfigurieren, wenn Sie das Traildateiformat konfigurieren möchten, und füllen sie die zusätzlichen Felder nach Bedarf ab.

  4. Füllen Sie im Abschnitt "Verschlüsselungsprofil" die folgenden Felder nach Bedarf aus:

    1. Profilname

    2. Verschlüsselungsprofiltyp

    3. Masterschlüsselname

    4. Wählen Sie unter Beginn aus, wann bzw. wo Daten protokolliert werden sollen:

      • Now

      • Benutzerdefinierte Zeit

      • Position in Log (Standard)

    5. Wählen Sie unter Quellsequenznummer die Sequenznummer des Quell-Deployment-Extract der Traildatei.

    6. Geben Sie unter Quell-RBA -Offset die Relative Byteadresse (RBA) in die Traildatei an, in der der Prozess gestartet werden soll.

    7. Setzen Sie für Kritisch die Option auf "True", wenn der Verteilungspfad für das Deployment von hoher Bedeutung ist. Der Standardwert ist False.

    8. Setzen Sie die Option Automatischer Neustart auf "True", wenn der Verteilungspfad bei seiner Beendigung automatisch neu gestartet wird.

    9. Geben Sie unter Optionen für den automatischen Neustart die Anzahl der Wiederholungen zum Neustarten des Pfadprozesses und das Verzögerungsintervall zwischen Wiederholungen an.

  5. Füllen Sie unter "Regelsetkonfiguration" die folgenden Felder nach Bedarf aus:

    1. Wenn Sie die Option Filterung aktivieren ausgewählt haben, wählen Sie Regel hinzufügen aus, und füllen Sie die zusätzlichen Felder.

  6. Füllen Sie unter "Weitere Optionen" die folgenden Felder nach Bedarf aus:

    1. EOF-Verzögerung: Verzögerung am Dateiende vor der Suche nach Quelldaten

    2. Checkpoint-Häufigkeit: Häufigkeit von routinemäßigen Checkpoints (in Sekunden)

    3. App-Optionen

      • TCP-Flush-Byte: Flushgröße

      • TCP-Flushsekunden: Flushintervall

    4. TCP-Optionen

      • DSCP: Netzwerk - Differentiated Services

      • TOS: Nutzungsbedingungen

      • TCP_NODELAY: Wenn diese Option aktiviert ist, ist die Verwendung des Nagle-Algorithmus deaktiviert

      • Schnellbestätigung: Sendet die Bestätigung, falls aktiviert

      • TCP_CORK: Aktiviert die Verwendung des Nagle-Algorithmus

      • Sendepuffergröße des Systems

      • Empfangspuffergröße des Systems

      • Keepalive: Keepalive-Timeout

  7. Wählen Sie Erstellen und ausführen aus.

Kehren Sie zur Seite "Überblick" zurück, auf der Sie den Status des Pfadverfahrens anzeigen können.

Weitere Informationen

Möchten Sie mehr über den Verteilungspfadprozess erfahren? Weitere Informationen finden Sie in den folgenden Ressourcen:

Bekannte Probleme

Verteilungs- und Empfangspfade können nach einem Upgrade von 21.x-Deployments auf 21.17 fehlschlagen

Ab den Oracle GoldenGate-Versionen 21.17 und 26ai verwenden Pfade den reservierten Standarddomainnamen "Netzwerk", sodass vorhandene Pfade, die einen anderen Domainnamen verwenden, nicht erfolgreich sind. Folgender Fehler wird gemeldet:

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Problemumgehung: Bearbeiten Sie in der OCI GoldenGate-Deployment-Konsole jeden Pfad, und ändern Sie den Domainnamen in "Netzwerk", und starten Sie den Pfad neu. Um dies zu prüfen, prüfen Sie die Domain des Benutzers für die Pfadauthentifizierung im Abschnitt "Zugangsdatenspeicher" der Seite "Konfiguration".

Wenn Sie den Admin-Client verwenden möchten, führen Sie die folgenden Befehle aus, um den Domainnamen zu aktualisieren. Stellen Sie sicher, dass Sie die Platzhalter <path_name> und <alias> ersetzen:

Für quellinitiierte Pfade:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Für vom Ziel initiierte Pfade:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Derzeit wird nur die Digest-Authentifizierung unterstützt

Oracle Cloud Infrastructure GoldenGate unterstützt derzeit keine zertifikatbasierte Authentifizierung, wenn Sie Oracle Cloud Infrastructure GoldenGate als Verteilungspfadziel verwenden.

Workaround: Keiner.