Vérifiez que les tables cibles existent dans la base de données Snowflake.
Vous devez avoir des comptes en nuage Amazon Web Services, Google Cloud Platform ou Azure configurés si vous avez l'intention d'utiliser l'un des emplacements externes tels que S3, ADLS Gen2 ou GCS.
Chaîne de connexion du pilote JDBC Snowflake
Privilèges d'utilisateur de base de données Snowflake
L'utilisateur de base de données utilisé pour la réplication dans Snowflake doit disposer des privilèges suivants :
INSERT, UPDATE, DELETE et TRUNCATE sur les tables cibles.
CREATE et DROP sur Snowflake nommés étape et étape externe.
Si vous utilisez une table intermédiaire externe (S3, ADLS, GCS), CREATE, ALTER et la table externe DROP.
Dans la console de déploiement GoldenGate d'OCI, dans la page d'accueil du service d'administration, cliquez sur Ajouter une réplication (icône plus).
Dans le panneau Ajouter une réplication, dans la page Informations sur la 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 ne dépassant pas 5 caractères.
Entrez une description pour distinguer ce processus des autres.
Dans la page Options de réplication, remplissez les champs si nécessaire, puis cliquez sur Suivant :
Pour la piste de réplication :
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
Pour la position de piste :
Entrez le numéro de séquence.
Entrez le décalage RBA.
Pour Cible, sélectionnez Flocage de neige dans la liste déroulante, puis sélectionnez l'une des options suivantes :
Flux
Stocker temporairement et fusionner, puis sélectionner un emplacement temporaire disponible
Pour les données d'identification cibles :
Sélectionnez un domaine.
Sélectionnez un alias dans le domaine spécifié.
Sélectionnez une table de point de reprise. 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 nombre maximal d'unités d'exécution (Réplicats coordonnés uniquement).
Dans la page Options gérées, remplissez les champs facultatifs si nécessaire, puis cliquez sur Suivant :
Sélectionnez un nom de profil, s'il est disponible.
Activer Critique pour l'état du déploiement.
Activer et configurer les paramètres de démarrage automatique.
Dans la page Fichier de paramètre, vous pouvez ajouter des paramètres pour configurer davantage le réplicat. Par exemple :
table source.table1;
Si vous utilisez une 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 l'heure moyenne de Greenwich (GMT). Utilisez SETENV pour remplacer le paramètre par défaut pour ce processus de réplication. Cette modification ne s'applique pas aux déploiements. Par exemple :
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
Dans la page Properties File (Facultatif), vérifiez la propriété :
jvm.bootoptions : Augmentez la valeur -Xmx si vous devez ajouter plus de mémoire à la JVM du processus de réplication (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour 32 Go, etc.).
Note :
Un problème connu lié au programme de traitement de diffusion 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 du processus de réplication :
Pour plus d'informations sur les propriétés de cette cible et pour connaître les différences entre les programmes de traitement d'étape et de fusion et de diffusion en continu, voir Snowflake dans le guide Oracle GoldenGate for Distributed Applications and Analytics.
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 Snowflake dans Oracle GoldenGate 21c :
Dans la console de déploiement GoldenGate d'OCI, dans la page Aperçu du service d'administration, cliquez sur Ajouter une réplication (icône plus).
Dans 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
Dans la page Options de réplication, remplissez les champs suivants, puis cliquez sur Suivant :
Pour Nom du processus, entrez un nom pour le processus de réplication.
Pour Nom de la piste, entrez un nom de piste à deux caractères.
Pour Cible, sélectionnez la connexion Flocage de neige cible dans la liste déroulante.
Pour Alias disponibles, sélectionnez votre alias dans la liste déroulante.
(Facultatif) Activer le stockage externe pour sélectionner un emplacement temporaire disponible dans la liste déroulante.
Dans la page Paramètres de réplication, ajoutez les mappages nécessaires, puis cliquez sur Suivant :
Note :
Si vous utilisez le processus de 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 d'un réplicat coordonné entraînera la création de plusieurs fichiers.
En cas d'omission, vous rencontrerez l'erreur suivante :
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 de longue durée dans Snowflake et qu'un nombre élevé de verrous est observé, assurez-vous qu'aucune autre table ne modifie la même table. En outre, utilisez un réplicat coordonné avec prudence, car cela peut entraîner un nombre élevé de verrous de table.
GoldenGate utilise l'heure moyenne de Greenwich (GMT). Utilisez SETENV pour remplacer le paramètre par défaut du processus de réplication. Cette modification ne s'applique pas aux déploiements. Par exemple :
(Facultatif) Dans la page Properties File, vérifiez les propriétés suivantes :
Note :
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 d'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 : Données d'identification de l'entrepôt de données Snowflake pour accéder aux fichiers de magasin 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 de réplication (-Xmx16g pour utiliser jusqu'à 16 Go de mémoire, -Xmx32g pour un maximum de 32 Go, etc.)
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 Aperçu du service d'administration.
Vous retourz à la page Aperçu du service d'administration, où vous pouvez voir la création du processus et des actions de réplication.
Problèmes connus
Bug 37518857 : Erreur de réplication de flocon de neige OGGDAA GGS
Le gestionnaire de diffusion en continu Snowflake échoue avec : Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"
Solution de rechange : Ajoutez les éléments suivants au fichier des propriétés du processus de réplication :