Ajout d'une extraction pour MongoDB

L'extraction est un processus qui s'exécute sur la connexion de la source de données source et extrait ou capture des données. Apprenez à ajouter une extraction pour MongoDB.

Ajout d'une extraction (26ai)

Avant de commencer, vérifiez que vous :

Afin d'ajouter une extraction pour MongoDB, procédez comme suit :

  1. In the OCI GoldenGate deployment console navigation menu, select Extracts.

  2. Sur la page Extractions, sélectionnez Ajouter une extraction.

  3. Dans le panneau Ajouter une extraction, sur la page Informations sur l'extraction, renseignez les champs suivants selon vos besoins, puis sélectionnez Suivant :

    • Entrez un nom de processus de 8 caractères maximum.

    • Entrez une description (facultatif) pour vous aider à distinguer ce processus des autres.

    • Sélectionnez une source dans la liste déroulante.

  4. Sur la page Options d'extraction, renseignez les champs suivants selon vos besoins, puis sélectionnez Suivant :

    1. Pour Extract Trail :

      1. Entrez un nom pour le processus d'extraction.

      2. Entrez un nom de sous-répertoire pour définir un emplacement personnalisé pour le fichier trace généré.

      3. Entrez Séquence de trace pour définir le numéro de début des fichiers de trace.

      4. Entrez une taille de traces pour définir la taille maximale du fichier de traces généré.

      5. Sélectionnez un profil de cryptage. Le profil Portefeuille local est sélectionné par défaut si aucun profil de cryptage n'a été créé.

      6. Sélectionnez un algorithme de cryptage :

        • NONE

        • AES-256

        • AES-192

        • AES-128

    2. Pour Informations d'identification source, sélectionnez les éléments suivants :

      1. Domaine

      2. Un alias

      3. Quand et où commencer

  5. Sur la page Options gérées, renseignez les champs facultatifs suivants selon vos besoins, puis sélectionnez Suivant :

    • Nom de profil

    • Critique pour l'état du déploiement

    • Démarrage automatique

    • Redémarrage automatique

      Remarque : l'ajout d'un profil et la configuration des options de démarrage et de redémarrage automatiques permettent au déploiement de redémarrer automatiquement après une interruption du réseau. Pour en savoir plus, reportez-vous à Configuration de processus gérés.

  6. Dans la page Parameter File, mettez à jour le mapping source avec TABLE source.*;

    Remarque : Il s'agit du mapping base de données/collecte source. TABLE *.*; permet d'extraire le processus de toutes les bases de données/collections.

  7. Sélectionnez Créer et exécuter pour créer et démarrer l'extraction. Si vous sélectionnez Créer, vous pouvez démarrer manuellement l'extraction ultérieurement à partir de la page Extractions.

Créer une extraction (21c)

  1. Dans la console de déploiement d'OCI GoldenGate, vérifiez que vous êtes sur la page d'aperçu du service d'administration, puis sélectionnez Ajouter un processus Extract (icône Plus).

  2. Sur la page Ajouter une extraction, sélectionnez l'une des valeurs suivantes dans le champ Type d'extraction, puis cliquez sur Suivant :

    • Chargement initial

    • Capture de données de modification

  3. Sur la page Options d'extraction, renseignez les champs comme suit, puis sélectionnez Suivant :

    1. Dans Nom de processus, entrez le nom de l'extraction.

    2. Pour Alias de connexion, sélectionnez l'alias de connexion dans la liste déroulante.

    3. Pour Source, sélectionnez Fichier.

    4. Dans Nom de fichier, entrez au moins trois caractères pour le nom de fichier.

    5. (Facultatif) Sous Options gérées, vous pouvez configurer les éléments suivants :

      • Nom de profil

      • Démarrage automatique

      • Redémarrage automatique

      Remarque : l'ajout d'un profil et la configuration des options de démarrage et de redémarrage automatiques permettent au déploiement de redémarrer automatiquement après une interruption du réseau. Pour plus d'informations, reportez-vous à Configuration des processus gérés.

  4. Dans la page Parameter File, mettez à jour le mapping source avec TABLE source.*;

    Remarque : Il s'agit du mapping base de données/collecte source. TABLE *.*; permet d'extraire le processus de toutes les bases de données/collections.

  5. Sélectionnez Créer et exécuter.

Vous revenez à la page de présentation des services d'administration. Sélectionnez le nom de l'extraction pour afficher les détails et les états de l'extraction.

Problèmes recensés

Echec des réplications lors de l'utilisation du fichier trace de l'extraction MongoDB avec BINARY_JSON_FORMAT

Lorsqu'une réplication utilise un fichier trace généré à partir d'une extraction MongoDB avec BINARY_JSON_FORMAT dans le fichier de paramètres d'extraction, la réplication échoue avec l'erreur suivante :

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)

Solution de contournement : lorsque BINARY_JSON_FORMAT est enlevé des paramètres d'extraction, le processus Replicat s'exécute correctement et les documents sont représentés au format JSON étendu.