Répliquer des données de MongoDB vers OCI GoldenGate

Découvrez comment répliquer des données de MongoDB vers Autonomous AI JSON Database à l'aide d'OCI GoldenGate.

Autonomous AI JSON Database est un service d'une base de données de document cloud qui facilite le développement d'applications axées sur JSON. Il comprend des API de documents de type NoSQL (Oracle SODA et Oracle AI Database API for MongoDB), une mise à l'échelle sans serveur, des transactions ACID hautes performances, une sécurité complète et une tarification à l'utilisation faible. En savoir plus sur Autonomous AI JSON Database.

Le type de déploiement Big Data d'OCI GoldenGate ne prend en charge aucune migration en temps d'arrêt de MongoDB vers Autonomous AI JSON Database. OCI GoldenGate prend en charge à la fois l'extraction de chargement initial et l'extraction de capture de données de modification (CDC) à partir de MongoDB.

Ce démarrage rapide détaille le processus de configuration d'OCI GoldenGate pour une migration sans temps d'arrêt de MongoDB vers Autonomous AI JSON Database.

Avant de commencer

Pour mener à bien ce démarrage rapide, vous devez disposer des éléments suivants :

Ensemble de répliques MongoDB configuré.
- La capture Big Data d'OCI GoldenGate utilise le journal des opérations (oplog) pour lire les enregistrements CDC. L'oplog est une collection plafonnée qui conserve un enregistrement continu de toutes les opérations qui modifient les données stockées dans vos bases de données. Les fichiers Oplog sont créés dans MongoDB lorsque l'ensemble de réplication est activé. MongoDB Atlas est livré avec une configuration d'ensemble de réplication préconfigurée. Pour MongoDB on-premise, vous devez déployer un ensemble de répliques.
MongoDB 3.6 et versions ultérieures.
Prise en charge d'OCI GoldenGate pour la capture des opérations suivantes : INSERT, UPDATE, DELETE.

Pour en savoir plus, reportez-vous à Utilisation d'Oracle GoldenGate Capture pour MongoDB.

Tâche 1 : créer les ressources OCI GoldenGate

Cet exemple de démarrage rapide nécessite des déploiements et des connexions pour la source et la cible.

Créer une base de données Oracle Autonomous AI JSON Database.
Créez un déploiement Big Data.
Créez une connexion MongoDB.
Créez une connexion pour la cible Créer une connexion Autonomous AI JSON Database.
Créez une connexion à GoldenGate, puis affectez cette connexion au déploiement Big Data.
Affectez MongoDB et Autonomous AI JSON Database au déploiement Big Data.

Tâche 2 : créer et exécuter l'extraction intégrée pour MongoDB

Dans la console de déploiement d'OCI GoldenGate, vérifiez que vous êtes sur la page Extractions, puis sélectionnez Ajouter un extrait (icône Plus).
Ajoutez une extraction avec les valeurs suivantes :
1. Sur la page Informations d'extraction, sous Type d'extraction, sélectionnez Extraction intégrée, entrez MCDC en tant que nom de processus, puis sélectionnez Suivant.
2. Dans la page Fichier de paramètres, assurez-vous que le mapping source inclut TABLE source.*;.
Sélectionnez Créer et exécuter.

Tâche 3 : créer et exécuter l'extraction de chargement initial pour MongoDB

Dans la console de déploiement d'OCI GoldenGate, vérifiez que vous êtes sur la page Extractions, puis sélectionnez Ajouter un extrait (icône Plus).
Ajoutez une extraction avec les valeurs suivantes :
1. Dans la page Extract Information :
  - Pour le type d'extraction, sélectionnez Extraction de chargement initial.
  - Pour le nom du processus, entrez MIL.
2. Dans la page Parameter File, apportez les modifications suivantes :
  - Localisez la ligne EXTTRAIL et remplacez $extfilePath par votre nom de trace. Exemple :
```
EXTFILE I1
```
  - Définissez le mapping source en tant que TABLE source.*;.
  Remarque : Il s'agit du mapping base de données/collecte source. `TABLE *. entraîne l'extraction de toutes les bases de données/collections.
3. Sélectionnez Créer et exécuter.
  
  Lorsque l'extraction de chargement initial MongoDB s'exécute correctement, les statistiques sont affichées dans le fichier de rapport d'extraction.

Tâche 4 : créer et exécuter le processus de réplication de chargement initial

Dans la console de déploiement OCI GoldenGate, vérifiez que vous êtes sur la page Réplications, puis sélectionnez Ajouter une réplication (icône Plus).
Ajoutez le Replicat de chargement initial avec les valeurs suivantes :
1. Sur la page Ajouter une réplication, sous Type de réplication, sélectionnez Classique, entrez un nom de processus, puis sélectionnez Suivant.
2. Dans la page Options de réplication :
  - Dans Nom, saisissez le nom de l'élément de trace dans la tâche 3 (I1).
  - Pour Domaine, sélectionnez un domaine.
  - Pour Alias, sélectionnez la connexion de base de données JSON Autonomous AI créée dans la tâche 1.
  - Dans Table de point de reprise, sélectionnez la table du point de reprise qui a été créée pour le déploiement cible.
3. Sur la page Options gérées, laissez les champs tels quels, puis sélectionnez Suivant.
4. Dans la page Paramètres de réplication, vous pouvez indiquer des paramètres pour configurer davantage la réplication :
```
MAP *.*, TARGET *.*;
```
Sélectionnez Créer et exécuter :

Vous retournez à la page de présentation, dans laquelle vous pouvez consulter les détails de la réplication. Lorsque le processus Replicat démarre avec succès, vous le voyez dans un état en cours d'exécution avec une coche verte. Vous pouvez consulter les détails et les statistiques du processus Replicat pour confirmer la réplication.

Tâche 5 : créer et exécuter la réplication classique

Dans la console de déploiement OCI GoldenGate, vérifiez que vous êtes sur la page Réplications, puis sélectionnez Ajouter une réplication (icône Plus).
Ajoutez une réplication avec les valeurs suivantes :
1. Sur la page Informations sur le processus de réplication, sous Type de processus de réplication, sélectionnez Réplication classique, entrez MCDC comme nom de processus, puis sélectionnez Suivant.
2. Sur la page Fichier de paramètres, vous indiquez les paramètres permettant de configurer davantage le processus Replicat, puis sélectionnez Créer et exécuter :
```
HANDLECOLLISIONS
MAP *.*, TARGET *.*;
```
  Remarque : ajoutez HANDLECOLLISIONS pour résoudre les problèmes liés aux enregistrements en double ou manquants lors de l'application du processus de réplication. Le paramètre HANDLECOLLISIONS a un impact négatif sur les performances et c'est pourquoi il est recommandé de l'utiliser si nécessaire. Lorsque la source et la cible sont synchronisées, vous pouvez arrêter la réplication CDC, enlever HANDLECOLLISIONS et redémarrer la réplication.

Vous retournez à la page de présentation, dans laquelle vous pouvez consulter les détails de la réplication. Lorsque le processus Replicat démarre avec succès, vous le voyez dans un état en cours d'exécution avec une coche verte. Vous pouvez vérifier les détails et les statistiques du processus Replicat pour confirmer la réplication.