Extrakt für MongoDB 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 MongoDB einfügen.

Extract hinzufügen (26ai)

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

Details zu diesem Quellverbindungstyp prüfen.
MongoDB-Replicat-Set konfigurieren:
- OCI GoldenGate for Big Data verwendet das Operationslog (oplog), um Change Data Capture-(CDC-)Datensätze zu lesen. Der Oplog ist eine Capped-Collection in MongoDB, die einen rollierenden Datensatz aller Vorgänge verwaltet, mit denen die Datenbank geändert wird. Oplog-Dateien werden erstellt, wenn ein Replikatset in MongoDB aktiviert ist.
- MongoDB Atlas ist mit einem Replicat-Set vorkonfiguriert. Bei On-Premises-MongoDB-Bereitstellungen müssen Sie ein Replicat-Set manuell konfigurieren und bereitstellen, um Oplog- und CDC-Funktionen zu aktivieren. Bei On-Premise-MongoDB müssen Sie ein Replikatset bereitstellen.
MongoDB Version 3.6 oder höher.
OCI GoldenGate-Unterstützung zur Erfassung der folgenden Vorgänge: INSERT, UPDATE, DELETE.

So fügen Sie einen Extract für MongoDB hinzu:

Wählen Sie im Navigationsmenü der OCI GoldenGate-Deployment-Konsole die Option Extracts aus.
Wählen Sie auf der Seite "Extracts" die Option Extract hinzufügen aus.
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.
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
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.
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.
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.

Extrahieren (21c)

Stellen Sie in der OCI GoldenGate-Deployment-Konsole sicher, dass Sie sich auf der Seite "Überblick" des Administrationsservices befinden, und wählen Sie Extract hinzufügen (Plussymbol) aus.
Wählen Sie unter "Extract-Typ" auf der Seite "Extract hinzufügen" eine der folgenden Optionen und dann Weiter:
- Erstmaliges Laden
- Change Data Capture
Füllen Sie auf der Seite "Extract-Optionen" die Felder folgendermaßen aus, und wählen Sie Weiter aus:
1. Geben Sie unter Prozessname einen Namen für den Extrakt ein.
2. Wählen Sie unter Verbindungsalias den Verbindungsalias aus der Dropdown-Liste aus.
3. Wählen Sie unter Quelle die Option Datei aus.
4. Geben Sie unter Dateiname mindestens drei Zeichen für den Dateinamen ein.
5. (Optional) Unter "Verwaltete Optionen" können Sie Folgendes konfigurieren:
  - Profilname
  - 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.
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.
Wählen Sie Erstellen und ausführen aus.

Sie kehren zur Seite "Überblick" des Administrationsservices zurück. Wählen Sie den Exportnamen aus, um Details und Berichte für den Export anzuzeigen.

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.