Ajout d'une réplication pour OCI Object Storage

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

Rubriques connexes

Avant de commencer

Avant d'ajouter la réplique, assurez-vous que vous disposez des éléments suivants :

  • OCID du compartiment.

    Conseil :

    Vous pouvez trouver l'OCID de compartiment sur la page des détails du compartiment.
    1. Ouvrez le menu de navigation de la console Oracle Cloud, 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 OCI Object Storage

    Conseil :

    Oracle vous recommande de créer votre propre bucket OCI Object Storage.
    1. Ouvrez le menu de navigation de la console Oracle Cloud, sélectionnez Storage, puis Buckets.
    2. Cliquez sur Créer un bucket.
    3. Dans le panneau Créer un bucket, entrez un nom, puis cliquez sur Créer.

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

Ajout d'une république (23ai)

Avant de commencer

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

Pour ajouter une réplique dans GoldenGate 23ai, procédez comme suit :
  1. Dans la console de déploiement OCI GoldenGate, sur la page d'accueil du service d'administration, cliquez sur Ajouter une république (icône Plus).
  2. Dans le panneau Ajouter une réplication, sur la page Informations sur la réplication, renseignez les champs selon vos besoins, puis cliquez sur Suivant :
    • Sélectionnez un type de réplicat :
      • Réplication classique
      • Réplication coordonnée
    • Entrez un nom de processus de 5 caractères au maximum.
    • Entrez une description pour distinguer ce processus des autres.
  3. Sur la page Options de réplication, renseignez les champs selon vos besoins, puis cliquez sur 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 emplacement autre 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émarrer, 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 la valeur RBA Offset.
      • Sélectionnez votre cible dans la liste déroulante.

        Remarques :

        Selon votre sélection de cible, vous pouvez disposer d'options supplémentaires, telles que Streaming, Préparer et fusionner, et Emplacements intermédiaires.
    • Informations d'identification des cibles:
      • Sélectionner un domaine.
      • Sélectionnez un alias dans le domaine spécifié.
      • Sélectionnez une table de point de reprise. Conservez la sélection par défaut ou sélectionnez la table de point de reprise que vous avez créée pour le déploiement cible.
      • Sélectionnez le nombre maximal de threads (répliques coordonnées uniquement).
  4. Sur la page Options gérées, renseignez les champs facultatifs selon vos besoins, puis cliquez sur Suivant :
    • Sélectionnez un nom de profil, le cas échéant.
    • Activer Critical pour l'état du déploiement.
    • Activez et configurez les paramètres de démarrage automatique.
  5. Sur la page Fichier de paramètres, vous pouvez ajouter des paramètres pour configurer davantage la réplique. Par exemple :
    table source.table1;

    Si vous utilisez la réplication coordonnée, ajoutez TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties au fichier de paramètres.

    Remarques :

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

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
  6. Sur la page Fichier de propriétés, configurez les propriétés du gestionnaire de fichiers et du 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 OCI Object Storage.

    2. gg.handler.name.fileNameMappingTemplate : génère des noms de fichier de manière dynamique à l'aide de mots-clés de modèle.
    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 transaction entrante) indiquée, puis le charge dans OCI Object Storage.
    4. gg.eventhandler.name.compartmentID : entrez l'OCID du compartiment.
    5. gg.eventhandler.name.bucketMappingTemplate : entrez le nom du bucket Object Storage.

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

    Remarques :

    Vous pouvez également ajouter des programmes de formatage pluggables selon vos besoins. Pour plus d'informations, reportez-vous à Formateurs pluggables.
  7. Cliquez sur Créer et exécuter. Si vous cliquez sur Créer, vous pouvez lancer la réplication manuellement ultérieurement à partir de la page d'accueil du service d'administration.

Ajout d'une réplication (21c)

Procédure d'ajout d'une réplication pour une cible OCI Object Storage :
  1. Dans la console de déploiement OCI GoldenGate, sur la page de présentation du service d'administration, cliquez sur 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 cliquez sur 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ètres, ajoutez et configurez les paramètres de réplication nécessaires, puis cliquez sur Suivant.

    Remarques :

    • Si vous utilisez la réplication coordonnée, ajoutez les paramètres suivants sur la deuxième ligne du fichier de paramètres :
      TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties

      L'utilisation de la réplication coordonnée entraînera la création de plusieurs fichiers.

      Si cette option est omise, l'erreur suivante s'affiche :

      OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
    • GoldenGate utilise par défaut l'heure GMT (heure de Greenwich). Utilisez SETENV pour remplacer le paramètre par défaut. Exemple :
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      En savoir plus sur SETENV.

  5. Sur la page Fichier de propriétés, configurez les propriétés du gestionnaire de fichiers et du 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 OCI Object Storage.

    2. gg.handler.name.fileNameMappingTemplate : génère des noms de fichier de manière dynamique à l'aide de mots-clés de modèle.
    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 transaction entrante) indiquée, puis le charge dans OCI Object Storage.
    4. gg.eventhandler.name.compartmentID : entrez l'OCID du compartiment.
    5. gg.eventhandler.name.bucketMappingTemplate : entrez le nom du 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.

    Remarques :

    Vous pouvez également ajouter des programmes de formatage pluggables selon vos besoins. Pour plus d'informations, reportez-vous à Utilisation des programmes de formatage pluggables.
  6. Cliquez sur 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. Cliquez sur le nom du processus pour en afficher les détails et accéder aux rapports.

Problèmes connus

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

Si un principal de ressource est utilisé pour l'authentification, le processus Replicat échoue et rencontre 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

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

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

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

Pour rechercher l'OCID utilisateur, cliquez sur 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, cliquez sur Afficher pour l'OCID.