Problemas conocidos con las conexiones GoldenGate de OCI

Explore las incidencias conocidas relacionadas con las conexiones y cómo solucionarlas.

Oracle AI Data Platform: autenticación de entidad de recurso

La autenticación de la entidad de recurso para las conexiones de Oracle AI Data Platform encuentra el siguiente error:

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

Solución alternativa: edite la conexión y seleccione un método de autenticación diferente, como Usar arrendamiento y usuario actuales o Especificar otro arrendamiento y usuario.

Errores encontrados al utilizar conexiones con secretos

Puede encontrar errores de conectividad al utilizar conexiones con secretos y almacenes en las siguientes versiones de OCI GoldenGate:

Solución alternativa: vuelva a crear la conexión sin utilizar los secretos de OCI Vault:

  1. En la página Crear conexión, amplíe Opciones avanzadas en la parte inferior de la página.

  2. En Opciones avanzadas, amplíe Configuración.

  3. Anule la selección de Usar secretos en almacén.

  4. Seleccione Crear.

O bien, si las opciones avanzadas no están disponibles en la conexión, intente utilizar una versión anterior del despliegue.

Error de replicación de Oracle Object Storage al utilizar la entidad de recurso

Si su conexión a Oracle Object Storage utiliza la autenticación de la entidad de recurso, el Replicat falla con el siguiente error:

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

Solución alternativa: para solucionar este problema, edite la conexión y, a continuación, seleccione un método de autenticación diferente.

Error de autenticación de conexión de Apache Iceberg al servicio AI Data Catalog

Las conexiones de Apache Iceberg al servicio AI Data Catalog caducan debido a un error de autenticación causado por la caducidad del token. Si encuentra este problema, póngase en contacto con los Servicios de Soporte Oracle.

Error NoSuchFileException de Apache Iceberg

Si encuentra el siguiente error al utilizar conexiones de Apache Iceberg, abra un ticket de soporte, comparta los detalles y el mensaje de error:

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

Errores de Java.net.UnknownHostException para conexiones de Amazon S3 y Google Cloud Storage

Las conexiones de Amazon S3 y Google Cloud Storage con puntos finales compartidos encuentran errores Java.net.UnknownHostException.

Solución alternativa: edite la conexión y cambie el método de enrutamiento de tráfico a Dedicado, o seleccione Dedicado cuando cree conexiones de Amazon S3 y Google Cloud Storage.

Problema con las conexiones de Amazon S3 en OCI GoldenGate

Si encuentra el siguiente error al utilizar conexiones de Amazon S3, abra un ticket de soporte, comparta los detalles y el mensaje de error.

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

Solución alternativa:

  1. Conéctese a Cloud Shell.

  2. Cree una nueva conexión de Amazon S3 mediante el siguiente ejemplo de la 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. Asigne la conexión al despliegue.

  4. Adición y ejecución de una réplica para Amazon S3.

De manera alternativa, si prefiere no utilizar el acceso público, configure los cubos de la conexión de Amazon S3 para utilizar los puntos finales de AWS VPC. Para que OCI GoldenGate acceda al cubo S3 mediante puntos finales de VPC, también debe configurar una VPN IPsec entre la VCN y la VPC de AWS.

Para definir el punto final para Amazon S3, agregue la propiedad gg.eventhandler.s3.url al archivo de propiedades de Replicat y proporcione el punto final para la conexión privada.

MongoDB Problema de conexión de prueba

Puede que se produzca un error al utilizar la conexión de prueba con conexiones MongoDB. Puede ignorar este error y probar las conexiones MongoDB en la consola de despliegue GoldenGate de OCI. En la consola de despliegue, abra el menú de navegación para el servicio de administración y seleccione Configuración. La conexión MongoDB debe aparecer como credencial, donde puede seleccionar **Conectar a ** para probar la conexión.

Acción necesaria para las conexiones de Autonomous AI Database que utilizan autenticación mTLS

Cuando se rota una cartera de Autonomous AI Database, se debe refrescar la conexión GoldenGate de OCI a esta base de datos para recuperar la información de cartera más reciente.

Para obtener más información, consulte el My Oracle Support (MOS), documento 2911553.1.

Para refrescar una conexión de Autonomous AI Database: edite y guarde la conexión a Autonomous AI Database (Autonomous AI Transaction Processing o Autonomous AI Lakehouse). Al guardar la conexión, se descarga y refresca automáticamente la cartera. No se necesitan otros cambios en la conexión.

Para verificar:

  1. Inicie la consola de despliegue para un despliegue que utilice la conexión de Autonomous AI Database.

  2. En la consola de despliegue, abra el menú de navegación y, a continuación, seleccione Configuración.

  3. En la pantalla Credenciales, observe la cadena de conexión de Autonomous AI Database.

    Antes de refrescar la cartera, la cadena de conexión tiene el siguiente aspecto:

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

    Después de refrescar la cartera, la cadena de conexión se actualiza para que tenga el siguiente aspecto:

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

Las bases de datos MySQL no aparecen en la lista Alias de Credenciales

Los nombres de usuario de la base de datos MySQL que incluyen un símbolo "@" no aparecen en el alias de credencial cuando se crea un Extract en el despliegue GoldenGate de OCI.

Solución alternativa: seleccione un alias diferente de la lista y, a continuación, actualice manualmente el archivo del parámetro en la siguiente pantalla.

Los timeout de red afectan a las conexiones de base de datos con puntos finales privados

Si utiliza un punto finales privado para conectarse a una base del datos, puede que se produzca timeout de red al iniciar o parar procesos de Extract.

Solución alternativa: puede realizar una de las siguientes acciones:

El servidor proxy SCAN no soporta TLS

Aunque OCI GoldenGate soporta hosts e IP de nombre único de acceso de cliente (SCAN) de Oracle, el proxy SCAN no soporta TLS.

Solución alternativa: puede conectarse a una base del sistema RAC mediante la IP del nodo de base de Datos.

El OCID del usuario no coincide en la conexión de Oracle Object Storage (solo para usuarios federados)

Si un usuario federado selecciona Usar usuario actual al crear una conexión a Oracle Object Storage, su OCID no coincidirá con el OCID seleccionado por el sistema.

Solución alternativa: al crear una conexión a Oracle Object Storage, asegúrese en Especificar otro usuario y, a continuación, introduzca el OCID del usuario federado.

Para buscar el OCID del usuario, seleccione Perfil en la cabecera global de la consola de Oracle Cloud y, a continuación, seleccione el nombre de usuario. En la página Detalles de usuario, en Información de usuario, seleccione Mostrar en OCID.