Problemas conhecidos no OCI GoldenGate
Informações Gerais
Saiba mais sobre problemas gerais conhecidos que se aplicam a todo o serviço e como contorná-los.
Após o upgrade para o Oracle GoldenGate 23.26.x, o acesso à console de implantação poderá encontrar 502 erros de Gateway Inválido ou falhar na lista de processos do GoldenGate após o log-in
As implantações do Oracle Cloud Infrastructure GoldenGate 23.26 podem ficar insalubres após o upgrade de labels anteriores para a versão 23.26.x ou após a execução de uma operação de interrupção/inicialização em uma implantação do 23.26.x.
Solução alternativa: O upgrade afetou as implantações da Oracle para rotular o oggoracle:23.26.1.0.0_260331, a fim de corrigir esse problema.
Para Big Data e outros rótulos não Oracle, uma correção será anunciada em breve. Entre em contato com o Suporte para obter a mitigação manual provisória para evitar impacto.
AdminClient: Problema com comando do perfil de informações
O uso do comando info profile no AdminClient retorna o erro 302.
Solução alternativa: Use o seguinte comando da API REST:
GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default
Os Caminhos de Distribuição e Receptor podem falhar após as implantações 21.x atualizadas para 21.17
A partir do Oracle GoldenGate versões 21.17 e 26ai, os Caminhos usam o nome de domínio reservado padrão, "Rede", de modo que os Caminhos existentes que usam qualquer outro nome de domínio falham com o seguinte erro reportado:
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.'
Solução alternativa: Na console de implantação do OCI GoldenGate, edite cada Caminho e altere o nome do domínio para "Rede" e reinicie o Caminho. Para verificar, verifique o domínio do usuário de autenticação de Caminho na seção de armazenamento de Credenciais da página Configuração.
Se preferir usar o Admin Client, execute os comandos a seguir para atualizar o nome do domínio. Certifique-se de substituir os placeholders <path_name> e <alias>:
Para caminhos iniciados por origem:
ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
Network
Para caminhos iniciados por destino:
ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
Network
Problemas de upgrade para o Oracle GoldenGate 21.17 for Big Data
Os usuários que fazem upgrade do Oracle GoldenGate versões 21.14, 21.15 ou 21.16 do Big Data para a versão 21.17 com propriedades de conexão de armazenamento confiável e/ou armazenamento de chaves configuradas estão falhando com os seguintes erros reportados:
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
Solução Alternativa:
-
Converta o armazenamento confiável e o keystore JKS em PKCS12.
-
No caso da área de armazenamento de chaves, ela deverá solicitar uma senha. O Keytool é um utilitário do JDK.
keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12] -
Para o armazenamento confiável, ele deve solicitar uma senha.
keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
-
-
No arquivo de propriedades do produtor Kafka, defina o seguinte:
ssl.truststore.type=PKCS12 ssl.keystore.type=PKCS12
Problemas durante a reversão de builds 21.15 ou 23.x para 21.14
Ao tentar reverter uma compilação 21.15 ou 23.x para uma das seguintes compilações:
-
O 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)
Você pode encontrar um dos seguintes problemas:
-
Problema de Conexões/Credenciais ausente devido ao novo recurso de criptografia da wallet introduzido na versão 21.15 em diante.
Solução alternativa: você deve cancelar a designação e reatribuir as conexões existentes à implantação e recriar os usuários ausentes necessários para qualquer caminho de Distribuição ou Receptor em uso.
-
Falha ao iniciar o Service Manager devido a um problema com o Serviço de Métricas de Desempenho em rollbacks de 23.x para 21.14. Entre em contato com o Suporte Técnico da Oracle caso encontre esse problema.
-
Falha nos processos do Oracle GoldenGate com o erro "OGG-02431 Cabeçalho de registro inválido encontrado no arquivo de checkpoint."
Solução alternativa: Faça upgrade da implantação para o build 21.14 mais recente disponível na série. Entre em contato com o Suporte Técnico da Oracle se o problema persistir.
Erro de url de redirecionamento inválido ao tentar acessar uma implantação ativada para o IAM usando um IP
Ao tentar acessar uma implantação ativada para o IAM usando o endereço IP da implantação, você encontra o seguinte erro:
{"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"}
Solução alternativa: você pode executar uma das seguintes ações:
Opção 1: Adicione o endereço IP de implantação ao seu Aplicativo de Domínio de Identidades. Para fazer essa alteração, você deve fazer parte do grupo de usuários atribuído ao aplicativo.
-
No menu de navegação do Oracle Cloud, selecione Identidade e Segurança e, em Identidade, selecione Domínios.
-
Selecione seu domínio na lista Domínios.
-
No menu de recursos do Domínio de Identidades do domínio, selecione Oracle Cloud Services.
-
Selecione seu aplicativo na lista Oracle Cloud Services. Por exemplo, Aplicativo GGS INFRA para Id de Implantação:<OCID de Implantação>.
-
Na página do aplicativo em configuração do OAuth, selecione Editar configuração do OAuth.
-
Para URL de Redirecionamento, informe o URL da Console da implantação com o IP da implantação no lugar do domínio. Por exemplo:
https://<deployment-ip>/services/adminsrvr/v2/authorization. -
Salve as alterações.
Opção 2: Adicione uma entrada no arquivo de hosts do cliente para mapear 127.0.0.1 para seu FQDN de implantação (substitua <region> pela região apropriada). Por exemplo:
127.0.0.1 xx.deployment.goldengate.<region>.oci.oraclecloud.com
Não é possível atualizar certificados personalizados em implantações do IAM
O serviço proíbe atualizações no FQDN, pois afeta o acesso entre regiões e requer atualizações nos recursos do IAM na região de destino.
Solução alternativa: para contornar esse problema, crie uma nova implantação para usar o FQDN atualizado.
As APIs REST do Oracle GoldenGate retornam 302 redirecionamentos para uma página de índice
Você pode usar as APIs REST do GoldenGate para gerenciar suas implantações do OCI GoldenGate. Para aqueles familiarizados com o Oracle GoldenGate, observe que o Service Manager não é exposto no OCI GoldenGate e nenhuma chamada feita ao Service Manager poderá ser retornada.
AdminClient: Não é possível negociar: nenhum tipo de chave de host correspondente encontrado
Quando você usa AdminClient no Cloud Shell para estabelecer conexão com sua implantação, pode encontrar a seguinte mensagem:
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
Solução alternativa: Conclua as seguintes etapas:
-
Abra uma nova sessão do Cloud Shell.
-
Crie um arquivo usando o seguinte comando:
cat .ssh/config -
Informe o seguinte no arquivo
.ssh/confige salve-o:HostkeyAlgorithms ssh-rsa,ssh-ed25519 PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa -
Se houver um arquivo
.ssh/known_hostsexistente, exclua-o. -
Feche a sessão do Cloud Shell.
-
Selecione Iniciar Admin Client na página de detalhes da implantação.
Conexões
Explore problemas conhecidos relacionados a conexões e como contornar eles.
Oracle AI Data Platform: autenticação do Controlador de Recursos
A autenticação do Controlador de Recursos para conexões do Oracle AI Data Platform encontra o seguinte erro:
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].
Solução alternativa: Edite a conexão e selecione outro método de autenticação, como Usar tenancy e usuário atuais ou Especificar outra tenancy e usuário.
Erros encontrados ao usar Conexões com Segredos
Você pode encontrar erros de conectividade ao usar Conexões com segredos e vaults nas seguintes versões do 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
-
23.8.0.0.0_250412.2241_1246 oggdb2zos
-
oggdb2i:23.8.0.0.0_250524.0756_1253
-
oggdb2i:23.8.0.0.0_250524.0756_1246
Solução alternativa: Recrie sua conexão sem usar os Segredos do OCI Vault:
-
Na página Criar conexão, expanda Opções avançadas na parte inferior da página.
-
Em Opções avançadas, expanda Configurações.
-
Desmarque Usar segredos no vault.
-
Selecione Criar.
Ou, se as opções Avançadas não estiverem disponíveis na sua conexão, tente usar uma versão anterior da implantação.
Erro de replicação do Oracle Object Storage ao usar o Controlador de Recursos
Se a conexão do Oracle Object Storage usar a autenticação do Controlador de Recursos, o processo Replicat falhará com o seguinte erro:
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
Solução alternativa: para contornar esse problema, edite a conexão e selecione outro método de autenticação.
Problema com conexões do Apache Iceberg no OCI GoldenGate
Se você encontrar o seguinte erro ao usar as conexões do Apache Iceberg, abra um ticket de suporte, compartilhe os detalhes e a mensagem de erro:
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.
Erros Java.net.UnknownHostException para conexões do Amazon S3 e do Google Cloud Storage
As conexões do Amazon S3 e do Google Cloud Storage com pontos finais Compartilhados encontram erros do Java.net.UnknownHostException.
Solução alternativa: Edite a conexão e altere o método de roteamento de tráfego para Dedicado ou selecione Dedicado ao criar conexões do Amazon S3 e do Google Cloud Storage.
Problema com conexões do Amazon S3 no OCI GoldenGate
Se você encontrar o seguinte erro ao usar conexões do Amazon S3, abra um ticket de suporte, compartilhe os detalhes e a mensagem de erro.
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
Solução Alternativa:
-
Conecte-se ao Cloud Shell.
-
Crie uma nova conexão do Amazon S3 usando a seguinte amostra da 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> -
Atribua a conexão à sua implantação.
-
Adicionar e executar um processo de Replicat para Amazon S3.
Como alternativa, se você preferir não usar o acesso público, configure os buckets da sua conexão do Amazon S3 para usar os Pontos Finais do AWS VPC. Para que o OCI GoldenGate acesse seu bucket S3 usando Pontos Finais de VPC, você também deve configurar uma VPN IPsec entre sua VCN e a VPC da AWS.
Para definir o ponto final para o Amazon S3, adicione a propriedade gg.eventhandler.s3.url ao Arquivo de Propriedades de Replicat e forneça o ponto final para a conexão privada.
Problema com conexão de Teste do MongoDB
Você pode encontrar um erro ao usar a conexão de Teste com conexões MongoDB. Você pode ignorar esse erro e testar conexões MongoDB na console de implantação do OCI GoldenGate. Na console de implantação, abra o menu de navegação do Administration Service e selecione Configuração. Sua conexão MongoDB deve ser listada como uma credencial, na qual você pode selecionar **Conectar-se ao
Ação necessária para conexões do Autonomous AI Database que usam Autenticação mTLS
Quando uma wallet do Autonomous AI Database é rotacionada, a conexão do OCI GoldenGate com esse banco de dados deve ser atualizada para recuperar as informações mais recentes da wallet.
Para obter mais informações consulte o Documento 2911553.1 do My Oracle Support (MOS).
Para atualizar uma conexão do Autonomous AI Database: Edite e salve a conexão com o Autonomous AI Database (Autonomous AI Transaction Processing ou Autonomous AI Lakehouse). Salvar a conexão faz download automaticamente e atualiza a wallet. Nenhuma outra alteração na conexão é necessária.
Para verificar:
-
Inicie a console de implantação para uma implantação que use a conexão do Autonomous AI Database.
-
Na console de implantação, abra o menu de navegação e selecione Configuração.
-
Na tela Credenciais, observe a string de conexão do Autonomous AI Database.
Antes da atualização da wallet, a string de conexão tem a seguinte aparência:
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")))Após a atualização da wallet, a string de conexão é atualizada para ter a seguinte aparência:
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)))
Bancos de dados MySQL não aparecem na lista Alias de Credenciais
Os nomes de usuário de banco de dados MySQL que incluem um símbolo '@' não aparecem na lista Alias de Credenciais ao criar um Extract na console da implantação do OCI GoldenGate.
Solução alternativa: Selecione outro alias da lista e atualize manualmente o Arquivo de Parâmetros na próxima tela.
Os timeouts de rede afetam as conexões de banco de dados usando pontos finais privados
Se você estiver usando um ponto de extremidade privado para se conectar a um banco de dados, poderá encontrar tempos limite de rede ao iniciar ou interromper processos de Extract.
Solução alternativa: você pode executar uma das seguintes ações:
-
Aplique os patches mais recentes da sua página de detalhes da implantação. Na seção Informações de Implantação, em GoldenGate, para Versão, selecione Upgrade.
-
Se você não conseguir aplicar os patches mais recentes nesse momento, poderá atualizar a string de conexão para incluir
EXPIRE_TIME=1. Por padrão, você pode ter uma string de conexão EZ no Oracle GoldenGate. Essa string de conexão precisa ser atualizada na Credencial do Oracle GoldenGate para uma string de conexão longa da seguinte forma:<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>)))
O proxy SCAN não suporta TLS
Embora o OCI GoldenGate suporte IPs e hosts SCAN (Single Client Access Name) da Oracle, o proxy SCAN não suporta TLS.
Solução alternativa: Você pode estabelecer conexão com um banco da dados RAC usando o IP do Nó do Banco de Dados.
Incompatibilidade do OCID do Usuário na conexão do Oracle Object Storage (Somente usuários federados)
Se um usuário federado selecionar Usar usuário atual ao criar uma conexão do Oracle Object Storage, seu OCID não corresponderá ao OCID selecionado pelo sistema.
Solução alternativa: ao criar uma conexão do Oracle Object Storage, escolha Especificar outro usuário e digite o OCID do usuário federado.
Para localizar o OCID do usuário, selecione Perfil no cabeçalho global da console do Oracle Cloud e, em seguida, selecione o nome do usuário. Na página Detalhes do Usuário, em Informações do Usuário, selecione Mostrar para OCID.
Console de implantação do
Explore problemas conhecidos relacionados à console de implantação do OCI GoldenGate.
Falha ao carregar a console de implantação
Se você informar um nome de domínio totalmente qualificado (FQDN) cuja última parte seja maior que 11 caracteres, a console de implantação falhará ao carregar.
Solução alternativa: mantenha a última parte do seu FQDN com 11 caracteres.
A console de implantação do OCI GoldenGate não é compatível com web browsers Safari
A Console de Implantação do Oracle Cloud Infrastructure GoldenGate não será exibida corretamente quando acessada usando um web browser Safari.
Solução alternativa: use os browsers Chrome ou FireFox.
A conexão com uma credencial pode levar alguns minutos
Na tela Configuração da console de implantação, quando você tenta estabelecer conexão com uma credencial, pode levar vários minutos para que a conexão seja bem-sucedida. A atualização da tela só adicionará tempo ao processo de conexão.
Solução alternativa: Este é um problema conhecido que foi resolvido na versão oggoracle:21.8.0.0.0_221119.1258_663 do GoldenGate.
Processos do GoldenGate
Explore problemas conhecidos relacionados aos processos do GoldenGate e como contorná-los.
MongoDB, DocumentDB e Oracle JSON Collection TLS Security Protocol
Se a conexão Replicat do MongoDB, Replicat do DocumentDB ou Coleção do Oracle JSON 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.
Falha nos processos Replicat ao usar o arquivo de Trilha do MongoDB Extract com BINARY_JSON_FORMAT
Quando um Replicat usa um arquivo de Trilha gerado de um Extract MongoDB com BINARY_JSON_FORMAT no arquivo de parâmetros do 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 carteira 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 do OCI GoldenGate. Em alguns casos, quando o certificado da implantação do OCI GoldenGate 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:
-
Para usuários Oracle GoldenGate 19c, consulte Criando um Certificado de Usuário de Caminho do Servidor de Distribuição.
-
Para usuários do Oracle GoldenGate 21c ou superior, consulte Criar uma Conexão Confiável Entre o Oracle GoldenGate e a OCI GoldenGate.
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.
GoldenGate no Oracle AI Database@Azure
Âncora de recurso pendente ou com falha
Confirme se sua conta do Azure tem a atribuição Colaborador no Grupo de Recursos de destino e se o provedor de recursos do Oracle AI Database@Azure está registrado em Azure, Assinaturas e Provedores de Recursos.
Falha na ancoragem de rede com erro de delegação de sub-rede
Delegue a sub-rede ao Oracle AI Database@Azure antes de criar a Âncora de Rede. No Portal do Azure, selecione Redes Virtuais, Sub-redes e, em seguida, Delegação e confirme se a delegação correta está definida.
Compartimento do OCI não visível após a criação da Âncora de Recursos
Aguarde até cinco minutos para propagação. Se ainda não aparecer, confirme se a Âncora de Recursos mostra Ativo no Portal do Azure. Se ela mostrar Falha, exclua-a e recrie-a.
o grupo odbaa-goldengate-administrators não existe
Sua tenancy provavelmente foi provisionada antes de 7 de outubro de 2025. Execute o script de automação do Cloud Shell na Etapa 3 para criar o grupo e as políticas em uma etapa.
Problemas comuns encontrados com a criação da implantação
Se o goldengate-deployments do grupo dinâmico não for aplicado corretamente, você provavelmente encontrará um ou mais dos seguintes problemas durante a criação da implantação:
-
O valor da zona de disponibilidade do Azure não corresponde à Âncora de Rede (incompatibilidade de zona — mais comum)
-
A cota de serviço para Vault, chave, Segredo ou Balanceador de Carga foi atingida na região de destino
-
O segredo do Vault ou a chave de criptografia está em outro compartimento sem política entre compartimentos
Implantação bloqueada por erro de autorização
Confirme se o grupo dinâmico goldengate-deployments existe. No menu de navegação do Oracle Cloud, selecione Identity & Security, Dynamic Groups e verifique se a regra de correspondência está correta. Verifique se as políticas que concedem ao grupo acesso para gerenciar secret-family, vaults e chaves têm escopo no compartimento correto.
Implantação mantida no estado de criação ou com falha
Na página de detalhes da implantação, alterne para a guia Solicitações de Serviço e verifique se há erros nas mensagens. As causas comuns incluem:
-
Incompatibilidade de zona — a zona de disponibilidade lógica não corresponde à Âncora de rede. Recrie a Âncora de Rede com a zona correta e, em seguida, recrie a implantação.
-
Cota atingida do Balanceador de Carga - use a barra de pesquisa do OCI para procurar Limites, Cotas e Uso, depois filtrar por ORACLEDBATAZURE e solicitar um aumento, se necessário.
-
Segredo ou chave do vault inacessível — confirme se o segredo e a chave estão no mesmo compartimento da implantação ou se existem políticas entre compartimentos.
Implantação não visível no Portal do Azure
Uma assinatura diferente de ORACLEDBATAZURE foi selecionada durante a criação. Exclua a implantação e recrie-a com a assinatura correta.
Senha em texto sem formatação rejeitada
A palavra-passe deve ter pelo menos 8 caracteres e incluir uma letra maiúscula, uma minúscula, um número e um caractere especial. Ele não deve conter o nome de usuário.
Segredo do vault inacessível
Confirme se o estado do segredo está Ativo. No menu de navegação do Oracle Cloud, selecione Identity & Security e, em seguida, Secret Management. Não é possível usar segredos com exclusão pendente.
A conexão não pode acessar o banco de dados
Confirme se a porta do banco de dados necessária está aberta no NSG do Azure e na lista de segurança do OCI na sub-rede mapeada por Âncora de Rede. Se estiver usando um nome de host, verifique se a resolução de DNS está configurada de acordo com a documentação de Resolução de DNS para Âncoras de Rede vinculada na Tarefa 1, Etapa 2.
Transformações de Dados
A implantação do Data Transforms não faz backup de conexões genéricas
As conexões genéricas atribuídas às implantações do Data Transforms não são incluídas no processo de backup.
A implantação de Transformações de Dados Restauradas remove conjuntos de dados delta
Os conjuntos de dados de Transformação de Dados criados durante e após a restauração de uma implantação de Transformação de Dados serão perdidos.
Pipelines
Explore problemas conhecidos relacionados a Pipelines e como contorná-los.
No momento, não há suporte para conexões do Autonomous AI Database com o Autonomous Data Guard ativado
No momento, não há suporte para conexões do Autonomous AI Database ativadas pelo Autonomous Data Guard nos Pipelines do OCI GoldenGate.
Solução alternativa: Desative o Autonomous Data Guard (ADG) ou use outro Autonomous AI Database. Atualize sua conexão se você tiver desativado o ADG para atualizar a string de conexão usada pelo OCI GoldenGate.
O Oracle Data Pump falhará se a versão do arquivo de fuso horário do banco de dados de destino for inferior à versão do banco de dados de origem
A opção de pipeline, "Copiar dados existentes para o banco de dados de destino antes de iniciar a replicação", usa o Oracle Data Pump. O Oracle Data Pump falhará se a versão do arquivo de fuso horário do banco de dados de destino for inferior à do banco de dados de origem.
Solução alternativa: para contornar isso, você deve fazer upgrade da versão do fuso horário do banco de dados de destino. Consulte Gerenciar atualizações de arquivo de fuso horário no Autonomous AI Database.