Ajout d'une réplication pour Oracle Object Storage

Découvrez comment ajouter et configurer un processus de réplication pour un cible Oracle Object Storage.

Avant de commencer

Avant d'ajouter la réplication, assurez-vous de disposer des éléments suivants :

• Remarques concernant la configuration et meilleures pratiques pour Oracle Object Storage

• OCID du compartiment.

  Conseil : vous pouvez trouver l'OCID de compartiment sur la page des détails de compartiment.

  1. Ouvrez le menu Oracle Cloud de navigation dans la console, sélectionnez Identité, puis Compartiments.

  2. Sélectionnez votre compartiment dans la liste pour accéder à la page des détails du compartiment.

  3. Copiez l'OCID du compartiment à partir de la section Informations sur le compartiment.

  Pour plus d'informations, reportez-vous à Recherche de l'OCID d'un compartiment.

• Nom de bucket Oracle Object Storage

  A savoir : Oracle vous recommande de créer votre propre bucket Oracle Object Storage.

  1. Ouvrez le menu Oracle Cloud de navigation dans la console, sélectionnez Stockage, puis Buckets.

  2. Sélectionnez Créer un bucket.

  3. Dans le panneau Créer un compartiment, entrez un nom, puis sélectionnez Créer.

  Pour plus d'informations, reportez-vous à Utilisation de la console pour créer un bucket.

Ajout d'une réplication (26ai)

Vérifiez les prérequis propres à ce type de cible.

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

2. Sur la page Replicat, sélectionnez Ajouter une réplication.

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

   • Sélectionnez un type de réplication :

     • Réplication classique

     • Réplication coordonnée

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

   • Entrez une description pour aider à distinguer ce processus des autres.

4. Sur la page Options de réplication, renseignez les champs selon vos besoins, puis sélectionnez Suivant :

   • Trace de réplication:

     • Entrez un nom.

     • Entrez un sous-répertoire si vous prévoyez que le fichier de trace se trouve à un autre emplacement que celui par défaut.

     • Sélectionnez un profil de cryptage. Si aucun profil de cryptage n'a été créé, le portefeuille local est sélectionné par défaut.

     • Dans Début, sélectionnez le point de départ du traitement des données :

       • Position dans le journal (valeur par défaut)

       • Now

       • Heure personnalisée

   • Position de trace:

     • Entrez le numéro de séquence.

     • Entrez le décalage RBA.

     • Sélectionnez votre cible dans la liste déroulante.

       Remarque : en fonction de votre sélection de cible, vous pouvez disposer d'options supplémentaires telles que les emplacements de diffusion en continu, de transfert, de fusion et de transfert.

   • Informations d'identification des cibles:

     • Sélectionnez un domaine.

     • Sélectionnez un alias dans le domaine spécifié.

     • Sélectionnez une table de points de reprise. Conservez la sélection par défaut ou sélectionnez la table de point de reprise créée pour le déploiement cible.

     • Sélectionnez le nombre maximal de threads (Réplications coordonnées uniquement).

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

   • Sélectionnez un nom de profil, le cas échéant.

   • Critique pour l'état du déploiement.

   • Activer et configurer les paramètres de démarrage automatique.

6. Sur la page Fichier de paramètre, vous pouvez ajouter des paramètres pour configurer davantage la réplication. Exemple :

   table source.table1;

   Remarque :

   GoldenGate utilise par défaut l'heure GMT (heure de Greenwich). Utilisez SETENV pour remplacer le paramètre par défaut du processus Replicat. Cette modification ne s'applique pas aux déploiements. Exemple :

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

7. Sur la page Fichier de biens, configurez les propriétés du gestionnaire de fichiers et le gestionnaire d'événements OCI selon vos besoins, puis cliquez sur Suivant. Voici quelques propriétés que vous pouvez envisager de modifier :

   1. gg.handler.name.format : sélectionnez le format des données de sortie. Les options disponibles sont les suivantes :

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Pour le parquet, vous devez appliquer des propriétés supplémentaires. Pour plus de détails, reportez-vous à Parquet pour Oracle Object Storage.

   2. gg.handler.name.fileNameMappingTemplate : génère des noms de fichier à l'aide de mots-clés de modèle de manière dynamique.

   3. gg.handler.name.inactivityRollInterval : GoldenGate crée un fichier et le garde ouvert pour écriture. Cette propriété ferme le fichier après la période d'inactivité (aucune transactions entrante) indiquée, puis le chargement dans Oracle Object Storage.

   4. gg.eventhandler.name.compartmentID : entrez l'OCID du compartiment.

   5. gg.eventhandler.name.bucketMappingTemplate : entrez le nom de bucket Object Storage.

   En savoir plus sur les propriétés du gestionnaire d'écriture de fichier et de la configuration du gestionnaire d'événements OCI.

   Remarque : vous pouvez également ajouter des programme de formatage pluggables selon vos besoins. Pour plus d'informations, reportez-vous à Programmes de formatage pluggables.

8. Sélectionnez Créer et exécuter. Si vous sélectionnez Créer, vous pouvez démarrer manuellement le processus Replicat ultérieurement à partir de la page Réplications.

Ajout d'une réplication (21c)

1. Sur la page d'aperçu du service d'administration, sur la console de déploiement d'OCI GoldenGate, sélectionnez Ajouter une réplication (icône Plus).

2. Sur la page Ajouter un réplication, sélectionnez un type de réplication, puis cliquez sur Suivant.

   Les types de réplication sont les suivants :

   • Réplication classique

   • Réplication coordonnée

3. Sur la page Options de réplication, renseignez les champs suivants, puis sélectionnez Suivant :

   1. Dans Nom de processus, entrez le nom du processus de réplication.

   2. (Facultatif) Dans Description, entrez une brève description permettant de distinguer le processus des autres.

   3. Dans Nom de trace, entrez un nom de trace à deux caractères.

   4. Dans Cible, sélectionnez Oracle Object Storage dans la liste déroulante.

   5. Dans Alias disponibles pour OCI, sélectionnez votre alias dans la liste déroulante.

4. Sur la page Fichier de param., ajoutez et configurez les paramètres de réplication nécessaires, puis cliquez sur Suivant.

   table source.table1;

   Remarque :

   GoldenGate utilise par défaut l'heure GMT (heure de Greenwich). Utilisez SETENV pour remplacer le paramètre par défaut de l'extraction. Cette modification s'applique uniquement au processus Extract et non au déploiement.

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

5. Sur la page Fichier de biens, configurez les propriétés du gestionnaire de fichiers et le gestionnaire d'événements OCI selon vos besoins, puis cliquez sur Suivant. Voici quelques propriétés que vous pouvez envisager de modifier :

   1. gg.handler.name.format : sélectionnez le format des données de sortie. Les options disponibles sont les suivantes :

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Pour le parquet, vous devez appliquer des propriétés supplémentaires. Pour plus de détails, reportez-vous à Parquet pour Oracle Object Storage.

   2. gg.handler.name.fileNameMappingTemplate : génère des noms de fichier à l'aide de mots-clés de modèle de manière dynamique.

   3. gg.handler.name.inactivityRollInterval : GoldenGate crée un fichier et le garde ouvert pour écriture. Cette propriété ferme le fichier après la période d'inactivité (aucune transactions entrante) indiquée, puis le chargement dans Oracle Object Storage.

   4. gg.eventhandler.name.compartmentID : entrez l'OCID du compartiment.

   5. gg.eventhandler.name.bucketMappingTemplate : entrez le nom de bucket Object Storage.

   En savoir plus sur les propriétés du gestionnaire de processus d'écriture de fichier et du gestionnaire d'événements OCI.

   Remarque : vous pouvez également ajouter des programme de formatage pluggables selon vos besoins. Pour plus d'informations, reportez-vous à Utilisation des programmes de formatage pluggables.

6. Sélectionnez Ajouter et exécuter.

Vous revenez à la page de présentation du service d'administration, dans laquelle vous pouvez surveiller le statut du processus de réplication. Sélectionnez le nom du processus pour en afficher les détails et accéder aux rapports.

Contenu connexe

• Détails de la cible Oracle Object Storage

Problèmes connus avec les connexions Oracle Object Storage

Erreur de réplication Oracle Object Storage lors de l'utilisation du principal de ressource

Si votre connexion Oracle Object Storage utilise l'authentification du principal de ressource, le processus Replicat échoue avec l'erreur suivante :

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Solution de contournement : pour contourner ce problème, modifiez la connexion, puis sélectionnez une autre méthode d'authentification.

Non-concordance d'OCID utilisateur dans la connexion à Oracle Object Storage (utilisateurs fédérés uniquement)

Si un utilitaire fédéré sélectionne Utiliser l'utilisateur en cours lors de la création d'une connexion à Oracle Object Storage, son OCID ne correspond pas à l'OCID récupéré par le système.

Solution : lorsque vous créez une connexion à Oracle Object Storage, veillez à choisir Indiquer un autre utilisateur, puis entrez l'OCID de l'utilisateur fédéré.

Pour rechercher l'OCID utilisateur, sélectionnez Profil dans l'en-tête global de la console Oracle Cloud, puis sélectionnez le nom utilisateur. Sur la page Détails de l'utilisateur, sous Informations utilisateur, sélectionnez Afficher pour l'OCID.