Problemas conocidos en OCI GoldenGate
General
Obtenga información sobre las incidencias conocidas generales que se aplican al servicio completo y cómo solucionarlas.
Después de actualizar a Oracle GoldenGate 23.26.x, el acceso a la consola de despliegue puede encontrar 502 errores de gateway incorrecto o no puede mostrar los procesos de GoldenGate después de conectarse
Es posible que los despliegues de Oracle Cloud Infrastructure GoldenGate 23.26 no estén en buen estado después de actualizar de etiquetas anteriores a la versión 23.26.x o después de realizar una operación de parada/inicio en un despliegue de 23.26.x.
Solución alternativa: la actualización de los despliegues de Oracle afectados a la etiqueta oggoracle:23.26.1.0.0_260331 para solucionar este problema.
En el caso de Big Data y otras etiquetas que no sean de Oracle, se anunciará una corrección en breve. Póngase en contacto con el servicio de soporte para la mitigación manual provisional a fin de evitar el impacto.
AdminClient: Problema con el comando de perfil de información
El uso del comando de perfil de información en AdminClient devuelve el error 302.
Solución alternativa: utilice el siguiente comando de la API de REST:
GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default
Las rutas de distribución y receptor pueden fallar después de actualizar los despliegues de la versión 21.x a la versión 21.17
A partir de las versiones 21.17 y 26ai de Oracle GoldenGate, las rutas utilizan el nombre de dominio reservado por defecto, "Red", por lo que las rutas existentes que utilizan cualquier otro nombre de dominio fallan con el siguiente error informado:
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.'
Solución alternativa: en la consola de despliegue de OCI GoldenGate, edite cada ruta y cambie el nombre de dominio a "Red" y, a continuación, reinicie la ruta. Para verificarlo, compruebe el dominio del usuario de autenticación de ruta de acceso en la sección Almacén de credenciales de la página Configuración.
Si prefiere utilizar el cliente de administración, ejecute los siguientes comandos para actualizar el nombre de dominio. Asegúrese de sustituir los marcadores de posición <path_name> y <alias>:
Para rutas iniciadas por el origen:
ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
Network
Para rutas iniciadas en el destino:
ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
Network
Problemas al actualizar a Oracle GoldenGate 21.17 para Big Data
Los usuarios que actualizan de las versiones 21.14, 21.15 o 21.16 de Oracle GoldenGate para Big Data a la versión 21.17 con propiedades de conexión de almacén de confianza y/o almacén de claves configuradas fallan con los siguientes errores informados:
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
Solución alternativa:
-
Convierta el almacén de confianza y el almacén de claves de JKS a PKCS12.
-
Para el almacén de claves, debe solicitar una contraseña. Keytool es una utilidad en el JDK.
keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12] -
Para el almacén de confianza, debe solicitar una contraseña.
keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]
-
-
En el archivo de propiedades del productor de Kafka, defina lo siguiente:
ssl.truststore.type=PKCS12 ssl.keystore.type=PKCS12
Problemas durante el rollback de versiones 21.15 o 23.x a 21.14
Al intentar realizar un rollback de una compilación 21.15 o 23.x en una de las siguientes compilaciones:
-
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)
Puede encontrar uno de los siguientes problemas:
-
Falta el problema de conexiones/credenciales debido a la nueva función de cifrado de cartera introducida en la versión 21.15.
Solución alternativa: debe anular la asignación y reasignar las conexiones existentes al despliegue y volver a crear los usuarios que faltan necesarios para cualquier ruta de distribución o receptor en uso.
-
El gestor de servicios no se puede iniciar debido a un problema con el servicio de métricas de rendimiento en las reversiones de 23.x a 21.14. Póngase en contacto con los Servicios de Soporte Oracle si encuentra este problema.
-
Los procesos de Oracle GoldenGate fallan con el error "OGG-02431 Se ha encontrado una cabecera de registro no válida en el archivo de punto de control".
Solución alternativa: actualice el despliegue a la última versión de la versión 21.14 disponible en la serie. Si el problema continúa, póngase en contacto con los Servicios de Soporte Oracle.
Error de URL de redirección no válido al intentar acceder a un despliegue activado para IAM mediante una IP
Al intentar acceder a un despliegue activado para IAM mediante la dirección IP del despliegue, aparece el siguiente error:
{"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"}
Solución alternativa: puede realizar una de las siguientes acciones:
Opción 1: agregue la dirección IP de despliegue a la aplicación de dominio de identidad. Para realizar este cambio, debe formar parte del grupo de usuarios asignado a la aplicación.
-
En el menú de navegación de Oracle Cloud, seleccione Identidad y seguridad y, a continuación, en Identidad, seleccione Dominios.
-
Seleccione su dominio en la lista Dominios.
-
En el menú de recursos Dominio de identidad del dominio, seleccione Oracle Cloud Services.
-
Seleccione la aplicación en la lista de Oracle Cloud Services. Por ejemplo, Aplicación GGS INFRA para ID de despliegue:<OCID de despliegue>.
-
En la página de la aplicación en Configuración de OAuth, seleccione Editar configuración de OAuth.
-
En URL de redirección, introduzca la URL de consola del despliegue con la IP del despliegue en lugar del dominio. Por ejemplo:
https://<deployment-ip>/services/adminsrvr/v2/authorization. -
Guarde los cambios.
Opción 2: agregue una entrada en el archivo de hosts de cliente para asignar 127.0.0.1 al FQDN de despliegue (sustituya <region> por la región adecuada). Por ejemplo:
127.0.0.1 xx.deployment.goldengate.<region>.oci.oraclecloud.com
No se han podido actualizar los certificados personalizados en despliegues de IAM
El servicio prohíbe las actualizaciones del FQDN, ya que afecta al acceso entre regiones y requiere actualizaciones de los recursos de IAM en la región de destino.
Solución alternativa: para solucionar este problema, cree un nuevo despliegue para utilizar el FQDN actualizado.
Las API REST de Oracle GoldenGate devuelven 302 redireccionamientos a una página de índice
Puede utilizar las API de REST de GoldenGate para gestionar los despliegues de OCI GoldenGate. Para aquellos familiarizados con Oracle GoldenGate, tenga en cuenta que el gestor de servicios no está expuesto en OCI GoldenGate y que las llamadas realizadas al gestor de servicios no podrán volver.
AdminClient: No se ha podido negociar: no se ha encontrado ningún tipo de clave de host coincidente
Cuando utilice AdminClient en Cloud Shell para conectarse al despliegue, puede que aparezca el siguiente mensaje:
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
Solución alternativa: realice los siguientes pasos:
-
Abra una nueva sesión de Cloud Shell.
-
Cree un archivo con el siguiente comando:
cat .ssh/config -
Introduzca lo siguiente en el archivo
.ssh/configy guárdelo a continuación:HostkeyAlgorithms ssh-rsa,ssh-ed25519 PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa -
Si hay un archivo
.ssh/known_hostsexistente, suprímalo. -
Cierre la sesión de Cloud Shell.
-
Seleccione Iniciar Cliente de Administración en la página de detalles del despliegue.
Conexiones
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 detecta 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:
-
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
-
oggdb2zos:23.8.0.0.0_250412.2241_1246
-
oggdb2i:23.8.0.0.0_250524.0756_1253
-
oggdb2i:23.8.0.0.0_250524.0756_1246
Solución alternativa: vuelva a crear la conexión sin utilizar los secretos de OCI Vault:
-
En la página Crear conexión, amplíe Opciones avanzadas en la parte inferior de la página.
-
En Opciones avanzadas, amplíe Configuración.
-
Anule la selección de Usar secretos en almacén.
-
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.
Problema con las conexiones de Apache Iceberg en OCI GoldenGate
Si encuentra el siguiente error al utilizar conexiones de Apache Iceberg, abra un ticket de soporte, comparta los detalles y el mensaje de error:
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.
Errores de Java.net.UnknownHostException para las conexiones de Amazon S3 y Google Cloud Storage
Las conexiones de Amazon S3 y Google Cloud Storage con puntos finales compartidos encuentran errores de 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 al crear conexiones de Amazon S3 y Google Cloud Storage.
Problema con las conexiones de Amazon S3 en OCI GoldenGate
Si encuentra el siguiente error al usar 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:
-
Conéctese a Cloud Shell.
-
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> -
Asigne la conexión al despliegue.
-
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 de S3 mediante puntos finales de VPC, también debe configurar una VPN con 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.
Problema con la conexión de prueba de MongoDB
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 de OCI GoldenGate. 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
Acción necesaria para las conexiones de base de datos de IA autónoma que utilizan autenticación mTLS
Cuando se rota una cartera de base de datos de IA autónoma, se debe refrescar la conexión de OCI GoldenGate 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 a una base de datos de IA autónoma: edite y guarde la conexión a la base de datos de IA autónoma (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:
-
Inicie la consola de despliegue para un despliegue que utilice la conexión de base de datos de IA autónoma.
-
En la consola de despliegue, abra el menú de navegación y, a continuación, seleccione Configuración.
-
En la pantalla Credenciales, observe la cadena de conexión de la base de datos de IA autónoma.
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 OCI GoldenGate consola.
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:
-
Aplicar los parches más recientes desde la página de detalles del despliegue. En la sección Información de despliegue, en GoldenGate, en Versión, seleccione Cambiar de versión.
-
Si no puede aplicar los parches más recientes en este momento, puede actualizar la cadena de conexión para que incluya
EXPIRE_TIME=1. Por defecto, puede tener una cadena de conexión EZ en Oracle GoldenGate. Esta cadena de conexión se debe actualizar en la credencial de Oracle GoldenGate a una cadena de conexión larga de la siguiente 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>)))
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.
Consola de despliegue
Explore los problemas conocidos relacionados con la consola de despliegue de OCI GoldenGate.
La consola de despliegue no se puede cargar
Si introduce un nombre de dominio completo (FQDN) cuya última parte tenga más de 11 caracteres, la consola de despliegue no se cargará.
Solución alternativa: mantenga la última parte del FQDN por debajo de 11 caracteres.
La consola de despliegue de OCI GoldenGate no es compatible con los exploradores web Safari
La consola de despliegue de Oracle Cloud Infrastructure GoldenGate no se mostrará correctamente si se accede a ella mediante un explorador web Safari.
Solución alternativa: utilice en su lugar exploradores Chrome o FireFox.
La conexión a una credencial puede tardar varios minutos
En la pantalla Configuración de la consola de despliegue, al intentar conectarse a una credencial, puede tardar varios minutos en conectarse correctamente. Si refresca la pantalla, solo se agregará tiempo al proceso de conexión.
Solución alternativa: esta incidencia se resuelve en la versión de compilación oggoracle:21.8.0.0.0_221119.1258_663 de GoldenGate.
Procesos de GoldenGate
Explore las incidencias conocidas relacionadas con los procesos de GoldenGate y cómo solucionarlas.
Protocolo de seguridad TLS de MongoDB, DocumentDB y Oracle JSON Collection
Si la conexión MongoDB Replicat, DocumentDB Replicat u Oracle JSON Collection falla con el siguiente error en el archivo de informe:
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
Solución alternativa: agregue la siguiente propiedad al archivo Properties, actualice <connection_ocid> con el OCID de conexión y mantenga el resto tal cual.
jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123
Error 37518857: OGGDAA GGS Snowflake Streaming Replicat error
El manejador de transmisión de copo de nieve falla con: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"
Solución alternativa: agregue lo siguiente al archivo de propiedades de Replicat:
jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true
La consola de despliegue de OCI GoldenGate no puede mostrar un archivo de desecho con nombre personalizado/no por defecto
Los archivos de desecho, por defecto, siguen la convención de nomenclatura <process-name>.dsc. Puede ver todos los archivos de desecho en la consola de despliegue de OCI GoldenGate, a menos que haya cambiado su nombre. La consola de despliegue no muestra archivos de desecho con nombre personalizados.
Solución alternativa: utilice la herramienta de diagnóstico Collect (Recopilar) de la página de detalles del despliegue para acceder a los archivos de desecho.
Fallo de réplicas al utilizar el archivo de pista de extracción de MongoDB con BINARY_JSON_FORMAT
Cuando un Replicat utiliza un archivo de pista generado a partir de una extracción MongoDB con BINARY_JSON_FORMAT en el archivo de parámetros Extract, el Replicat falla con el siguiente error:
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)
Solución alternativa: cuando se elimina BINARY_JSON_FORMAT de los parámetros Extract, el Replicat se ejecuta correctamente y los documentos se representan en formato JSON extendido.
Fallo de Extracts remotos de captura de cambios en los datos para bases de datos con GTID activado
Cuando se crea un proceso de Extract de captura de cambios en los datos con la opción Remoto activada para una base de datos MySQL que utiliza identificadores de transacción global (GTID), el proceso de Extract falla y se notifica el siguiente error:
ERROR OGG-25192 Trail file '<trail name>' is remote. Only local trail allowed for this extract.
Solución alternativa: en la pantalla Archivo De Parámetros de Extracción de Captura de Cambios en los datos, elimine la línea TRANLOGOPTIONS ALTLOGDEST REMOTE.
Para obtener más información, consulte la sección sobre el uso de Oracle GoldenGate para MySQL.
Rutas de distribución: agregue el certificado raíz a Certificate Management o a la cartera de cliente
Para enviar datos o extraer datos desde OCI GoldenGate, debe crear una ruta de servidor de distribución o una ruta iniciada por el destino en el servidor del receptor en su instancia de Oracle GoldenGate local o de Marketplace, respectivamente. También debe agregar el certificado raíz o certificado autofirmado de OCI GoldenGate a Oracle GoldenGate Certificate Management (Oracle GoldenGate 21c o superior) o la cartera del cliente (Oracle GoldenGate 19c). Esto crea una conexión de confianza entre los despliegues de Oracle GoldenGate y OCI GoldenGate. Solo está soportado el protocolo WebSocket Secure (WSS) para las rutas de servidor de distribución y de receptor entre Oracle GoldenGate y OCI GoldenGate.
Un cambio en el certificado raíz de OCI GoldenGate provocará que falle la ruta del servidor de distribución o una ruta iniciada por el destino en el servidor del receptor de su instancia de Oracle GoldenGate local o de Marketplace y que genere el siguiente error:
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.
Solución: para solucionar esta incidencia, actualice el certificado en la cartera de cliente o en las pantallas Gestión de certificados del Gestor de Servicios para utilizar el certificado raíz de OCI GoldenGate Deployment Console. En algunos casos, cuando el certificado del despliegue de OCI GoldenGate no está firmado directamente por el certificado raíz, sino por uno o varios intermedios, por ejemplo, puede que también sea necesario agregar los certificados de CA intermedios.
Más información:
-
Para los usuarios de Oracle GoldenGate 19c, consulte la sección sobre creación de un Certificado de Usuario de Ruta del Servidor de Distribución.
-
Para los usuarios de Oracle GoldenGate 21c o superior, consulte Crear una conexión de confianza entre Oracle GoldenGate y OCI GoldenGate.
Actualmente solo está soportada la autenticación de resumen
Oracle Cloud Infrastructure GoldenGate no soporta actualmente la autenticación basada en certificados cuando se utiliza Oracle Cloud Infrastructure GoldenGate como destino de ruta de distribución.
Solución alternativa: ninguna.
GoldenGate @ Oracle AI Database@Azure
Anclaje de recursos pendiente o con fallos
Confirme que su cuenta de Azure tiene el rol Contribuyente en el grupo de recursos de destino y que el proveedor de recursos de Oracle AI Database@Azure está registrado en Azure, Suscripciones y, a continuación, Proveedores de recursos.
Error de anclaje de red con error de delegación de subred
Debe delegar la subred a Oracle AI Database@Azure antes de crear el anclaje de red. En el portal de Azure, seleccione Redes virtuales, subredes y, a continuación, Delegación y confirme que se ha definido la delegación correcta.
Compartimento de OCI no visible después de la creación de anclaje de recursos
Espere hasta cinco minutos para la propagación. Si aún no aparece, confirme que Resource Anchor muestra Active en Azure Portal. Si muestra Fallo, suprímalo y vuelva a crearlo.
El grupo odbaa-goldengate-administrators no existe
Su arrendamiento probablemente se aprovisionó antes del 7 de octubre de 2025. Ejecute el script de automatización de Cloud Shell del paso 3 para crear el grupo y las políticas en un solo paso.
Problemas comunes encontrados durante la creación del despliegue
Si el grupo dinámico goldengate-deployments no se aplica correctamente, es probable que encuentre uno o más de los siguientes problemas durante la creación del despliegue:
-
El valor de la zona de disponibilidad de Azure no coincide con el anclaje de red (falta de coincidencia de zona, más común)
-
Se ha alcanzado la cuota de servicio para almacén, clave, secreto o equilibrador de carga en la región de destino
-
El secreto de almacén o la clave de cifrado están en un compartimento diferente sin una política entre compartimentos
Despliegue bloqueado por error de autorización
Confirme que el grupo dinámico goldengate-deployments existe. En el menú de navegación de Oracle Cloud, seleccione Identidad y seguridad, Grupos dinámicos y, a continuación, compruebe que la regla de coincidencia es correcta. Verifique que las políticas que otorgan al grupo acceso para gestionar la familia de secretos, los almacenes y las claves estén dentro del ámbito del compartimento correcto.
Despliegue bloqueado en estado de creación o con fallos
En la página de detalles del despliegue, cambie al separador Work Requests y revise los mensajes en busca de errores. Las causas comunes incluyen:
-
Discrepancia de zona: la zona de disponibilidad lógica no coincide con el anclaje de red. Vuelva a crear el anclaje de red con la zona correcta y, a continuación, vuelva a crear el despliegue.
-
Se ha alcanzado la cuota del equilibrador de carga: utilice la barra de búsqueda de OCI para buscar límites, cuotas y uso; a continuación, filtre por ORACLEDBATAZURE y solicite un aumento si es necesario.
-
Secreto de almacén o clave inaccesible: confirme que el secreto y la clave están en el mismo compartimento que el despliegue o que existen políticas entre compartimentos.
Despliegue no visible en Azure Portal
Se seleccionó una suscripción distinta de ORACLEDBATAZURE durante la creación. Suprima el despliegue y vuelva a crearlo con la suscripción correcta.
Contraseña de texto sin formato rechazada
La Contraseña debe tener al menos 8 caracteres e incluir una letra mayúscula, una letra minúscula, un número y un carácter especial. No debe contener el nombre de usuario.
No se puede acceder al secreto de almacén
Confirme que el estado del secreto es Activo. En el menú de navegación de Oracle Cloud, seleccione Identity & Security y, a continuación, Secret Management. No se pueden utilizar secretos pendientes de supresión.
La conexión no ha podido acceder a la base de datos
Confirme que el puerto de base de datos necesario esté abierto tanto en el NSG de Azure como en la lista de seguridad de OCI en la subred asignada a anclaje de red. Si utiliza un nombre de host, verifique que la resolución de DNS esté configurada según la documentación de Resolución de DNS para anclajes de red vinculada en la tarea 1, paso 2.
Transformaciones de datos
El despliegue de Data Transforms no realiza copias de seguridad de conexiones genéricas
Las conexiones genéricas que se asignan a despliegues de Data Transforms no se incluyen en el proceso de copia de seguridad.
El despliegue de transformaciones de datos restauradas elimina los juegos de datos delta
Se perderán los juegos de datos de transformaciones de datos creados durante y después de la restauración de un despliegue de transformaciones de datos.
Pipelines
Explore los problemas conocidos relacionados con los pipelines y cómo solucionarlos.
Las conexiones de base de datos de IA autónoma con Autonomous Data Guard activado no están soportadas actualmente
Las conexiones de base de datos de IA autónoma activadas para Autonomous Data Guard no están soportadas actualmente en los pipelines de OCI GoldenGate.
Solución alternativa: desactive Autonomous Data Guard (ADG) o utilice una base de datos de IA autónoma diferente. Refresque la conexión si ha desactivado ADG para actualizar la cadena de conexión utilizada por OCI GoldenGate.
Oracle Data Pump falla si la versión del archivo de zona horaria de la base de datos destino es inferior a la de la base de datos origen
La opción de pipeline, "Copy existing data to target database before Starting replication", utiliza Oracle Data Pump. Oracle Data Pump falla si la versión del archivo de zona horaria de la base de datos destino es inferior a la de la base de datos origen.
Solución alternativa: para solucionar este problema, debe actualizar la versión de zona horaria de la base de datos de destino. Consulte Gestión de actualizaciones de archivos de zona horaria en Autonomous AI Database.