Se connecter à MongoDB

Voyez comment créer une connexion à MongoDB à utiliser comme source ou cible pour OCI GoldenGate.

Avant de commencer

Avant de créer la connexion, assurez-vous de :
  • Vérifiez la façon dont OCI GoldenGate se connecte à votre source et à vos cibles.
  • Configurer les politiques requises pour activer l'accès sécurisé au service de chambre forte et aux clés secrètes, telles que l'utilisation de clés secrètes, l'utilisation de chambres fortes et la lecture de regroupements de clés secrètes. Pour plus d'informations, voir Politiques recommandées minimales.
  • Configurez un jeu de réplications MongoDB :
    • OCI GoldenGate pour le service de mégadonnées utilise le journal des opérations (oplog) pour lire les enregistrements de saisie de modification de données (CDC). L'oplog est une collection plafonnée dans MongoDB qui tient à jour un enregistrement continu de toutes les opérations qui modifient la base de données. Les fichiers Oplog sont créés lorsqu'un jeu de répliques est activé dans MongoDB.
    • MongoDB Atlas est préconfiguré avec un jeu de réplication. Pour les déploiements MongoDB sur place, vous devez configurer et déployer manuellement un jeu de réplication pour activer la fonctionnalité oplog et CDC. Pour MongoDB sur place, vous devez déployer un jeu de répliques.
  • Avoir MongoDB version 3.6 ou ultérieure.
  • Avoir la prise en charge d'OCI GoldenGate pour saisir les opérations suivantes : INSERT, UPDATE, DELETE.

Créer la connexion

Pour créer une connexion à MongoDB :
  1. Dans la page Aperçu d'OCI GoldenGate, cliquez sur Connexions.
    Vous pouvez également cliquer sur Créer une connexion dans la section Démarrer et passer à l'étape 3.
  2. Dans la page Connexions, cliquez sur Créer une connexion.
  3. Dans la page Create Connection, remplissez les champs comme suit :
    1. Dans Nom, entrez un nom pour la connexion.
    2. (Facultatif) Pour Description, entrez une description qui vous aide à distinguer cette connexion des autres.
    3. (Pour GoldenGate sur multinuage uniquement) Sélectionnez votre abonnement, puis remplissez les champs suivants.
      1. Dans la liste déroulante Compartiment, sélectionnez le compartiment dans lequel réside l'ancre de ressource.
      2. Sélectionnez la région partenaire multinuage.
      3. Sélectionnez votre zone de disponibilité du partenaire. Les options disponibles sont alimentées en fonction de la région partenaire multinuage sélectionnée.
    4. Pour compartiment, sélectionnez le compartiment dans lequel créer la connexion.
    5. Pour Type, sélectionnez MongoDB.
    6. Pour Chaîne de connexion, entrez un URI de chaîne de connexion MongoDB valide sans nom d'utilisateur et mot de passe. Par exemple, mongodb://mongodb1.example.com:27017.
    7. Pour Nom d'utilisateur, entrez le nom d'utilisateur de cette base de données.
    8. Sélectionnez la clé secrète du mot de passe. Si elle se trouve dans un autre compartiment, utilisez la liste déroulante pour modifier les compartiments.

      Note :

      • Les clés secrètes sont des données d'identification telles que des mots de passe, des certificats, des clés SSH ou des jetons d'authentification que vous utilisez avec les services OCI. Pour créer une clé secrète, voir Création d'une clé secrète. Veillez à :
        • Sélectionnez Génération manuelle des clés secrètes.
        • Collez les données d'identification dans le contenu de la clé secrète.
      • Si vous préférez ne pas utiliser de clés secrètes de mot de passe, désélectionnez Utiliser des clés secrètes dans la chambre forte dans l'onglet Paramètres sous Options avancées, situé au bas de ce formulaire.
    9. Pour Protocole de sécurité, sélectionnez le protocole de sécurité :
      • Plain : authentification par nom d'utilisateur et mot de passe.
      • TLS : TLS avec nom d'utilisateur et mot de passe.
      • MTLS : MTLS avec nom d'utilisateur et mot de passe.
    10. Développez Afficher les options avancées. Vous pouvez configurer les options suivantes :
      • Sécurité
        • Désélectionnez Utiliser les clés secrètes de chambre forte que vous préférez ne pas utiliser de clés secrètes de mot de passe pour cette connexion. Si non sélectionné :
          • Sélectionnez Utiliser une clé de chiffrement gérée par Oracle pour laisser toute la gestion des clés de chiffrement à Oracle.
          • Sélectionnez Utiliser une clé de chiffrement gérée par le client pour sélectionner une clé de chiffrement spécifique stockée dans votre chambre forte OCI pour chiffrer vos données d'identification de connexion.
      • Connectivité réseau
        • Point d'extrémité partagé, pour partager un point d'extrémité avec le déploiement affecté. Vous devez autoriser la connectivité à partir de l'adresse IP entrante du déploiement.
        • Point d'extrémité dédié, pour le trafic réseau au moyen d'un point d'extrémité dédié dans le sous-réseau affecté dans votre VCN. Vous devez autoriser la connectivité à partir des adresses IP entrantes de cette connexion.

          Note :

      • Attributs de sécurité : Ajoutez des attributs de sécurité pour contrôler l'accès à cette connexion à l'aide du routage ZPR (Zero Trust Packet Routing).
      • Marqueurs : Ajoutez des marqueurs pour organiser vos ressources.
  4. Cliquez sur Créer.
Une fois la connexion créée, elle apparaît dans la liste Connexions. Assurez-vous d'affecter la connexion à un déploiement pour pouvoir l'utiliser en tant que source ou cible dans une réplication.

Problèmes connus

La connexion MongoDB à OCI GoldenGate ne prend pas en charge les chaînes de connexion mongdb+srv.

Solution de rechange : Utilisez les chaînes de connexion MongoDB.

  1. Dans l'Atlas MongoDB, cliquez sur Connexion.
  2. Sélectionnez Pilotes.
  3. Sélectionnez Java.
  4. Pour Version, sélectionnez 3.4 ou une version ultérieure.
  5. Vous pouvez utiliser la chaîne mongodb fournie. Par exemple :
    mongodb://<user_name>:<db_password>@cluster0-shard-00-00.abc.mongodb.net:27017,cluster0-shard-00-01.abc.mongodb.net:27017,cluster0-shard-00-02.abc.mongodb.net:27017/?ssl=true&replicaSet=atlas-3grqh1-shard-0&authSource=admin&retryWrites=true&w=majority&appName=Cluster0

Problème avec MongoDB Tester la connexion

Vous pouvez rencontrer une erreur lors de l'utilisation de Test connection avec les connexions MongoDB. Vous pouvez ignorer cette erreur et tester les connexions MongoDB dans la console de déploiement OCI GoldenGate. Dans la console de déploiement, ouvrez le menu de navigation de Administration Service, cliquez sur Configuration. Votre connexion MongoDB doit être répertoriée en tant que données d'identification, où vous pouvez cliquer sur Se connecter à <alias> pour tester la connexion.