Ajout d'une réplication pour Snowflake

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

Avant de commencer

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 :

    1. Pour la trace Replicat :

      • 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

    2. Pour la position de trace :

      • Entrez le numéro de séquence.

      • Entrez le décalage RBA.

    3. Pour Cible, sélectionnez Snowflake dans la liste déroulante, puis sélectionnez l'une des options suivantes :

      1. Transmission en continu

      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 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. (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 Replicat (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour jusqu'à 32 Go, etc.).

      Remarque : un problème connu lié au gestionnaire de flux Snowflake échoue avec l'erreur Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper". Pour contourner ce problème, ajoutez les éléments suivants à votre fichier de propriétés Replicat :

      jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true

    Pour plus d'informations sur les propriétés de cette cible et découvrir les différences entre les gestionnaires Stage et Merge et Streaming, reportez-vous à Snowflake dans le guide Oracle GoldenGate for Distributed Applications and Analytics.

  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)

Pour ajouter une réplication pour Snowflake dans Oracle GoldenGate 21c, procédez comme suit :

  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 un nom pour le processus de réplication.

    2. Dans Nom de piste, entrez un nom de piste à deux traits.

    3. Pour Cible, sélectionnez la connexion Snowflake cible dans la liste déroulante.

    4. Pour Alias disponibles, sélectionnez votre alias dans la liste déroulante.

    5. (Facultatif) Activez 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 sélectionnez Suivant :

    Remarque :

    • Si vous utilisez le processus Replicat coordonné, 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/.properties

    L'utilisation d'une réplication coordonnée entraînera la création de plusieurs fichiers. En cas d'omission, l'erreur suivante se produit :

    OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file "/u02/Deployment/etc/conf/ogg/001.properties" (error 2, No such file or directory).

    • S'il existe des opérations de fusion de longue durée 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 du processus Replicat. Cette modification ne s'applique pas aux déploiements. 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 permettant à l'entrepôt de données Snowflake d'accéder aux fichiers de banque d'objets respectifs. Pour plus d'informations, voir Intégration du stockage Snowflake.

    • jvm.bootoptions : augmentez la valeur -Xmx si vous devez ajouter plus de mémoire à la JVM Replicat (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour jusqu'à 32 Go, etc.)

  6. Sélectionnez Créer et exécuter. Si vous sélectionnez Créer, vous pouvez lancer la réplication manuellement ultérieurement à partir de la page d'aperçu du service d'administration.

Vous retournez à la page Aperçu du service d'administration, dans laquelle vous pouvez visualiser la création du processus Replicat et accéder aux actions Replicat.

Contenu connexe

Problèmes recensés

Bug 37518857 : OGGDAA GGS Snowflake Streaming Erreur de réplication

Le gestionnaire de diffusion Snowflake échoue avec : Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Solution de contournement : ajoutez les éléments suivants à votre fichier de propriétés de réplication :

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true