Problemas conhecidos com conexões GoldenGate do OCI

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:

Solução alternativa: Recrie sua conexão sem usar os Segredos do OCI Vault:

  1. Na página Criar conexão, expanda Opções avançadas na parte inferior da página.

  2. Em Opções avançadas, expanda Configurações.

  3. Desmarque Usar segredos no vault.

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

Erro de autenticação da conexão do Apache Iceberg com o serviço AI Data Catalog

As conexões do Apache Iceberg com o serviço AI Data Catalog expiram devido a um erro de autenticação causado pela expiração do token. Se você encontrar esse problema, entre em contato com o Suporte Técnico da Oracle.

Erro do Apache Iceberg NoSuchFileException

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:

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

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 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 as 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:

  1. Conecte-se ao Cloud Shell.

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

  3. Designe a conexão à sua implantação.

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

MongoDB Testar problema de conexão

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 ** para testar a conexão.

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 GoldenGate do OCI 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:

  1. Inicie a console de implantação para uma implantação que use a conexão do Autonomous AI Database.

  2. Na console de implantação, abra o menu de navegação e selecione Configuração.

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

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.