Problemi noti relativi ai processi GoldenGate

Esplora i problemi noti relativi ai processi GoldenGate e come risolverli.

Acquisizione GoldenGate per il cluster MySQL InnoDB

Si è verificato un problema noto che può arrestare l'acquisizione di Oracle GoldenGate durante l'acquisizione da un cluster MySQL InnoDB.

GoldenGate attualmente supporta i GTID standard, ma non i GTID contrassegnati. MySQL Shell 9.5 e versioni successive aggiunge automaticamente un tag mysqlsh a determinate transazioni amministrative quando viene utilizzato con MySQL Server 8.3 o versioni successive. Se GoldenGate rileva queste transazioni contrassegnate, l'estrazione basata su GTID può non riuscire.

Ciò ha effetto sull'acquisizione basata su GTID per il cluster MySQL InnoDB. L'acquisizione MySQL standalone con numero di log e offset non è interessata.

Come evitare questo problema

Intraprendere un'azione prima di eseguire l'upgrade del cluster: utilizzare la shell MySQL 9.4 o versioni precedenti per l'upgrade del cluster. Non utilizzare la shell MySQL 9.5 o versioni successive per le operazioni cluster durante l'utilizzo di Extract basato su GTID GoldenGate.

La scelta della versione della shell dopo l'avvio dell'aggiornamento è troppo tardi. Se MySQL Shell 9.5 o versioni successive aggiunge GTID contrassegnati, Extract potrebbe non riuscire; il recupero richiede una risincronizzazione completa.

Soluzione alternativa

È possibile eseguire l'upgrade di MySQL Server alla versione 8.3 o successiva, ma utilizzare la shell MySQL 9.4 o versioni precedenti per installare, configurare o aggiornare il cluster InnoDB. Eseguire questa operazione prima di configurare l'estrazione GoldenGate.

La revoca del privilegio TRANSACTION_GTID_TAG non è una soluzione alternativa valida e può causare la mancata riuscita delle operazioni della shell MySQL, ad esempio l'aggiunta o la rimozione di un'istanza.

Nota di sicurezza: MySQL Shell 9.4 contiene vulnerabilità risolte nelle release successive. Esaminare le implicazioni relative alla sicurezza con il team di sicurezza prima di utilizzare questa soluzione temporanea.

Replica di Apache Iceberg con AWS Glue Data Catalog e bucket Amazon S3

Nelle repliche di Apache Iceberg che utilizzano AWS Glue Data Catalog e i bucket S3 AWS, è possibile che si verifichi il seguente errore:

Cannot find constructor for interface org.apache.iceberg.catalog.Catalog
	Missing org.apache.iceberg.aws.glue.GlueCatalog [java.lang.NoClassDefFoundError: software/amazon/awssdk/services/glue/model/AlreadyExistsException]

Soluzione: aggiornare gg.classpath come indicato di seguito.

gg.classpath=$THIRD_PARTY_DIR/iceberg/*:$THIRD_PARTY_DIR/s3/*:$THIRD_PARTY_DIR/hadoop/*::$THIRD_PARTY_DIR/s3/*:$THIRD_PARTY_DIR/glue/*

Problema relativo al protocollo di sicurezza TLS

MongoDB, DocumentDB e Oracle JSON Collection TLS Security Protocol

Se la connessione Replicat MongoDB, Replicat DocumentDB o Raccolta Oracle JSON non riesce con il seguente errore nel file di report:

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

Soluzione: aggiungere la proprietà seguente al file Properties, aggiornare <connection_ocid> con l'OCID della connessione e mantenere il resto invariato.

jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123

Bug 37518857: errore OGGDAA GGS Snowflake Streaming Replicat

Snowflake Streaming Handler fallisce con: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Soluzione: aggiungere quanto segue al file Replicat Properties:

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

La console di distribuzione OCI GoldenGate non può visualizzare il file di scarto denominato personalizzato o non predefinito

Per impostazione predefinita, ignorare i file seguendo la convenzione di denominazione <process-name>.dsc. È possibile visualizzare tutti i file di scarto nella console di distribuzione OCI GoldenGate, a meno che non siano stati rinominati. La console di distribuzione non visualizza i file di scarto denominati personalizzati.

Soluzione: utilizzare lo strumento di diagnostica Raccogli nella pagina dei dettagli della distribuzione per accedere ai file eliminati.

Le repliche non riescono quando si utilizza il file trail da MongoDB Extract con BINARY_JSON_FORMAT

Quando un Replicat utilizza un file trail generato da un'estrazione MongoDB con BINARY_JSON_FORMAT nel file dei parametri Extract, il Replicat non riesce con il seguente errore:

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)

Soluzione: quando si rimuove BINARY_JSON_FORMAT dai parametri Extract, l'esecuzione di Replicat riesce e i documenti vengono rappresentati in formato JSON esteso.

Estrazioni non riuscite per i database abilitati per GTID

Quando si crea un processo Modifica estrazione acquisizione dati con l'opzione Remoto abilitata per un database MySQL che utilizza gli identificativi transazione globali (GTID), il processo di estrazione non riesce e viene segnalato il seguente errore:

ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

Soluzione: nella schermata File dei parametri di Estrazione acquisizione dati modifica, rimuovere la riga TRANLOGOPTIONS ALTLOGDEST REMOTE.

Per ulteriori informazioni, vedere Uso di Oracle GoldenGate per MySQL.

Percorsi di distribuzione: aggiungere il certificato radice a Gestione certificati o al wallet client

Per inviare dati a o estrarre dati da OCI GoldenGate, è necessario creare un percorso del server di distribuzione o un percorso avviato dalla destinazione sul server di ricezione rispettivamente in locale o Marketplace Oracle GoldenGate. È inoltre necessario aggiungere il certificato radice GoldenGate OCI o il certificato autofirmato a Oracle GoldenGate Certificate Management (Oracle GoldenGate 21c o versioni successive) o al wallet client (Oracle GoldenGate 19c). In questo modo viene creata una connessione sicura tra le distribuzioni Oracle GoldenGate e OCI GoldenGate. Solo il protocollo WSS (WebSocket Secure) è supportato per i percorsi server di distribuzione e ricezione tra Oracle GoldenGate e OCI GoldenGate.

Una modifica del certificato radice GoldenGate OCI causerà l'errore del percorso del server di distribuzione o di un percorso avviato dalla destinazione sul server di ricezione in locale o Oracle GoldenGate Marketplace e produrrà l'errore seguente:

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.

Soluzione: per risolvere il problema, aggiornare il certificato nel wallet client o nella schermata Gestione certificati di Service Manager per utilizzare il certificato root di OCI GoldenGate Deployment Console. In alcuni casi, quando il certificato della distribuzione OCI GoldenGate non è firmato direttamente dal certificato radice, ma da uno o più certificati intermedi, ad esempio, potrebbe essere necessario aggiungere anche i certificati CA intermedi.

Ulteriori informazioni:

Al momento è supportata solo l'autenticazione digest

Oracle Cloud Infrastructure GoldenGate attualmente non supporta l'autenticazione basata su certificati quando si utilizza Oracle Cloud Infrastructure GoldenGate come destinazione del percorso di distribuzione.

Soluzione: nessuna.