Diagnostica problemas en las migraciones de Oracle a Cloud SQL para PostgreSQL

En esta página, se enumeran los errores conocidos y los pasos recomendados para solucionar problemas relacionados con lo siguiente:

Errores del trabajo de migración

Es posible que el proceso del trabajo de migración genere errores durante el tiempo de ejecución.

  • Algunos errores, como una contraseña incorrecta en la base de datos de origen, se pueden recuperar. El trabajo de migración se reanuda automáticamente después de que se corrigen estos errores.
  • Algunos errores son irrecuperables, como los errores en la replicación de datos. Debes reiniciar el trabajo de migración después de corregir estos errores.

Cuando se produce un error, el estado del trabajo de migración cambia a Failed, y el subestado refleja el último estado antes de la falla. Para solucionar un error, navega al trabajo de migración fallido para ver el error y sigue los pasos que se indican en el mensaje de error. Para ver más detalles sobre el error, navega a Cloud Monitoring a través del vínculo en el trabajo de migración. Los registros se filtran según el trabajo de migración específico.

En la siguiente tabla, encontrarás algunos ejemplos de problemas y cómo se pueden resolver:

Síntoma Causas posibles Solución
Mensaje de error: Database Migration Service can't set up a tunnel to be connected to the bastion host. Database Migration Service no pudo acceder al host de bastión o este no acepta conexiones. Verifica la configuración del túnel SSH de reenvío en el perfil de conexión de origen y la configuración del servidor de túnel SSH y, luego, vuelve a intentarlo.
Mensaje de error: Database Migration Service can't connect to the database o Database Migration Service private connectivity error, cannot connect to the database. Database Migration Service no pudo establecer la conectividad con la base de datos de Oracle de origen.

Verifica que puedas acceder a la base de datos de origen desde tu proyecto. Verifica la configuración relacionada con tu método de configuración de conectividad de la fuente.

Si se incluye un código de error específico de Oracle, por ejemplo, ORA-12170: TNS:Connect timeout occurred, consulta la documentación de Oracle para obtener más información.

Mensaje de error: Archiving mode is not ARCHIVELOG. Tu base de datos de origen no se ejecuta en el modo ARCHIVELOG. Configura tu base de datos de origen para que use el modo ARCHIVELOG. Para obtener más información, consulta Configura tu base de datos de Oracle de origen.
Mensaje de error: Supplemental logging ("ALL COLUMN LOGGING") isn't turned on for the tables listed below. Tu base de datos de origen no tiene habilitados los datos de registro complementarios. Habilita los datos de registros complementarios y establece su modo en ALL. Para obtener más información, consulta Configura tu base de datos de Oracle de origen.
Mensaje de error: No Archive Log Files were found in the source. Database Migration Service solo lee los registros de archivo cerrados, y no se encontraron registros en la base de datos de origen.
  1. Ejecuta el siguiente comando en la base de datos de origen para cerrar el archivo de registro actual: ALTER SYSTEM SWITCH LOGFILE.
  2. Intenta encontrar los registros de nuevo.

Si la base de datos no tiene operaciones de escritura activas, es posible que debas realizar al menos una operación de INSERT para activar la creación del registro.

Mensaje de error: We're missing the necessary permissions to read from the source. La cuenta de usuario de migración en tu base de datos de origen no tiene los permisos necesarios.

Database Migration Service se conecta a tu origen como la cuenta de usuario que configuras en el perfil de conexión de origen. Esa cuenta necesita un conjunto específico de permisos (por ejemplo, SELECT ANY TABLE) para leer datos en tu base de datos de origen.

Asegúrate de que la cuenta de usuario de migración tenga los privilegios necesarios. Para obtener más información, consulta Configura tu base de datos de Oracle de origen.

Mensaje de error: Unable to connect to the destination database. Se produjo un problema al conectarse a la base de datos de destino. Verifica que puedes acceder a la base de datos de destino desde tu proyecto. Verifica la configuración relacionada con tu método de configuración de conectividad de destino.
Mensaje de error: The following tables don't exist in the destination database: {table_names}. Las tablas que se enumeran y que intentas migrar no existen en la base de datos de destino. Database Migration Service crea la tabla y las definiciones necesarias cuando conviertes tu esquema de origen.
Mensaje de error: password authentication failed for user {username}. El nombre de usuario o la contraseña de la base de datos de destino están mal configurados. Asegúrate de que el perfil de conexión de PostgreSQL de destino esté configurado correctamente con el nombre de usuario y la contraseña correctos.
Mensaje de error: The following tables in the destination database don't have primary keys: {table_names}. Las tablas que se indican en el mensaje de error existen en la base de datos de destino, pero no tienen claves primarias.

Los lugares de trabajo de conversión de Database Migration Service agregan automáticamente claves primarias para las tablas que no las tienen cuando conviertes el esquema.

Si utilizas espacios de trabajo de conversión heredados, deberás crear las claves principales de forma manual en tu destino. Para obtener más información, consulta Espacios de trabajo de conversión heredados.

Advertencia: The following tables have foreign keys: {table_names}. Las tablas que se indican en el mensaje de error existen en la base de datos de destino, pero tienen claves externas.

Database Migration Service no replica los datos de forma transaccional, por lo que es posible que las tablas se migren en un orden incorrecto. Si hay claves externas y se migra una tabla secundaria que usa una clave externa antes que su tabla principal, es posible que se produzcan errores de replicación.

Para evitar estos problemas de integridad de los datos, omite las claves externas con la opción REPLICATION para el usuario de migración. Para obtener más información, consulta Consideraciones sobre claves externas y activadores.

Mensaje de error: Unable to resume replication as log position is lost. Este error puede ocurrir cuando el proceso de replicación se pausa durante mucho tiempo, lo que provoca la pérdida de la posición del registro. Un trabajo de migración no debe detenerse por más tiempo (o cerca) del período de retención de registros. Si se pierde la posición de registro, debes volver a crear el trabajo de migración.
Mensaje de error: ORA-00942: table or view does not exist. Este error puede ocurrir como resultado del almacenamiento en caché en el servidor de Oracle. Vuelve a crear el usuario de la base de datos para solucionar el problema de almacenamiento en caché.
El trabajo de migración permanece en la fase de volcado completo y no avanza a la fase de captura de datos modificados (CDC). Database Migration Service aún está realizando el volcado completo de algunas de las tablas, o bien una o más de las tablas no pueden finalizar el volcado completo debido a errores.
  • Verifica los errores del trabajo de migración y corrige los que se apliquen a las tablas o quita las tablas asociadas del trabajo.
  • Verifica los registros de Database Migration Service para detectar actividad de volcado completo en curso y espera a que finalice.

Problemas de conectividad

En esta sección, se enumeran y describen los pasos para solucionar posibles problemas de conectividad de red.

No se puede conectar a la base de datos de destino: EOF

Cuando se ejecuta una prueba de conectividad, se muestra el mensaje de error [DATABASE] unable to connect to the destination database: EOF.

Posible causa: El adjunto de servicio está configurado de forma incorrecta.

Sugerencias: Asegúrate de que enable_proxy_protocol esté establecido en false en el archivo de configuración de Terraform de la vinculación del servicio. El protocolo de proxy solo se admite para servidores HTTP, como NGINX y Apache.

Cuando se usa gcloud para crear la configuración de Private Service Connect, el protocolo de proxy está inhabilitado de forma predeterminada.

Se agotó el tiempo de espera de la conexión o se rechazó la conexión

Falla o se agota el tiempo de espera de la prueba de conectividad. Lo más probable es que esto se deba a una configuración incorrecta del enrutamiento en la configuración de Private Service Connect. Este problema puede deberse a varios motivos.

Causa posible: Falta una regla de firewall que permita que el rango de CIDR de NAT de Private Service Connect acceda a la subred de Private Service Connect en la que se encuentra el host de bastión, específicamente la interfaz nic0 de la VM del host de bastión.

Sugerencias: Asegúrate de que tu política de la organización no restrinja las reglas de firewall internas, como la regla de firewall psc_sp_in_fw definida en el ejemplo de secuencia de comandos de Terraform para configurar la conectividad de IP privada de destino para instancias de Cloud SQL no habilitadas para PSC.

Causa posible: El proxy no funciona. No hay un objeto de escucha en el puerto proporcionado y, por lo tanto, la conexión se bloquea.

Sugerencias: Puedes intentar establecer una conexión SSH a la VM de bastión y buscar el proxy con el siguiente comando:

  • netstat -tunalp | grep PORT

Analiza las respuestas al comando:

  • Si obtienes una respuesta vacía, significa que el proxy no funciona. Intenta ejecutar los siguientes comandos:

    sudo su; cd / y verifica si el servidor de Dante está instalado ejecutando sudo dpkg -s dante-server:

  • Si el proxy se está ejecutando y escuchando en el puerto proporcionado, intenta abrir una conexión a él de la siguiente manera:

    1. Instala el cliente de PostgreSQL:

      sudo apt-get install postgresql-client

    2. Conéctate a la base de datos de PostgreSQL:

      psql -h 127.0.0.1 -p PORT -U DBUSERNAME -W (se te solicitará que ingreses la contraseña).

      Reemplaza lo siguiente:

      • PORT: Es el número de puerto de la base de datos.
      • DBUSERNAME: Es el nombre de usuario que se usa para conectarse a la base de datos de PostgreSQL.

    3. Instala el cliente de Telnet:

      sudo apt-get install telnet

    4. Conéctate al cliente de Telnet:

      telnet 127.0.0.1 PORT

      Reemplaza PORT por el número de puerto de la base de datos.

    Según los resultados de los comandos, haz lo siguiente:

    • Si los comandos no logran abrir una conexión, intenta consultar los registros del proxy para ubicar la causa raíz. La causa raíz puede variar según la configuración de la instancia de Cloud SQL.

    • Si la conexión se abre con Telnet, pero se cuelga en el cliente, es probable que el problema sea el enrutamiento de la dirección IP del host de bastión. En tu VM, escribe ip route en la terminal. Comprueba si puedes ubicar una regla de enrutamiento que dirija las conexiones a la dirección IP privada de la instancia de Cloud SQL con el nic secundario (nic1, la dirección IP de DB_SUBNETWORK_GATEWAY).

Causa posible: El adjunto de servicio no acepta la conexión de extremo proveniente de Database Migration Service. El adjunto de servicio contiene una lista de proyectos aceptados, y el proyecto de Database Migration Service no está incluido en la lista.

Qué puedes probar: Para resolver el problema, prueba una de las siguientes opciones:

  • En la Google Cloud consola, ve a Private Service Connect.

    Ir a Private Service Connect

    En la pestaña Servicios publicados, acepta la conexión de Database Migration Service para tu adjunto de servicio (si está pendiente).

  • Agrega el proyecto solicitante a la lista de proyectos permitidos en el adjunto de servicio (si se rechaza).

    Si el problema persiste, vuelve a crear el perfil de conexión.

  • Borra el perfil de conexión asociado con la conectividad de Private Service Connect y vuelve a crearlo.

Soluciona problemas relacionados con errores de Oracle SCAN

En esta sección, se describen los posibles problemas que puedes tener cuando migras desde fuentes de Oracle Real Application Clusters (RAC) con la función de nombre de acceso de cliente único (SCAN).

No se puede establecer la conectividad con una base de datos de Oracle SCAN

Falla o se agota el tiempo de espera de la prueba de conectividad.

Posible causa: Es posible que estés intentando establecer conectividad directamente con tu base de datos de origen de Oracle SCAN. Database Migration Service no admite la conectividad directa a bases de datos con la función SCAN en entornos de Oracle RAC.

Qué puedes probar: Para resolver el problema, prueba una de las siguientes opciones:

  • Conéctate directamente a uno de los nodos.

  • Usa el Oracle Connection Manager.

  • Crea una configuración de conectividad privada con una solución de proxy inverso, como HAProxy.