Problèmes connus avec les connexions OCI GoldenGate

Découvrez les problèmes connus liés aux connexions et comment les contourner.

Oracle AI Data Platform : 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 :

Solution de contournement : recréez votre connexion sans utiliser les clés secrètes OCI Vault :

  1. Sur la page Créer une connexion, développez Options avancées en bas de la page.

  2. Sous Options avancées, développez Paramètres.

  3. Désélectionnez Utiliser les clés secrètes dans le coffre.

  4. 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.

Erreur d'authentification de la connexion Apache Iceberg au service AI Data Catalog

Les connexions Apache Iceberg au service AI Data Catalog expirent en raison d'une erreur d'authentification due à l'expiration du jeton. Si ce problème survient, contactez le support technique Oracle.

Erreur Apache Iceberg NoSuchFileException

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 :

Caused by: java.nio.file.NoSuchFileException: /tmp/ogg/ocid1.goldengateconnection.oc1...../restCatalogProperties

Java.net.UnknownHostException erreurs 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 :

  1. Connexion à Cloud Shell.

  2. 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>

  3. Affectez la connexion à votre déploiement.

  4. 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.

MongoDB Tester le problème de connexion

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 à ** pour tester la connexion.

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 :

  1. Lancez la console de déploiement pour un déploiement qui utilise la connexion à la base de données Autonomous AI.

  2. Dans la console de déploiement, ouvrez le menu de navigation, puis sélectionnez Configuration.

  3. 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 :

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.