Problemas conhecidos relacionados aos processos GoldenGate

Explore problemas conhecidos relacionados aos processos do GoldenGate e como contorná-los.

Captura GoldenGate para Cluster MySQL InnoDB

Há um problema conhecido que pode interromper a captura do Oracle GoldenGate ao capturar de um Cluster MySQL InnoDB.

GoldenGate atualmente suporta GTIDs padrão, mas GTIDs não marcados. MySQL O Shell 9.5 e posterior adiciona automaticamente uma tag mysqlsh a determinadas transações administrativas quando usado com o MySQL Server 8.3 ou posterior. Se GoldenGate encontrar essas transações marcadas, o Extract baseado em GTID poderá falhar.

Isso afeta a captura baseada em GTID para o Cluster MySQL InnoDB. A captura MySQL stand-alone usando número de log e deslocamento não é afetada.

Como evitar esse problema

Execute uma ação antes de fazer upgrade do cluster: use o Shell 9.4 MySQL ou uma versão anterior para o upgrade do cluster. Não use o Shell 9.5 ou mais recente MySQL para operações de cluster ao usar um Extract baseado em GTID GoldenGate.

Escolher a versão do Shell após iniciar a atualização é tarde demais. Se o Shell 9.5 ou posterior do MySQL adicionar GTIDs marcados, o Extract poderá falhar; a recuperação exigirá uma ressincronização completa.

Solução alternativa

Você pode fazer upgrade do MySQL Server para a versão 8.3 ou posterior, mas usar o MySQL Shell 9.4 ou anterior para instalar, configurar ou fazer upgrade do Cluster InnoDB. Faça isso antes de configurar o Extract GoldenGate.

A revogação do privilégio TRANSACTION_GTID_TAG não é uma solução alternativa válida e pode fazer com que as operações do Shell MySQL, como adicionar ou remover uma instância, falhem.

Nota de segurança: MySQL O Shell 9.4 contém vulnerabilidades tratadas em releases posteriores. Revise as implicações de segurança com sua equipe de segurança antes de usar essa solução alternativa temporária.

Replicação do Apache Iceberg usando os buckets do AWS Glue Data Catalog e do Amazon S3

Nas replicações do Apache Iceberg usando o AWS Glue Data Catalog e os buckets do AWS S3, você pode encontrar o seguinte erro:

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]

Solução alternativa: atualize o gg.classpath da seguinte forma:

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

Problema no protocolo de segurança TLS

MongoDB, DocumentDB e Protocolo de Segurança TLS de Coleta JSON da Oracle

Se a conexão do Replicat MongoDB, do Replicat DocumentDB ou da Coleta JSON da Oracle falhar com o seguinte erro no arquivo de Relatório:

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

Solução alternativa: Adicione a seguinte propriedade ao arquivo Properties, atualize <connection_ocid> com o OCID da sua conexão e mantenha o restante como está.

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

Bug 37518857: OGGDAA GGS Snowflake Streaming Replicat erro

O Handler de Streaming do Snowflake falha com: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Solução alternativa: adicione o seguinte ao arquivo de Propriedades do Replicat:

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

A console de implantação do OCI GoldenGate não pode exibir o arquivo Discard nomeado personalizado/não padrão

Descarte arquivos, por padrão, siga a convenção de nomenclatura <process-name>.dsc. Você pode ver todos os arquivos de descarte na console de implantação do OCI GoldenGate, a menos que os renomeie. A console de implantação não exibe arquivos de descarte nomeados personalizados.

Solução alternativa: Use a ferramenta de diagnóstico Coletar na página de detalhes da implantação para acessar seus arquivos de descarte.

Os processos Replicat falham ao usar o arquivo de Trilha do Extract MongoDB com BINARY_JSON_FORMAT

Quando um Replicat usa um arquivo de Trilha gerado com base em um Extract MongoDB com BINARY_JSON_FORMAT no arquivo de parâmetros Extract, o Replicat falha com o seguinte erro:

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)

Solução alternativa: Quando BINARY_JSON_FORMAT é removido dos parâmetros de Extract, o Replicat é executado com sucesso e os documentos são representados no formato JSON Estendido.

Falha nos Extracts de captura de dados de alteração remota para bancos de dados ativados por GTID

Quando você cria um processo de Extract de Captura de Dados de Alteração com a opção Remota ativada para um banco de dados MySQL que usa identificadores de transação global (GTIDs), o processo de Extract falha e o seguinte erro é reportado:

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

Solução alternativa: Na tela do arquivo Parâmetro da Extração de Captura de Dados de Alteração, remova a linha, TRANLOGOPTIONS ALTLOGDEST REMOTE.

Para obter mais informações, consulte Usando o Oracle GoldenGate para MySQL.

Caminhos de Distribuição: Adicione o certificado raiz ao Gerenciamento de Certificados ou à wallet do cliente

Para enviar ou extrair dados do OCI GoldenGate, crie um Caminho do Servidor de Distribuição ou um caminho iniciado pelo destino do Servidor do Receptor no Oracle GoldenGate on-premises ou do Marketplace, respectivamente. Você também deve adicionar o certificado raiz ou certificado autoassinado do OCI GoldenGate ao seu Oracle GoldenGate Certificate Management (Oracle GoldenGate 21c ou superior) ou wallet de cliente (Oracle GoldenGate 19c). Isso cria uma conexão confiável entre as implantações do Oracle GoldenGate e do OCI GoldenGate. Somente o protocolo WSS (WebSocket Secure) é suportado para Caminhos do Servidor de Distribuição e do Receptor entre o Oracle GoldenGate e o OCI GoldenGate.

Uma alteração no certificado raiz do OCI GoldenGate fará com que o Caminho do Servidor de Distribuição ou um caminho iniciado pelo destino do Servidor do Receptor no Oracle GoldenGate on-premises ou do Marketplace falhe e produza o seguinte erro:

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.

Solução alternativa: Para corrigir esse problema, atualize o certificado na wallet do cliente ou na tela Gerenciamento de Certificados do Gerenciador de Serviço para usar o certificado raiz do Console de Implantação GoldenGate do OCI. Em alguns casos, quando o certificado da implantação do GoldenGate do OCI não é assinado diretamente pelo certificado raiz, mas por um(s) intermediário(s), por exemplo, pode ser necessário também adicionar o(s) certificado(s) de CA intermediário(s).

Saber mais:

Apenas a Autenticação de Compilação é suportada atualmente

O Oracle Cloud Infrastructure GoldenGate no momento não suporta autenticação baseada em certificado quando você usa o Oracle Cloud Infrastructure GoldenGate como destino do Caminho de Distribuição.

Solução alternativa: nenhuma.