Documentation Oracle Cloud Infrastructure

Ajout d'une réplication pour Snowflake

Découvrez comment ajouter un processus de réplication pour une cible Snowflake dans une réplication OCI GoldenGate.

Ajout d'une réplication (23ai)

Avant de commencer

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

Pour ajouter une réplication 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éplication (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éplication :
      • Réplication classique
      • Réplication coordonnée
    • Entrez un nom de processus ne dépassant pas 5 caractères.
    • Entrez une description pour aider à distinguer le processus des autres.
  3. Sur la page Options de réplication, renseignez les champs selon vos besoins, puis cliquez sur Suivant :
    1. Pour la trace de réplication :
      • Entrez un nom.
      • Saisissez un sous-répertoire, si vous pensez 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ébut, sélectionnez le point de départ du traitement des données :
        • Position dans le journal (valeur par défaut)
        • Maintenant
        • Heure personnalisée
    2. Pour la position de trace :
      • Entrez le numéro de séquence.
      • Entrez le décalage RBA.
    3. Pour Cible, sélectionnez Flocon de neige dans la liste déroulante, puis sélectionnez l'une des options suivantes :
      1. Streaming
      2. Préparer et fusionner, puis sélectionner un emplacement intermédiaire disponible
    4. Pour les informations d'identification cible :
      • Sélectionnez 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éplications 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.
    • Activez l'option Critical pour l'état du déploiement.
    • Activer et configurer 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éplication. 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.

    Remarque

    GoldenGate utilise par défaut l'heure GMT (heure de Greenwich). 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. (Facultatif) Dans la page Properties File, vérifiez la propriété :
    jvm.bootoptions : augmentez la valeur -Xmx si vous devez ajouter plus de mémoire à la JVM de réplication (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour 32 Go, etc.).
    Remarque

    Un problème connu lié au gestionnaire de transmission en continu Snowflake échoue avec l'erreur Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper". Pour résoudre ce problème, ajoutez les éléments suivants au fichier de propriétés de réplication : 
    jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true

    Pour plus d'informations sur les propriétés de cette cible et connaître les différences entre les gestionnaires intermédiaire et de fusion et de transmission en continu, reportez-vous à Snowflake dans le guide Oracle GoldenGate for Distributed Applications and Analytics.

  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)

Pour ajouter une réplication pour Snowflake dans Oracle GoldenGate 21c, procédez comme suit :
  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 une 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, saisissez le nom du processus de réplication.
    2. Dans Nom de trace, entrez un nom de trace à deux caractères.
    3. Dans Cible, sélectionnez la connexion Snowflake cible dans la liste déroulante.
    4. Dans Alias disponibles, sélectionnez votre alias dans la liste déroulante.
    5. (Facultatif) Activer le stockage externe pour sélectionner un emplacement intermédiaire disponible dans la liste déroulante.
  4. Sur la page Paramètres de réplication, ajoutez les mappings nécessaires, puis cliquez sur Suivant :
    Remarque

    • 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îne 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).
    • S'il existe des opérations de fusion à longue durée d'exécution dans Snowflake et qu'un nombre élevé de verrous sont observés, assurez-vous qu'aucune autre table ne modifie la même table. En outre, utilisez la réplication coordonnée avec prudence car elle peut entraîner un nombre élevé de verrous de table.
    • GoldenGate utilise par défaut l'heure GMT (heure de Greenwich). Utilisez SETENV pour remplacer le paramètre par défaut de la réplication. Cette modification ne s'applique pas aux déploiements. Par exemple :
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      En savoir plus sur SETENV.

  5. (Facultatif) Dans la page Properties File, vérifiez les propriétés suivantes :
    Remarque

    Ces propriétés sont définies lors de la création de la connexion et ne doivent pas être modifiées ici.
    • ggs.eventhandler.snowflake.connectionURL : URL JDBC pour la connexion à Snowflake.
    • ggs.eventhandler.snowflake.UserName : nom utilisateur de la base de données Snowflake.
    • ggs.eventhandler.snowflake.Password : mot de passe associé à l'utilisateur de base de données Snowflake.
    • ggs.eventhandler.snowflake.storageIntegration : informations d'identification de l'entrepôt de données Snowflake permettant d'accéder aux fichiers de banque d'objets respectifs. Pour plus d'informations, reportez-vous à la section Snowflake storage integration.
    • jvm.bootoptions : augmentez la valeur -Xmx si vous devez ajouter plus de mémoire à la JVM de réplication (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour 32 Go, etc.).
  6. 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 de présentation du service d'administration.
Vous retournez à la page de présentation du service d'administration, dans laquelle vous pouvez visualiser la création du processus de réplication et accéder aux actions de réplication.