Problèmes connus dans OCI GoldenGate
Informations générales
Découvrez les problèmes connus généraux qui s'appliquent à l'ensemble du service et comment les contourner.
Après la mise à niveau vers Oracle GoldenGate 23.26.x, l'accès à la console de déploiement peut rencontrer une erreur 502 Bad Gateway ou ne pas répertorier les processus GoldenGate après la connexion
Les déploiements Oracle Cloud Infrastructure GoldenGate 23.26 peuvent devenir en mauvais état après la mise à niveau des libellés précédents vers la version 23.26.x ou après l'exécution d'une opération d'arrêt/de démarrage sur un déploiement 23.26.x.
Solution de contournement : la mise à niveau a eu un impact sur les déploiements Oracle pour étiqueter oggoracle:23.26.1.0.0_260331, afin de résoudre ce problème.
Pour le Big Data et les autres libellés non Oracle, un correctif sera annoncé prochainement. Contactez le support technique pour l'atténuation manuelle provisoire afin d'éviter l'impact.
AdminClient : problème avec la commande de profil d'informations
L'utilisation de la commande info profile dans AdminClient renvoie l'erreur 302.
Solution : utilisez la commande d'API REST suivante :
GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default
Les chemins de distribution et de destinataire peuvent échouer après la mise à niveau des déploiements 21.x vers la version 21.17
A partir des versions 21.17 et 26ai d'Oracle GoldenGate, les chemins utilisent le nom de domaine réservé par défaut, "Réseau", de sorte que les chemins existants qui utilisent un autre nom de domaine échouent avec l'erreur suivante signalée :
ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'
Solution de contournement : dans la console de déploiement OCI GoldenGate, modifiez chaque chemin, remplacez le nom de domaine par "Réseau", puis redémarrez le chemin. Pour vérifier, vérifiez le domaine de l'utilisateur auth du chemin dans la section Credential store de la page Configuration.
Si vous préférez utiliser le client Admin, exécutez les commandes suivantes pour mettre à jour le nom de domaine. Veillez à remplacer les espaces réservés <path_name> et <alias> :
Pour les chemins initiés par la source :
ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
Network
Pour les chemins initiés par la cible :
ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
Network
Problèmes lors de la mise à niveau vers Oracle GoldenGate 21.17 pour Big Data
La mise à niveau des utilisateurs à partir des versions 21.14, 21.15 ou 21.16 d'Oracle GoldenGate pour Big Data vers la version 21.17 avec des propriétés de connexion de truststore et/ou de fichier de clés configurées échoue avec les erreurs suivantes signalées :
Caused by: oracle.goldengate.util.GGException: An exception occurred when creating the Kafka Producer object.
Caused by: org.apache.kafka.common.KafkaException: Failed to construct kafka producer
Caused by: org.apache.kafka.common.KafkaException: Failed to load SSL keystore /u02/connections/<connection OCID>/trustStore of type JKS
Caused by: java.io.IOException: keystore password was incorrect
Solution de contournement :
-
Convertissez le truststore et le keystore JKS en PKCS12.
-
Pour le fichier de clés, il doit demander un mot de passe. Keytool est un utilitaire du kit JDK.
keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12] -
Pour le truststore, il doit demander un mot de passe.
keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
-
-
Dans le fichier de propriétés du fournisseur de portlets Kafka, définissez les éléments suivants :
ssl.truststore.type=PKCS12 ssl.keystore.type=PKCS12
Problèmes lors de la restauration des versions 21.15 ou 23.x vers la version 21.14
Lors de la tentative d'annulation (rollback) d'une version 21.15 ou 23.x vers l'une des versions suivantes :
-
Oracle (21.14.0.0.0_240525)
-
Big Data (21.14.0.0.0_240515),
-
MySQL (21.14.0.0.0_240404)
-
MSSQL (21.14.0.0.0_240404)
Vous pouvez rencontrer l'un des problèmes suivants :
-
Problème de connexions/informations d'identification manquant en raison de la nouvelle fonctionnalité de cryptage de portefeuille introduite à partir de la version 21.15.
Solution : vous devez annuler l'affectation et réaffecter les connexions existantes au déploiement, et recréer les utilisateurs manquants requis pour les chemins de distribution ou de destinataire en cours d'utilisation.
-
Echec du démarrage du gestionnaire de services en raison d'un problème lié au service de mesures de performances lors des annulations de la version 23.x à la version 21.14. Contactez le support technique Oracle si vous rencontrez ce problème.
-
Echec des processus Oracle GoldenGate avec l'erreur "OGG-02431 En-tête d'enregistrement non valide trouvé dans le fichier de point de reprise".
Solution : mettez à niveau le déploiement vers la version 21.14 la plus récente disponible dans la série. Contactez le support technique Oracle si le problème persiste.
Erreur d'URL de redirection non valide lors de la tentative d'accès à un déploiement compatible IAM à l'aide d'une adresse IP
Lorsque vous tentez d'accéder à un déploiement compatible IAM à l'aide de l'adresse IP du déploiement, l'erreur suivante se produit :
{"error":"invalid_redirect_uri","error_description":"Client
xxxxxxxx1ocioraclecloudcom_APPID requested an invalid redirect URL: https://192.x.x.x/services/adminsrvr/v2/authorization. ECID:
xxxx"}
Solution de contournement : vous pouvez effectuer l'une des opérations suivantes :
Option 1 : ajoutez l'adresse IP de déploiement à l'application de domaine d'identité. Pour effectuer cette modification, vous devez faire partie du groupe d'utilisateurs affecté à l'application.
-
Dans le menu de navigation Oracle Cloud, sélectionnez Identité et sécurité, puis sous Identité, sélectionnez Domaines.
-
Sélectionnez votre domaine dans la liste Domaines.
-
Dans le menu des ressources de domaine d'identité du domaine, sélectionnez Services Oracle Cloud.
-
Sélectionnez votre application dans la liste des services Oracle Cloud. Par exemple, Application GGS INFRA pour l'ID de déploiement : <OCID de déploiement>.
-
Sur la page de l'application sous Configuration OAuth, sélectionnez Modifier la configuration OAuth.
-
Pour URL de réacheminement, entrez l'URL de console du déploiement avec l'adresse IP du déploiement à la place du domaine. Par exemple :
https://<deployment-ip>/services/adminsrvr/v2/authorization. -
Enregistrez les modifications.
Option 2 : ajoutez une entrée dans le fichier d'hôtes client pour mettre en correspondance 127.0.0.1 avec le nom de domaine qualifié complet de déploiement (remplacez <region> par la région appropriée). Exemple :
127.0.0.1 xx.deployment.goldengate.<region>.oci.oraclecloud.com
Impossible de mettre à jour les certificats personnalisés sur les déploiements IAM
Le service interdit les mises à jour du nom de domaine qualifié complet car il a une incidence sur l'accès inter-région et nécessite des mises à jour des ressources IAM dans la région cible.
Solution de contournement : pour contourner ce problème, créez un déploiement pour utiliser le nom de domaine qualifié complet mis à jour.
Les API REST Oracle GoldenGate renvoient 302 réacheminements vers une page d'index
Vous pouvez utiliser les API REST GoldenGate GoldenGate pour gérer vos déploiements OCI GoldenGate. Pour les personnes familières avec Oracle GoldenGate, notez que le gestionnaire de services n'est pas exposé dans OCI GoldenGate et que les appels effectués vers le gestionnaire de services ne pourront pas être renvoyés.
AdminClient : Impossible de négocier : aucun type de clé hôte correspondant n'a été trouvé
Lorsque vous utilisez AdminClient dans Cloud Shell pour vous connecter à votre déploiement, le message suivant peut s'afficher :
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Action completed. Waiting until the work request has entered state: ('SUCCEEDED',)
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Cannot create ssh tunnelnel
Solution de contournement : procédez comme suit :
-
Ouvrez une nouvelle session Cloud Shell.
-
Créez un fichier à l'aide de la commande suivante :
cat .ssh/config -
Entrez les informations suivantes dans le fichier
.ssh/config, puis enregistrez-le :HostkeyAlgorithms ssh-rsa,ssh-ed25519 PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa -
S'il existe un fichier
.ssh/known_hosts, supprimez-le. -
Fermez la session Cloud Shell.
-
Sélectionnez Lancer le client d'administration sur la page de détails du déploiement.
Connexions
Découvrez les problèmes connus liés aux connexions et comment les contourner.
Plate-forme de données Oracle AI : authentification du principal de ressource
L'authentification du principal de ressource pour les connexions Oracle AI Data Platform rencontre l'erreur suivante :
JDBCMDP-00034 Current attempt to connect failed with error: [[JDBC Driver]Could not find private key: /tmp/ogg/ocid1.goldengateconnection.oc1.phx.amaa...lqabqqxq/privateKeyFile].
Solution de contournement : modifiez la connexion et sélectionnez une autre méthode d'authentification, telle que Utiliser la location et l'utilisateur en cours ou Indiquer une autre location et un autre utilisateur.
Erreurs rencontrées lors de l'utilisation de connexions avec des clés secrètes
Des erreurs de connectivité peuvent se produire lors de l'utilisation de connexions avec des clés secrètes et des coffres dans les versions suivantes d'OCI GoldenGate :
-
oggbigdata :23.8.0.0.0_250428.1314_1246
-
oggbigdata :23.8.0.0.0_250523.1247_1247
-
oggbigdata :23.8.0.0.0_250523.1247_1253
-
oggbigdata :21.18.0.0.0_250416.1417_1253
-
oggmysql :23.8.0.0.0_250412.2241_1246
-
oggmysql :23.8.0.0.0_250412.2241_1237
-
oggmysql :23.8.0.0.0_250412.2241_12211
-
oggpostgresql :23.8.0.0.0_250517.1921_1248
-
oggpostgresql :23.8.0.0.0_250412.2241_1246
-
oggpostgresql :23.8.0.0.0_250412.2241_1237
-
oggdb2zos :23.8.0.0.0_250412.2241_1253
-
oggdb2zos :23.8.0.0.0_250412.2241_1246
-
oggdb2i :23.8.0.0.0_250524.0756_1253
-
oggdb2i :23.8.0.0.0_250524.0756_1246
Solution de contournement : recréez votre connexion sans utiliser les clés secrètes OCI Vault :
-
Sur la page Créer une connexion, développez Options avancées en bas de la page.
-
Sous Options avancées, développez Paramètres.
-
Désélectionnez Utiliser les clés secrètes dans le coffre.
-
Choisissez Créer.
Sinon, si les options avancées ne sont pas disponibles dans votre connexion, essayez d'utiliser une version antérieure du déploiement.
Erreur de réplication Oracle Object Storage lors de l'utilisation du principal de ressource
Si votre connexion Oracle Object Storage utilise l'authentification du principal de ressource, le processus Replicat échoue avec 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
Solution de contournement : pour contourner ce problème, modifiez la connexion, puis sélectionnez une autre méthode d'authentification.
Problème avec les connexions Apache Iceberg dans OCI GoldenGate
Si vous rencontrez l'erreur suivante lors de l'utilisation des connexions Apache Iceberg, ouvrez un ticket d'assistance, partagez les détails et le message d'erreur :
ERROR 2025-07-08 13:34:09.000481 [main] - Parameter [awsSecretKey] is missing in the
connection payload. Parameter [awsSecretKey] is missing in the connection payload.
Erreurs Java.net.UnknownHostException pour les connexions Amazon S3 et Google Cloud Storage
Les connexions Amazon S3 et Google Cloud Storage avec des adresses partagées rencontrent des erreurs Java.net.UnknownHostException.
Solution : modifiez la connexion et remplacez la méthode de routage du trafic par Dédié, ou sélectionnez Dédié lorsque vous créez des connexions Amazon S3 et Google Cloud Storage.
Problème avec les connexions Amazon S3 dans OCI GoldenGate
Si vous rencontrez l'erreur suivante lors de l'utilisation de connexions Amazon S3, ouvrez un ticket d'assistance, partagez les détails et le message d'erreur.
ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
[ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com
Solution de contournement :
-
Connexion à Cloud Shell.
-
Créez une connexion Amazon S3 à l'aide de l'exemple de CLI suivant :
oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret> --connection-region <amazon_s3_bucket_region> -
Affectez la connexion à votre déploiement.
-
Ajout et exécution d'une réplication pour Amazon S3.
Sinon, si vous préférez ne pas utiliser l'accès public, configurez les buckets de votre connexion Amazon S3 pour utiliser les adresses AWS VPC. Pour qu'OCI GoldenGate puisse accéder à votre bucket S3 à l'aide d'adresses VPC, vous devez également configurer un VPN IPsec entre votre VCN et le VPC AWS.
Afin de définir l'adresse pour Amazon S3, ajoutez la propriété gg.eventhandler.s3.url au fichier de propriétés de réplication et indiquez l'adresse de la connexion privée.
Problème avec la connexion de test MongoDB
Une erreur peut se produire lors de l'utilisation de la connexion de test avec les connexions MongoDB. Vous pouvez ignorer cette erreur et tester les connexions MongoDB dans la console de déploiement OCI GoldenGate. Dans la console de déploiement, ouvrez le menu de navigation du service d'administration, puis sélectionnez Configuration. La connexion MongoDB doit être répertoriée en tant qu'informations d'identification, dans laquelle vous pouvez sélectionner **Se connecter à
Action requise pour les connexions à la base de données Autonomous AI qui utilisent l'authentification mTLS
Lorsqu'un portefeuille de base de données Autonomous AI fait l'objet d'une rotation, la connexion OCI GoldenGate à cette base de données doit être actualisée pour extraire les dernières informations sur le portefeuille.
Pour plus d'informations, reportez-vous au document My Oracle Support (MOS) Document 2911553.1.
Procédure d'actualisation d'une connexion à une base de données d'IA autonome : modifiez et enregistrez la connexion à la base de données d'IA autonome (traitement des transactions d'IA autonome ou lakehouse d'IA autonome). L'enregistrement de la connexion télécharge et actualise automatiquement le portefeuille. Aucune autre modification de la connexion n'est nécessaire.
Pour vérifier, procédez comme suit :
-
Lancez la console de déploiement pour un déploiement qui utilise la connexion à la base de données Autonomous AI.
-
Dans la console de déploiement, ouvrez le menu de navigation, puis sélectionnez Configuration.
-
Sur l'écran Informations d'identification, observez la chaîne de connexion à la base de données Autonomous AI.
Avant l'actualisation du portefeuille, la chaîne de connexion se présente comme suit :
ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))Une fois le portefeuille actualisé, la chaîne de connexion est mise à jour comme suit :
ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_dn_match=yes)))
Bases de données MySQL n'apparaissant pas dans la liste Alias d'informations d'identification
Les noms d'utilisateur de base de données MySQL qui incluent un symbole "@" n'apparaissent pas dans La liste Alias d'informations d'identification lors de La création D'une Extraction Dans La Console De Déploiement OCI GoldenGate.
Solution de contournement : sélectionnez un alias différent dans la liste, puis mettez à jour manuellement le fichier de paramètre sur l'écran suivant.
Les délais d'expiration du réseau ont une incidence sur les connexions à la base de données utilisant des adresse privées
Si vous utilisez une extrémité privée pour la connexion à une base, vous risquez de rencontrer des expirations de réseau lors du démarrage ou de l'arrêt des processus d'extraction.
Solution de contournement : vous pouvez effectuer l'une des opérations suivantes :
-
Appliquez les derniers patches à partir de la page des détails du déploiement. Dans la section Informations sur le déploiement, sous GoldenGate, pour Version, sélectionnez Mettre à niveau.
-
Si vous ne pouvez pas appliquer les derniers patches pour le moment, vous pouvez mettre à jour la chaîne de connexion afin qu'elle inclue
EXPIRE_TIME=1. Par défaut, vous disposez peut-être d'une chaîne de connexion EZ dans Oracle GoldenGate. Cette chaîne de connexion doit être mise à jour vers une chaîne de connexion longue dans les informations d'identification Oracle GoldenGate, comme suit :<username>@//<hostname>:1521/<service_name> <username> @(DESCRIPTION = (EXPIRE_TIME=1)(ADDRESS_LIST = (ADDRESS = (COMMUNITY = tcp)(PROTOCOL = TCP)(Host = <hostname>)(Port = 1521))) (CONNECT_DATA = (SERVICE_NAME = <service_name>)))
Le mandataire SCAN ne prend pas en charge TLS
Bien qu'OCI GoldenGate prenne en charge les hôtes et les adresses IP SCAN (Oracle Single Client Access Name), le proxy SCAN ne prend pas en charge TLS.
Solution de contournement : vous pouvez vous connecter à une base de Données RAC à l'aide de l'adresse IP du noeud de base de Données.
Non-concordance d'OCID utilisateur dans la connexion à Oracle Object Storage (utilisateurs fédérés uniquement)
Si un utilitaire fédéré sélectionne Utiliser l'utilisateur en cours lors de la création d'une connexion à Oracle Object Storage, son OCID ne correspond pas à l'OCID récupéré par le système.
Solution : lorsque vous créez une connexion à Oracle Object Storage, veillez à choisir Indiquer un autre utilisateur, puis entrez l'OCID de l'utilisateur fédéré.
Pour rechercher l'OCID utilisateur, sélectionnez 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, sélectionnez Afficher pour l'OCID.
Console de déploiement
Découvrez les problèmes connus liés à la console de déploiement OCI GoldenGate.
Echec du chargement de la console de déploiement
Si vous entrez un nom de domaine qualifié complet dont la dernière partie est supérieure à 11 caractères, le chargement de la console de déploiement échoue.
Solution de contournement : conservez la dernière partie de votre nom de domaine qualifié complet sous 11 caractères.
La console de déploiement OCI GoldenGate n'est pas compatible avec les navigateurs Web Safari
La console de déploiement Oracle Cloud Infrastructure GoldenGate ne s'affiche pas correctement lorsque vous y accédez à l'aide d'un navigateur Web Safari.
Solution de contournement : utilisez plutôt le navigateur Chrome ou FireFox.
La connexion à des informations d'identification peut prendre plusieurs minutes
Sur l'écran Configuration de la console de déploiement, lorsque vous tentez de vous connecter à des informations d'identification, la connexion peut prendre plusieurs minutes. L'actualisation de l'écran allonge le processus de connexion uniquement.
Solution : il s'agit d'un problème connu qui est résolu dans la version du build GoldenGate oggoracle :21.8.0.0.0_221119.1258_663.
Processus GoldenGate
Découvrez les problèmes connus liés aux processus GoldenGate et comment les contourner.
Protocole de sécurité TLS MongoDB, DocumentDB et Oracle JSON Collection
Si la connexion au processus Replicat MongoDB, au processus Replicat DocumentDB ou à la collecte JSON Oracle échoue avec l'erreur suivante dans le fichier de rapport :
Error: Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
Solution de contournement : ajoutez la propriété suivante au fichier de propriétés, mettez à jour <connection_ocid> avec l'OCID de connexion et conservez le reste tel quel.
jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123
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
La console de déploiement OCI GoldenGate ne peut pas afficher un fichier de suppression nommé personnalisé/non par défaut
Par défaut, les fichiers ignorés respectent la convention de dénomination <process-name>.dsc. Vous pouvez voir tous les fichiers ignorés dans la console de déploiement OCI GoldenGate, sauf si vous les avez renommés. La console de déploiement n'affiche pas les fichiers de rebut nommés personnalisés.
Solution de contournement : utilisez l'outil Collecter les diagnostics sur la page de détails du déploiement pour accéder aux fichiers de rebut.
Echec des réplications lors de l'utilisation du fichier trace de l'extraction MongoDB avec BINARY_JSON_FORMAT
Lorsqu'une réplication utilise un fichier trace généré à partir d'une extraction MongoDB avec BINARY_JSON_FORMAT dans le fichier de paramètres d'extraction, la réplication échoue avec l'erreur suivante :
ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
java.nio.charset.MalformedInputException: Input length = 1 at
java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
[ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread "main"
oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)
Solution de contournement : lorsque BINARY_JSON_FORMAT est enlevé des paramètres d'extraction, le processus Replicat s'exécute correctement et les documents sont représentés au format JSON étendu.
Echec des extractions de capture de données de modification à distance pour les bases de données compatibles GTID
Lorsque vous créez un processus d'extraction de capture de données de modification avec l'option Distant activée pour une base de données MySQL qui utilise des identificateurs de transaction globaux (GTID), le processus d'extraction échoue et l'erreur suivante est signalée :
ERROR OGG-25192 Trail file '<trail name>' is remote. Only local trail allowed for this extract.
Solution de contournement : sur l'écran Fichier de fichiers de paramètres de l'extraction de capture de données de modification, enlevez la ligne TRANLOGOPTIONS ALTLOGDEST REMOTE.
Pour plus d'informations, reportez-vous à Utilisation d'Oracle GoldenGate pour MySQL.
Chemins de distribution : ajoutez le certificat racine à la gestion des certificats ou au portefeuille client.
Pour envoyer des données à OCI GoldenGate ou en extraire des données, vous devez créer un chemin de serveur de distribution ou un chemin lancé à partir de la cible sur le serveur de destinataire dans votre instance Oracle GoldenGate sur site ou Marketplace, respectivement. Vous devez également ajouter le certificat racine OCI GoldenGate ou le certificat auto-signé à la gestion des certificats Oracle GoldenGate (Oracle GoldenGate 21c ou version ultérieure) ou au portefeuille client (Oracle GoldenGate 19c). Cette opération crée une connexion sécurisée entre les déploiements Oracle GoldenGate et OCI GoldenGate. Seul le protocole WSS (WebSocket Secure) est pris en charge pour les chemins de serveur de distribution et de destinataire entre Oracle GoldenGate et OCI GoldenGate.
Une modification du certificat racine OCI GoldenGate entraîne l'échec du chemin du serveur de distribution ou d'un chemin lancé à partir de la cible sur le serveur de destinataire dans votre instance Oracle GoldenGate sur site ou Marketplace, et génère l'erreur suivante :
ERROR OGG-10390 Oracle GoldenGate Receiver Service: Generic error -1 noticed for endpoint
wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
connection unexpectedly closed.
Solution de contournement : pour résoudre ce problème, mettez à jour le certificat dans le portefeuille client ou dans l'écran Gestion des certificats du Gestionnaire de services afin d'utiliser le certificat racine de la console de déploiement OCI GoldenGate. Dans certains cas, lorsque le certificat du déploiement OCI GoldenGate n'est pas signé directement par le certificat racine, mais par un ou plusieurs certificats intermédiaires par exemple, il peut être nécessaire d'ajouter également le ou les certificats CA intermédiaires.
En savoir plus :
-
Pour l'utilisateur Oracle GoldenGate 19c, reportez-vous à Création d'un certificat d'utilisateur de chemin de serveur de distribution.
-
Pour les utilisateurs d'Oracle GoldenGate 21c ou une version supérieure, reportez-vous àCréation d'une connexion sécurisée entre Oracle GoldenGate et OCI GoldenGate.
Seule l'authentification Digest est actuellement prise en charge.
Oracle Cloud Infrastructure GoldenGate ne prend actuellement pas en charge l'authentification basée sur un certificat lorsque vous utilisez Oracle Cloud Infrastructure GoldenGate comme cible de chemin de distribution.
Solution de contournement : aucun.
GoldenGate @ Oracle AI Database@Azure
Ancrage de ressource en attente ou en échec
Vérifiez que votre compte Azure dispose du rôle Contributeur sur le groupe de ressources cible et que le fournisseur de ressources Oracle AI Database@Azure est inscrit sous Azure, Abonnements, puis Fournisseurs de ressources.
Echec de l'ancrage réseau avec erreur de délégation de sous-réseau
Vous devez déléguer le sous-réseau à Oracle AI Database@Azure avant de créer l'ancre réseau. Dans le portail Azure, sélectionnez Réseaux virtuels, Sous-réseaux, puis Délégation et vérifiez que la délégation correcte est définie.
Compartiment OCI non visible après la création de l'ancre de ressource
Patientez jusqu'à cinq minutes pour la propagation. Si elle ne s'affiche toujours pas, vérifiez que l'ancre de ressource affiche Actif sur le portail Azure. S'il affiche Echec, supprimez-le et recréez-le.
groupe odbaa-goldengate-administrators inexistant
Votre location a probablement été provisionnée avant le 7 octobre 2025. Exécutez le script d'automatisation Cloud Shell à l'étape 3 pour créer le groupe et les stratégies en une seule étape.
Problèmes courants rencontrés lors de la création du déploiement
Si le groupe dynamique goldengate-deployments n'est pas appliqué correctement, vous rencontrez probablement un ou plusieurs des problèmes suivants lors de la création du déploiement :
-
La valeur de la zone de disponibilité Azure ne correspond pas à l'ancre réseau (non-concordance de zone - la plus courante)
-
Le quota de service pour Vault, clé, clé secrète ou équilibreur de charge a été atteint dans la région cible
-
La clé secrète ou la clé de cryptage du coffre se trouve dans un autre compartiment sans stratégie inter-compartiments
Déploiement bloqué par une erreur d'autorisation
Vérifiez que le groupe dynamique goldengate-deployments existe. Dans le menu de navigation Oracle Cloud, sélectionnez Identité et sécurité, Groupes dynamiques, puis vérifiez que la règle de correspondance correspondante est correcte. Vérifiez que les stratégies octroyant au groupe l'accès permettant de gérer la famille de clés secrètes, les coffres et les clés sont ciblées sur le compartiment approprié.
Déploiement bloqué dans l'état de création ou échec
Sur la page de détails du déploiement, accédez à l'onglet Demandes de travail et recherchez les erreurs dans les messages. Les causes courantes sont les suivantes :
-
Non-concordance de zone — la zone de disponibilité logique ne correspond pas à l'ancre réseau. Recréez l'ancre réseau avec la zone correcte, puis recréez le déploiement.
-
Quota d'équilibreur de charge atteint : utilisez la barre de recherche OCI pour rechercher les limites, les quotas et l'utilisation, puis filtrez par ORACLEDBATAZURE et demandez une augmentation si nécessaire.
-
Clé secrète ou clé de coffre inaccessible : vérifiez que la clé secrète et la clé se trouvent dans le même compartiment que le déploiement, ou que des stratégies inter-compartiments existent.
Déploiement non visible sur le portail Azure
Un abonnement autre que ORACLEDBATAZURE a été sélectionné lors de la création. Supprimez le déploiement et recréez-le avec l'abonnement approprié.
Mot de passe en texte brut rejeté
Ce mot de passe doit contenir au moins 8 caractères, et inclure une majuscule, une minuscule, un chiffre et un caractère spécial. Il ne doit pas contenir le nom d'utilisateur.
Clé secrète de coffre inaccessible
Vérifiez que l'état de la clé secrète est Actif. Dans le menu de navigation Oracle Cloud, sélectionnez Identity & Security, puis Secret Management. Les clés secrètes en attente de suppression ne peuvent pas être utilisées.
Connexion impossible d'accéder à la base de données
Vérifiez que le port de base de données requis est ouvert à la fois dans le groupe de sécurité réseau Azure et dans la liste de sécurité OCI sur le sous-réseau mis en correspondance avec une ancre réseau. Si vous utilisez un nom d'hôte, vérifiez que la résolution DNS est configurée conformément à la documentation relative à la résolution DNS pour les ancres réseau, liée à la tâche 1, étape 2.
Transformations de données
Le déploiement de Data Transforms ne sauvegarde pas les connexions génériques
Les connexions génériques affectées aux déploiements Data Transforms ne sont pas incluses dans le processus de sauvegarde.
Le déploiement des transformations de données restaurées supprime les jeux de données delta
Les jeux de données de transformation de données créés pendant et après la restauration d'un déploiement de transformation de données seront perdus.
Pipelines
Explorez les problèmes connus liés aux pipelines et la façon de les contourner.
Les connexions à la base de données Autonomous AI avec Autonomous Data Guard activé ne sont pas prises en charge actuellement
Les connexions à la base de données Autonomous AI sur lesquelles Autonomous Data Guard est activé ne sont actuellement pas prises en charge dans OCI GoldenGate Pipelines.
Solution : désactivez Autonomous Data Guard (ADG) ou utilisez une autre base de données Autonomous AI. Actualisez la connexion si vous avez désactivé ADG pour mettre à jour la chaîne de connexion utilisée par OCI GoldenGate.
Echec d'Oracle Data Pump si la version du fichier de fuseau horaire de la base de données cible est inférieure à celle de la base de données source
L'option de pipeline "Copier les données existantes vers la base de données cible avant de démarrer la réplication" utilise Oracle Data Pump. Oracle Data Pump échoue si la version du fichier de fuseau horaire de la base de données cible est inférieure à celle de la base de données source.
Solution : pour contourner ce problème, vous devez mettre à niveau la version du fuseau horaire de la base de données cible. Reportez-vous à Gestion des mises à jour de fichier de fuseau horaire sur Autonomous AI Database.