Ajouter un processus de réplication pour le service de stockage d'objets pour OCI

Apprenez à ajouter et à configurer un processus de réplication pour une cible du service Stockage d'objets pour OCI.

Rubriques connexes

Avant de commencer

Avant d'ajouter le réplication, assurez-vous d'avoir les éléments suivants :

  • OCID du compartiment.

    Conseil :

    Vous pouvez trouver l'OCID du compartiment dans la page 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 Détails du compartiment.
    3. Copiez l'OCID du compartiment à partir de la section Informations sur le compartiment.

    Pour plus d'informations, voir Rechercher l'OCID d'un compartiment.

  • Nom du seau de stockage d'objets pour OCI

    Conseil :

    Oracle recommande de créer votre propre seau de stockage d'objets OCI.
    1. Ouvrez le menu de navigation de la console Oracle Cloud, sélectionnez Service de stockage, puis Seaux.
    2. Cliquez sur Créer un seau.
    3. Dans le panneau Créer un seau, entrez un nom, puis cliquez sur Créer.

    Pour plus d'informations, voir Utilisation de la console pour créer un seau.

Ajouter un rapplicat (23ai)

Avant de commencer

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

Pour ajouter un rappel dans GoldenGate 23ai :
  1. Dans la page d'accueil OCI GoldenGate console de déploiement, dans la page Service d'administration, cliquez sur Ajouter une réplication (icône plus).
  2. Dans le panneau Ajouter des informations de réplication, dans la page Informations sur le processus de réplication, remplissez les champs selon les besoins, puis cliquez sur Suivant :
    • Sélectionnez un type de réplication :
      • 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. Dans la page Options de réplication, remplissez les champs selon les besoins, puis cliquez sur Suivant :
    • Piste Répliquer :
      • Entrez un nom.
      • Entrez un sous-répertoire, si vous prévoyez que le fichier de piste se trouve dans un emplacement autre que celui par défaut.
      • Sélectionnez un profil de chiffrement. Si aucun profil de chiffrement n'a été créé, le portefeuille local est sélectionné par défaut.
      • Pour Début, sélectionnez le point de début du traitement des données :
        • Position dans le journal (valeur par défaut)
        • Now
        • Heure personnalisée
    • Position de la piste :
      • Entrez le numéro de séquence.
      • Entrez le décalage de l'authentification basée sur un jeton.
      • Sélectionnez votre cible dans la liste déroulante.

        Note :

        Selon votre sélection de cibles, vous pouvez avoir des options supplémentaires telles que Streaming, Stage and Merge et Staging locations.
    • Données d'identification cibles :
      • Sélectionner un domaine.
      • Sélectionnez un alias dans le domaine spécifié.
      • Sélectionnez une table de points de vérification. Laissez la sélection par défaut ou sélectionnez la table de points de vérification que vous avez créée pour le déploiement cible.
      • Sélectionnez le numéro d'unité d'exécution maximal (uniquement pour les réplications coordonnées).
  4. Dans la page Options gérées, remplissez les champs facultatifs selon les besoins, puis cliquez sur Suivant :
    • Sélectionnez un nom de profil, le cas échéant.
    • Activer Critique pour l'état du déploiement.
    • Activer et configurer les paramètres de démarrage automatique.
  5. Dans la page Fichier de paramètre, vous pouvez ajouter des paramètres pour configurer davantage le service de réplication. Par exemple : 
    table source.table1;

    Si vous utilisez le service 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.

    Note :

    GoldenGate utilise le temps moyen de Greenwich (GMT). Utilisez SETENV pour remplacer le paramètre par défaut de ce processus de réplication. Cette modification ne s'applique pas aux déploiements. Par exemple : 

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
  6. Dans la page Fichier de propriétés, configurez les propriétés du gestionnaire de fichiers et du gestionnaire d'événements OCI selon les besoins, puis cliquez sur Suivant. Vous pouvez envisager de modifier les propriétés suivantes :
    1. gg.handler.name.format : Sélectionnez comment mettre en forme les 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. Voir Parquet pour le stockage d'objets OCI pour plus de détails.

    2. gg.handler.name.fileNameMappingTemplate : Génère les 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 laisse ouvert pour écriture. Cette propriété ferme le fichier après le délai d'inactivité indiqué (aucune transaction entrante), puis le charge dans le stockage d'objets OCI.
    4. gg.eventhandler.name.compartmentID : Entrez l'OCID du compartiment.
    5. gg.eventhandler.name.bucketMappingTemplate : Entrez le nom du seau de stockage d'objets.

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

    Note :

    Vous pouvez également ajouter des formateurs enfichables si nécessaire. Pour plus d'informations, voir Formaturs enfichables.
  7. Cliquez sur Créer et exécuter. Si vous cliquez sur Créer, vous pourrez lancer manuellement la réplication plus tard à partir de la page d'accueil du service d'administration.

Ajouter un processus de réplication (21c)

Pour ajouter un processus de réplication pour une cible du service Stockage d'objets OCI :
  1. Dans la console de déploiement d'OCI GoldenGate, dans la page Aperçu du service d'administration, cliquez sur Ajouter une réplication (icône plus).
  2. Dans la page Add Replicat, sélectionnez un type de réplication, puis cliquez sur Next.
    Les types de réplication sont les suivants :
    • Réplication classique
    • Réplication coordonnée
  3. Dans la page Replicat Options, remplissez les champs suivants, puis cliquez sur Suivant :
    1. Pour Nom du processus, entrez un nom pour le processus de réplication.
    2. (Facultatif) Pour Description, entrez une brève description pour distinguer ce processus des autres.
    3. Pour Nom de la piste, entrez un nom de piste à deux caractères.
    4. Pour Cible, sélectionnez Service de stockage d'objets Oracle dans la liste déroulante.
    5. Pour Alias disponibles pour OCI, sélectionnez votre alias dans la liste déroulante.
  4. Dans la page Fichier de paramètres, ajoutez et configurez les paramètres de réplication nécessaires, puis cliquez sur Suivant.

    Note :

    • Si vous utilisez le processus Coordinated Replicat, 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 omis, 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 le temps moyen de Greenwich (GMT). Utilisez SETENV pour remplacer le paramètre par défaut. Par exemple :
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      En savoir plus sur SETENV.

  5. Dans la page Fichier de propriétés, configurez les propriétés du gestionnaire de fichiers et du gestionnaire d'événements OCI selon les besoins, puis cliquez sur Suivant. Vous pouvez envisager de modifier les propriétés suivantes :
    1. gg.handler.name.format : Sélectionnez comment mettre en forme les 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. Voir Parquet pour le stockage d'objets OCI pour plus de détails.

    2. gg.handler.name.fileNameMappingTemplate : Génère les 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 laisse ouvert pour écriture. Cette propriété ferme le fichier après le délai d'inactivité indiqué (aucune transaction entrante), puis le charge dans le stockage d'objets OCI.
    4. gg.eventhandler.name.compartmentID : Entrez l'OCID du compartiment.
    5. gg.eventhandler.name.bucketMappingTemplate : Entrez le nom du seau de stockage d'objets.

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

    Note :

    Vous pouvez également ajouter des formateurs enfichables si nécessaire. Pour plus d'informations, voir Utilisation des formateurs enfichables.
  6. Cliquez sur Ajouter et exécuter.
Vous retournez à la page Aperçu du service d'administration, où vous pouvez surveiller le statut du processus de réplication. Cliquez sur le nom du processus pour consulter ses détails et accéder aux rapports.

Problèmes connus

Erreur de réplication du service de stockage d'objets pour OCI lors de l'utilisation du principal de ressource

Si un principal de ressource est utilisé pour l'authentification, le processus de réplication é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 de l'OCID de l'utilisateur dans la connexion au service de stockage d'objets pour OCI (utilisateurs fédérés seulement)

Si un utilisateur fédéré sélectionne Utiliser l'utilisateur courant lors de la création d'une connexion au service de stockage d'objets pour OCI, son OCID ne correspond pas à l'OCID sélectionné par le système.

Solution de rechange : Lorsque vous créez une connexion au service de stockage d'objets pour OCI, sélectionnez Sélectionner un autre utilisateur, puis entrez l'OCID de l'utilisateur fédéré.

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