Problemi noti con le connessioni GoldenGate OCI

Esplora i problemi noti relativi alle connessioni e come lavorare su di esse.

Oracle AI Data Platform: autenticazione principal risorsa

L'autenticazione del principal risorsa per le connessioni a Oracle AI Data Platform ha rilevato il seguente errore:

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

Soluzione: modificare la connessione e selezionare un metodo di autenticazione diverso, ad esempio Usa tenancy e utente correnti o Specifica un'altra tenancy e un altro utente.

Errori rilevati durante l'utilizzo delle connessioni con segreti

È possibile che si verifichino errori di connettività quando si utilizzano connessioni con segreti e vault nelle seguenti versioni di OCI GoldenGate:

Soluzione: ricreare la connessione senza utilizzare i segreti di OCI Vault:

  1. Nella pagina Crea connessione espandere Opzioni avanzate nella parte inferiore della pagina.

  2. In Opzioni avanzate espandere Impostazioni.

  3. Deselezionare Usa segreti nel vault.

  4. Selezionare Crea.

Oppure, se le opzioni avanzate non sono disponibili nella connessione, provare a utilizzare una versione precedente della distribuzione.

Errore di replica dello storage degli oggetti Oracle quando si utilizza il principal risorsa

Se la connessione allo storage degli oggetti Oracle utilizza l'autenticazione principal risorsa, Replicat non riesce con il seguente errore:

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

Soluzione: per risolvere questo problema, modificare la connessione, quindi selezionare un metodo di autenticazione diverso.

Errore di autenticazione della connessione Apache Iceberg al servizio Data Catalog AI

Le connessioni Apache Iceberg al servizio AI Data Catalog scadono a causa di un errore di autenticazione causato dalla scadenza del token. In caso di problemi, contattare il Supporto Oracle.

Errore Apache Iceberg NoSuchFileException

Se si verifica il seguente errore durante l'utilizzo delle connessioni Apache Iceberg, aprire un ticket di supporto, condividere i dettagli e il messaggio di errore:

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

Errori Java.net.UnknownHostException per le connessioni Amazon S3 e Google Cloud Storage

Le connessioni Amazon S3 e Google Cloud Storage con endpoint condivisi rilevano errori Java.net.UnknownHostException.

Soluzione: modificare la connessione e modificare il metodo di instradamento del traffico in Dedicato oppure selezionare Dedicato quando si creano connessioni Amazon S3 e Google Cloud Storage.

Problema con le connessioni Amazon S3 in OCI GoldenGate

Se si verifica il seguente errore durante l'utilizzo delle connessioni Amazon S3, aprire un ticket di supporto, condividere i dettagli e il messaggio di errore.

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

Soluzione alternativa:

  1. Connettersi a Cloud Shell.

  2. Creare una nuova connessione Amazon S3 utilizzando il seguente esempio CLI:

    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. Assegnare la connessione alla distribuzione.

  4. Aggiungi ed esegui Replicat per Amazon S3.

In alternativa, se preferisci non utilizzare l'accesso pubblico, configura i bucket della tua connessione Amazon S3 per utilizzare gli endpoint AWS VPC. Affinché OCI GoldenGate possa accedere al bucket S3 utilizzando gli endpoint VPC, devi anche configurare una VPN IPsec tra la tua VCN e AWS VPC.

Per impostare l'endpoint per Amazon S3, aggiungere la proprietà gg.eventhandler.s3.url al file delle proprietà Replicat e fornire l'endpoint per la connessione privata.

MongoDB Test del problema di connessione

È possibile che si verifichi un errore durante l'utilizzo della connessione Test con le connessioni MongoDB. È possibile ignorare questo errore ed eseguire il test delle connessioni MongoDB nella console di distribuzione OCI GoldenGate. Nella console di distribuzione aprire il menu di navigazione per il servizio di amministrazione e selezionare Configurazione. La connessione MongoDB deve essere elencata come credenziale, in cui è possibile selezionare **Connetti a ** per eseguire il test della connessione.

Azione richiesta per le connessioni ad Autonomous AI Database che utilizzano l'autenticazione mTLS

Quando viene ruotato un wallet di Autonomous AI Database, la connessione GoldenGate OCI a questo database deve essere aggiornata per recuperare le informazioni del wallet più recenti.

Per ulteriori informazioni, consultare il documento My Oracle Support (MOS) 2911553.1.

Per aggiornare una connessione ad Autonomous AI Database: modificare e salvare la connessione ad Autonomous AI Database (Autonomous AI Transaction Processing o Autonomous AI Lakehouse). Il salvataggio della connessione consente di scaricare e aggiornare automaticamente il wallet. Non sono necessarie altre modifiche alla connessione.

Per verificare:

  1. Avviare la console di distribuzione per una distribuzione che utilizza la connessione Autonomous AI Database.

  2. Nella console di distribuzione aprire il menu di navigazione, quindi selezionare Configurazione.

  3. Nella schermata Credenziali osservare la stringa di connessione di Autonomous AI Database.

    Prima dell'aggiornamento del wallet, la stringa di connessione è simile alla seguente:

    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")))

    Dopo l'aggiornamento del wallet, la stringa di connessione viene aggiornata in modo che abbia l'aspetto seguente:

    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)))

I database MySQL non vengono visualizzati nella lista di alias delle credenziali

I nomi utente del database MySQL che includono un simbolo '@' non vengono visualizzati nella lista Alias credenziali durante la creazione di un'estrazione nella console di distribuzione OCI GoldenGate.

Soluzione: selezionare un alias diverso dall'elenco, quindi aggiornare manualmente il file dei parametri nella schermata successiva.

I timeout di rete influiscono sulle connessioni al database utilizzando endpoint privati

Se si utilizza un endpoint privato per connettersi a un database, è possibile che si verifichino timeout di rete durante l'avvio o l'arresto dei processi Extract.

Soluzione: è possibile effettuare una delle operazioni seguenti:

Il proxy SCAN non supporta TLS

Sebbene OCI GoldenGate supporti host e IP SCAN (Oracle Single Client Access Name), il proxy SCAN non supporta TLS.

Soluzione: è possibile connettersi a un database RAC utilizzando l'IP del nodo del database.

Mancata corrispondenza OCID utente nella connessione allo storage degli oggetti Oracle (solo utenti federati)

Se un utente federato seleziona Utilizza l'utente corrente durante la creazione di una connessione allo storage degli oggetti Oracle, il relativo OCID non corrisponde all'OCID selezionato dal sistema.

Soluzione: quando si crea una connessione allo storage degli oggetti Oracle, assicurarsi di scegliere Specificare un altro utente, quindi immettere l'OCID dell'utente federato.

Per trovare l'OCID utente, selezionare Profilo nell'intestazione globale della console di Oracle Cloud, quindi selezionare il nome utente. Nella pagina Dettagli utente, in Informazioni utente, selezionare Mostra per OCID.