Ajout d'une extraction pour MongoDB

L'extraction est un processus qui est exécuté sur la connexion à la source de données source et qui extrait (ou capture) des données. Découvrez comment ajouter une extraction pour MongoDB.

Rubriques connexes

Ajout d'une extraction (26ai)

Avant de commencer, vérifiez que vous :
  • Vérifiez les détails propres à ce type de connexion source.
  • Configurez un ensemble de réplication MongoDB :
    • OCI GoldenGate for Big Data utilise le journal des opérations (oplog) pour lire les enregistrements de capture des données de modification (CDC). L'oplog est une collection plafonnée dans MongoDB qui conserve un enregistrement non simultané de toutes les opérations qui modifient la base de données. Les fichiers Oplog sont créés lorsqu'un ensemble de répliques est activé dans MongoDB.
    • MongoDB Atlas est préconfiguré avec un ensemble de réplication. Pour les déploiements MongoDB sur site, vous devez configurer et déployer manuellement un ensemble de réplication pour activer la fonctionnalité oplog et CDC. Pour MongoDB on-premise, vous devez déployer un ensemble de répliques.
  • Utilisez MongoDB version 3.6 ou ultérieure.
  • Ayez la prise en charge d'OCI GoldenGate pour capturer les opérations suivantes : INSERT, UPDATE, DELETE.
Afin d'ajouter une extraction pour MongoDB, procédez comme suit :
  1. Dans le menu d'accès de la console de déploiement OCI GoldenGate, cliquez sur Extractions.
  2. Dans le panneau Ajouter une extraction, sur la page Informations sur l'extraction, renseignez les champs suivants selon vos besoins, puis cliquez sur 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.
  3. Sur la page Options d'extraction, renseignez les champs suivants selon vos besoins, puis cliquez sur Suivant :
    1. Pour Piste d'extraction :
      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. Dans Informations d'identification source, sélectionnez les éléments suivants :
      1. Domaine
      2. Alias
      3. Quand et où commencer
  4. Sur la page Options gérées, renseignez les champs facultatifs suivants, le cas échéant, puis cliquez sur Suivant :
    • Nom de profil
    • Critique pour l'état du déploiement
    • Démarrage automatique
    • Redémarrage automatique

    Remarques :

    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 des processus gérés.

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

    Remarques :

    Correspondance de base de données/collecte source. TABLE *.*; permet d'extraire le processus de toutes les bases de données/collections.
  6. Cliquez sur Créer et exécuter pour créer et démarrer l'extraction. Si vous cliquez sur Créer, vous pouvez démarrer manuellement l'extraction ultérieurement à partir de la page Extractions.

Ajout d'une extraction (21c)

Découvrez comment ajouter un processus d'extraction pour une source MongoDB dans OCI GoldenGate

Afin d'ajouter une extraction pour MongoDB, procédez comme suit :
  1. Dans la console du déploiement OCI GoldenGate, vérifiez que vous êtes sur la page d'aperçu du service d'administration, puis cliquez sur Ajouter un extraction (icône Plus).
  2. Sur la page Ajouter une extraction, dans le champ Type d'extraction sélectionnez l'une des valeurs suivantes, 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 cliquez sur Suivant :
    1. Dans Nom de processus, entrez le nom de l'extraction.
    2. Dans Alias de connexion, sélectionnez l'alias de connexion dans la liste déroulante.
    3. Dans 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

      Remarques :

      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.*;

    Remarques :

    Correspondance de base de données/collecte source. TABLE *.*; permet d'extraire le processus de toutes les bases de données/collections.
  5. Cliquez sur Créer et exécuter.
Vous revenez à la page de présentation des services d'administration. Cliquez sur le nom de l'extraction pour afficher les détails et les états de l'extraction.

Problèmes recensés

Replicats échoue lors de l'utilisation de Trail file à partir de MongoDB Extract avec BINARY_JSON_FORMAT

Lorsqu'un élément Replicat utilise un élément Trail file généré à partir d'un élément MongoDB Extract avec BINARY_JSON_FORMAT dans le fichier de paramètres Extract, l'élément Replicat é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 Extract, Replicat s'exécute correctement et les documents sont représentés au format JSON étendu.