Extract für Amazon DocumentDB hinzufügen

Extract ist ein Prozess, der bei der Verbindung zur Quelldatenquelle ausgeführt wird und Daten extrahiert oder erfasst. Erfahren Sie, wie Sie einen Extract für Amazon DocumentDB hinzufügen.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie die Details für diesen Quellverbindungstyp prüfen.

Extrahierung hinzufügen

  1. Wählen Sie im Navigationsmenü der OCI GoldenGate-Deployment-Konsole die Option Extracts aus.

  2. Wählen Sie auf der Seite "Extracts" die Option Extract hinzufügen aus.

  3. Füllen Sie im Bereich "Extract hinzufügen" auf der Seite Extract-Informationen die folgenden Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Geben Sie einen Prozessnamen ein, der nicht länger als 8 Zeichen ist.

    • Geben Sie eine Beschreibung (optional) ein, damit Sie diesen Prozess von anderen unterscheiden können.

    • Wählen Sie eine Quelle aus der Dropdown-Liste aus.

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

    1. Für Extract Trail:

      1. Geben Sie einen Namen für den Extract-Prozess ein.

      2. Geben Sie einen Unterverzeichnisnamen ein, um einen benutzerdefinierten Speicherort für die generierte Traildatei festzulegen.

      3. Geben Sie Trailsequenz ein, um die Startnummer für Traildateien festzulegen.

      4. Geben Sie eine Trailgröße ein, um die maximale Größe für die generierte Traildatei festzulegen.

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

      6. Wählen Sie einen Verschlüsselungsalgorithmus aus:

        • NONE

        • AES256

        • AES192

        • AES128

    2. Wählen Sie unter Quellzugangsdaten Folgendes aus:

      1. Domain

      2. Aliasname

      3. Wann/wo beginnt

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

    • Profilname

    • Kritisch für den Deployment-Zustand

    • Autom. Start

    • Automatischer Neustart

      Hinweis: Wenn Sie ein Profil hinzufügen und die Optionen "Automatischer Start" und "Automatischer Neustart" konfigurieren, kann Ihr Deployment nach einer Netzwerkunterbrechung automatisch neu gestartet werden. Weitere Informationen finden Sie unter Verwaltete Prozesse konfigurieren.

  6. Aktualisieren Sie auf der Seite "Parameterdatei" das Quellmapping mit TABLE source.*;.

    Hinweis: Dies ist die Zuordnung von Quelldatenbank/Collection. TABLE *.*; führt dazu, dass der Prozess aus allen Datenbanken/Sammlungen extrahiert.

  7. Wählen Sie Erstellen und ausführen aus, um den Extract zu erstellen und auszuführen. Wenn Sie Erstellen auswählen, können Sie den Extract später auf der Seite "Exporte" manuell starten.

Bekannte Probleme

Replikate nicht erfolgreich, wenn Traildatei aus MongoDB-Extrakt mit BINARY_JSON_FORMAT verwendet wird

Wenn ein Replicat eine Traildatei verwendet, die aus einem MongoDB-Extrakt mit BINARY_JSON_FORMAT in der Extract-Parameterdatei generiert wurde, verläuft das Replicat mit dem folgenden Fehler nicht erfolgreich:

ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
java.nio.charset.MalformedInputException: Input length = 1 at
java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
[ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread "main"
oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)

Problemumgehung: Wenn BINARY_JSON_FORMAT aus den Extract-Parametern entfernt wird, wird das Replicat erfolgreich ausgeführt, und Dokumente werden im erweiterten JSON-Format dargestellt.