Verteilungspfad hinzufügen

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

Verwandte Themen

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, zu dem Sie eine Verbindung herstellen möchten, und weisen Sie sie dann dem Deployment zu, aus dem der Pfad stammt. Beispiel: Das Deployment, bei dem Sie den Verteilungspfad oder den vom Ziel initiierten Empfangspfad erstellen.

Andernfalls tritt in IAM-fähigen Deployments der folgende 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 (23ai)

Wenn Sie den Zugangsdatenspeicher GoldenGate 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 Deployment-Konsole Ziel an, und greifen Sie dann über die linke Navigation auf die Seite Benutzeradministration zu.
  2. Klicken Sie auf Neuen Benutzer hinzufügen, und führen Sie folgende Schritte aus:
    • Authentifiziert von: Wählen Sie in der Dropdown-Liste die Option Kennwort aus.
    • Rolle: Wählen Sie in der Dropdown-Liste die Option Operator aus.
    • Benutzername: Geben Sie Ihren Benutzernamen ein.
    • Kennwort und Kennwort bestätigen: Geben Sie das mit diesem Benutzer verknüpfte Kennwort ein.
  3. Öffnen Sie die Deployment-Konsole Quelle, und navigieren Sie im linken Navigationsmenü zu Pfadverbindungen.
  4. Klicken Sie auf Add Path Connection, 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 Kennwort ein, das mit diesem Benutzer aus Schritt 2 verknüpft ist.
  5. Klicken Sie auf Senden.
So fügen Sie einen Distributionspfad in GoldenGate 23ai hinzu:
  1. Klicken Sie in der OCI-GoldenGate-Deployment-Konsole auf Verteilungsservice.
  2. Klicken Sie auf der Homepage auf Verteilungspfad hinzufügen (Pluszeichen).
  3. Füllen Sie im Bereich "Pfad hinzufügen" bei Bedarf die Felder Pfadinformationen aus, und klicken Sie auf Weiter:
    1. Geben Sie den Pfadnamen und einen Namen für den Pfad ein.
    2. (Optional) Geben Sie eine Beschreibung ein, um den Zweck dieses Pfads zu beschreiben und die beteiligten Extract- und Replicats aufzulisten.
  4. Geben Sie auf der Seite Quelloptionen die gewünschten Felder ein, und klicken Sie auf Weiter:
    • Wählen Sie den Quellextrakt aus der Dropdown-Liste aus.
    • Geben Sie den Trailnamen ein
    • Geben Sie das Unterverzeichnis ein, wenn Sie erwarten, dass sich der Trail in einem anderen als dem Standardverzeichnis befindet.
    • Die generierte Quell-URI wird basierend auf den angegebenen Informationen automatisch generiert. Klicken Sie gegebenenfalls auf "Bearbeiten" (Stiftsymbol), um die URI 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 Begin den Ausgangspunkt für die Datenverarbeitung aus:
      • Position in Log
      • Now
      • Benutzerdefinierte Zeit
      • CSN (bei oder nach)
    • Geben Sie die Sequenznummer ein.
    • Geben Sie den RBA-Offset ein.
  5. Füllen Sie auf der Seite Zieloptionen die Felder nach Bedarf aus, und klicken Sie auf Weiter:
    • Wählen Sie ein Zielprotokoll aus:
      • ws
      • wss
      • ogg
    • (Optional) Aktivieren Sie Reverse Proxy aktiviert, um mit einem Reverse Proxy eine Verbindung zum Ziel herzustellen.
    • Zieltyp (nurogg-Zielprotokoll)
      • Manager
      • Collector
      • Empfangsservice
    • Geben Sie den Zielhost ein.
    • Geben Sie die Portnummer des Ziel-Deployments ein.
    • Geben Sie den Trailnamen für die Zieldatei ein.
    • Geben Sie das Unterverzeichnis ein, wenn sich der Trail an einem anderen 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 basierend auf den angegebenen Informationen automatisch generiert. Klicken Sie gegebenenfalls auf "Bearbeiten" (Stiftsymbol), um die URI 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 aus einem Deployment des Zugangsdatenspeichers GoldenGate herstellen. Stellen Sie sicher, dass der Benutzer im IAM-Identitätsstripe vorhanden ist.
      • OAuth

        Hinweis:

        Wählen Sie in IAM-fähigen Mandanten OAuth aus, wenn Sie eine Verbindung zu einem anderen IAM-fähigen Deployment herstellen.
      • Zertifikat
    • Domain auswählen.
    • Wählen Sie den Alias mit Oracle GoldenGate UserID und Kennwort aus.
    • Wählen Sie einen Zieltyp:
      • GGFormat (Standard)
      • SQL
      • XML
      • Nur Text
  6. Geben Sie auf der Seite Erweiterte Optionen bei Bedarf Werte in die Felder ein, und klicken Sie auf Weiter:
    • 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 oder für Netzwerke mit Quality of Service-(QoS-)Einstellungen (DSCP und ToS)) anpassen.
    • Wählen Sie die Checkpoint-Häufigkeit aus, um die Häufigkeit des Pfads festzulegen, der den Checkpoint verwendet (in Sekunden).
    • Geben Sie TCP Flush Bytes (in Byte) ein.
    • Geben Sie die TCP-Flushsekunden (in Sekunden) ein.
    • Wählen Sie den Differentiated Services Code Point (DSCP).
    • Wählen Sie den Typ des Service (TOS) aus.
    • Aktivieren Sie TCP_NODELAY, um bei Verwendung der Nagle-Option Verzögerungen zu verhindern.
    • Aktivieren Sie Schnellbestätigung, um nach dem Empfang von Daten eine schnelle Bestätigung zu senden.
    • Aktivieren Sie TCP_CORK, um die Verwendung der Cork-Option des Nagle-Algorithmus zu ermöglichen.
    • Geben Sie die Sendepuffergröße des Systems ein, um den Wert für die Sendepuffergröße für die Ablaufsteuerung festzulegen.
    • Geben Sie die Empfangspuffergröße des Systems ein, um den Wert für die Empfangspuffergröße für die Flusskontrolle festzulegen.
    • Legen Sie den Timeout für Beibehalten fest.
  7. Geben Sie auf der Seite Filteroptionen Werte in die folgenden Felder ein, und klicken Sie auf Weiter:
    • Geben Sie einen Regelnamen ein.
    • Wählen Sie eine Regelaktion aus:
      • Ausschließen filtert Daten basierend auf den ausgewählten Optionen heraus.
      • Einschließen umfasst Daten basierend auf angegebenen Optionen.
    • Wählen Sie einen Filtertyp:
      • 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 erforderlich. Die 3-teilige Konvention umfasst container, schema, object. Die 2-teilige Konvention umfasst schema, object name.
      • Prozedur - Funktionsname: 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 Ihnen die Option zur Eingabe des Tabellen- und Spaltennamens angezeigt, für den die Regel gilt. Sie können nach dem Spaltenwert nach LT-, GT-, EQ-, LE-, GE-, 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 aus, 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 aus, um eine vorhandene Regel zu negieren.
    • Klicken Sie auf Hinzufügen, um die Regel hinzuzufügen.
  8. 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 Optionen für automatische Neustartwiederholungen und Verzögerung beim automatischen Neustart anzupassen.
  9. Klicken Sie auf Erstellen und ausführen, um den Pfad sofort auszuführen. Klicken Sie auf Erstellen, 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 rufen Sie die Seite Administrator über das Navigationsmenü auf.
  2. Klicken Sie auf Benutzer hinzufügen, 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. Klicken Sie auf der Registerkarte "Datenbank" auf Zugangsdaten hinzufügen. Führen Sie dann die folgenden Schritte 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 Kennwort ein, das mit diesem Benutzer aus Schritt 2 verknüpft ist.
  5. Klicken Sie auf Senden.
So fügen Sie einen Verteilungspfad hinzu:
  1. Klicken Sie in der OCI-GoldenGate-Deployment-Konsole auf Verteilungsservice.
  2. Klicken Sie auf der Seite "Überblick" auf Pfad hinzufügen (Plansymbol).
  3. Füllen Sie die Felder auf der Seite "Pfad hinzufügen" wie folgt aus:
    1. Geben Sie unter Pfadname einen Pfadnamen ein.
    2. (Optional) Geben Sie unter Beschreibung eine kurze Beschreibung zum Zweck dieses Pfades ein.
    3. (Optional) Aktivieren Sie Reverse Proxy aktiviert, um mit einem Reverse Proxy eine Verbindung zum Ziel herzustellen.
    4. For Source, select the Extract name from the dropdown.
    5. Wählen Sie unter Verfolgungsname den Extract-Trail in der Dropdown-Liste aus.
    6. Unter Generierte Quell-URI wird die URI basierend auf den angegebenen Extract-Informationen automatisch generiert. Klicken Sie gegebenenfalls auf "Bearbeiten" (Stiftsymbol), um die URI zu ändern.
    7. Wählen Sie unter Zielauthentifizierungsmethode die Authentifizierungsmethode für die Ziel-URL aus:
      • OAuth: Wählen Sie diese Option aus, wenn die Quell- und Ziel-Deployment IAM-fähig sind. Diese Option verwendet die Clientzugangsdaten für die Authentifizierung vom Verteilungsservice beim Empfangsservice.

        Hinweis:

        Wählen Sie in IAM-fähigen Mandanten OAuth aus, wenn Sie eine Verbindung zu einem anderen IAM-fähigen Deployment herstellen.
      • 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 aus einem Deployment des Zugangsdatenspeichers GoldenGate herstellen. Stellen Sie sicher, dass der Benutzer im IAM-Identitätsstripe 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 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)
      • ws: 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
    9. Unter Generierte Ziel-URI wird die URI automatisch aus den angegebenen Informationen aufgefüllt. Klicken Sie gegebenenfalls auf "Bearbeiten" (Stiftsymbol), um die URI zu ändern.
    10. Wählen Sie unter "Zielverschlüsselungsalgorithmus" einen Verschlüsselungsalgorithmus für den Zieltrail aus:
      • Kein Wert
      • AES128
      • AES192
      • AES256
    11. Aktivieren Sie die Option Netzwerkkomprimierung aktivieren, um den Schwellenwert für die Komprimierung festzulegen.
    12. Geben Sie unter Sequenzlänge die Länge der Trailsequenznummer ein.
    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 aus.
  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 Start aus, wo Daten protokolliert werden sollen:
      • Now
      • Benutzerdefinierte Zeit
      • Position in Log (Standard)
    5. Wählen Sie unter Quellsequenznummer die Sequenznummer für den Deployment-Extract der Logdatei aus.
    6. Geben Sie unter Source RBA Offset die relative Byteadresse (RBA) in die Logdatei ein, in der der Prozess gestartet werden soll.
    7. For Critical, set this option to True if the distribution path is critical to the deployment. Der Standardwert ist False.
    8. Setzen Sie diese Option unter Automatischer Neustart auf "True", wenn der Verteilungspfad bei seiner Beendigung automatisch neu gestartet werden soll.
    9. Geben Sie unter Optionen für automatischen Neustart die Anzahl der Wiederholungen zum Neustart des Pfadprozesses und das Verzögerungsintervall zwischen Wiederholungen an.
  5. Füllen Sie unter "Regelsetkonfiguration" die folgenden Felder nach Bedarf aus:
    1. Wenn die Option Filterung aktivieren ausgewählt ist, klicken Sie auf Regel hinzufügen, und füllen Sie die zusätzlichen Felder aus.
  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 Bestätigung, falls aktiviert
      • TCP_CORK: Aktiviert die Verwendung des Nagle-Algorithmus
      • Sendepuffergröße des Systems
      • Empfangspuffergröße des Systems
      • Keepalive: Keepalive-Timeout
  7. Klicken Sie auf Erstellen und ausführen.
Sie kehren zur Seite {\b Overview} zurück, auf der Sie den Status des Pfadprozesses anzeigen können.

Weitere Informationen

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

Bekannte Probleme

Um Verteilungspfade zum Senden von Daten an oder zum Abrufen von Daten aus Oracle Cloud Infrastructure GoldenGate zu erstellen, stellen Sie sicher, dass Sie das Root-Zertifikat zur Zertifikatverwaltung oder zu Ihrem Client-Wallet hinzufügen

Um Daten an OCI GoldenGate zu senden oder daraus abzurufen, müssen Sie auf dem Empfangsserver in Ihrem On-Premise- oder Marketplace-Deployment von Oracle GoldenGate einen Verteilungsserverpfad oder einen vom Ziel initiierten Pfad erstellen. Außerdem müssen Sie das OCI GoldenGate-Root-Zertifikat oder ein selbstsigniertes Zertifikat zu Ihrer Oracle GoldenGate-Zertifikatsverwaltung (Oracle GoldenGate 21c oder höher) oder zum Client-Wallet (Oracle GoldenGate 19c) hinzufügen. Dadurch wird eine vertrauenswürdige Verbindung zwischen Ihren Oracle GoldenGate- und OCI GoldenGate-Deployments erstellt. Für Verteilungs- und Empfangsserverpfade zwischen Oracle GoldenGate und OCI GoldenGate wird nur das sichere WebSocket-(WSS-)Protokoll unterstützt.

Eine Änderung des OCI GoldenGate-Root-Zertifikats führt dazu, dass der Verteilungsserverpfad oder ein vom Ziel initiierter Pfad auf dem Empfangsserver in Ihrem On-Premise- oder Marketplace-Deployment von Oracle GoldenGate den folgenden Fehler generiert:

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

Workaround: Um dieses Problem zu beheben, aktualisieren Sie das Zertifikat im Client-Wallet oder auf der Zertifikatsverwaltung von Service Manager, um das Root-Zertifikat der OCI-GoldenGate-Deployment-Konsole zu verwenden. Wenn das Zertifikat des OCI GoldenGate-Deployments nicht direkt vom Root-Zertifikat signiert wird, sondern z.B. durch Zwischenzertifikate, müssen möglicherweise auch die Zwischenzertifikate der CA hinzugefügt werden.

Weitere Informationen:

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 vorhanden.