Cómo diagnosticar problemas en las migraciones de Oracle a AlloyDB para PostgreSQL

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

Errores de trabajos de migración

El proceso del trabajo de migración puede generar 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 que se corrijan 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 problemas, navega al trabajo de migración con errores 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 con el vínculo del trabajo de migración. Los registros se filtran según el trabajo de migración específico.

En la siguiente tabla, puedes encontrar algunos ejemplos de problemas y cómo resolverlos:

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 reenvío por túnel SSH en el perfil de conexión de origen y la configuración del servidor del túnel SSH, y 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 origen.

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 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 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 fuente 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 cuando se intentaba establecer conexión con la base de datos de destino. Verifica que puedas 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 de la lista que intentas migrar no existen en la base de datos de destino. Database Migration Service crea la tabla y las definiciones necesarias cuando conviertes el 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 adecuados.
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 espacios 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 usas espacios de trabajo de conversión heredados, debes crear las claves primarias 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 las tablas se pueden migrar sin un orden específico. Si hay claves externas presentes y se migra una tabla secundaria que usa una clave externa antes que su tabla superior, 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 las claves externas y los 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 pausarse por más tiempo que el período de retención de registros (o cerca de él). Si se pierde la posición del 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 un volcado completo para algunas de las tablas, o 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 errores que se aplican a las tablas o quita las tablas asociadas del trabajo.
  • Verifica los registros de Database Migration Service para ver la actividad de volcado completo en curso y espera hasta 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 establecer conexión con la base de datos de destino: EOF

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

Causa posible: El adjunto de servicio está configurado de forma incorrecta.

Qué puedes probar: Asegúrate de que enable_proxy_protocol esté configurado como false en el archivo de configuración de Terraform del adjunto de servicio. El protocolo de proxy solo es compatible con servidores HTTP, como NGINX y Apache.

Cuando usas gcloud para crear la configuración de Private Service Connect, el protocolo de proxy se inhabilita de forma predeterminada.

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

La ejecución de la prueba de conectividad falla o se agota el tiempo de espera. Lo más probable es que esto se deba a un enrutamiento mal configurado 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 CIDR de NAT de Private Service Connect acceda a la subred de Private Service Connect en la que se encuentra el bastión, específicamente la interfaz nic0 de la VM de bastión.

Qué puedes probar: Asegúrate de que la política de la organización no restrinja las reglas de firewall internas, como la regla de firewall psc_sp_in_fw definida en la secuencia de comandos de Terraform de ejemplo para configurar la conectividad de IP privada de destino para las instancias de AlloyDB para PostgreSQL no habilitadas para PSC.

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

Qué puedes probar: 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, el proxy está inactivo. Intenta ejecutar los siguientes comandos:

    sudo su; cd / y verifica si el servidor 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 abren una conexión, intenta consultar los registros del proxy para encontrar la causa raíz. La causa raíz puede variar según la configuración de la instancia de AlloyDB para PostgreSQL.

    • Si la conexión se abre con telnet, pero se bloquea en el cliente, es probable que el problema sea el enrutamiento de la dirección IP del bastión. En la VM, escribe ip route en la terminal. Verifica si puedes encontrar una regla de enrutamiento que enrute las conexiones a la dirección IP privada de la instancia de AlloyDB para PostgreSQL con el nic secundario (nic1, la dirección IP de DB_SUBNETWORK_GATEWAY).

Causa posible: El adjunto de servicio no acepta la conexión del extremo que proviene de Database Migration Service. El adjunto de servicio contiene una lista de proyectos que se aceptan, y el proyecto de Database Migration Service no se incluye en la lista.

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

  • En la consola de Google Cloud , 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 esto no resuelve el problema, 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 con los errores de SCAN de Oracle

En esta sección, se describen los posibles problemas que podrías tener cuando migres 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

La ejecución de la prueba de conectividad falla o se agota el tiempo de espera.

Causa posible: 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:

  • Conectarte 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.