Migra cargas de trabajo de Oracle a AlloyDB para PostgreSQL con Database Migration Service

En esta guía de inicio rápido, se muestra cómo usar Database Migration Service para migrar cargas de trabajo de Oracle a AlloyDB para PostgreSQL. Los recursos creados en esta guía de inicio rápido suelen costar menos de un dólar, bajo la suposición de que completas los pasos, incluida la limpieza, de manera oportuna.

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Enable the Database Migration Service API.

    Enable the API

  7. Asegúrate de tener asignada el rol de administrador de Database Migration a tu cuenta de usuario.

    Ir a la página IAM

Requisitos

Database Migration Service ofrece una variedad de opciones de bases de datos de origen, de destino y de métodos de conectividad. Las diferentes fuentes y destinos funcionan mejor con algunos métodos de conectividad que con otros.

En esta guía de inicio rápido, suponemos que tienes lo siguiente:

  • Usa una base de datos independiente de Oracle en un entorno en el que puedas configurar tu red para agregar una regla de firewall entrante. La base de datos de origen puede estar ubicada localmente o en un proveedor de servicios en la nube. Debido a que no podemos saber los detalles de tu entorno, no podemos proporcionar pasos detallados cuando se trata de tu configuración de red.

  • ¿Quieres migrar tus cargas de trabajo de Oracle a una base de datos de destino de AlloyDB para PostgreSQL?

  • Usa el método de conectividad IP privada. Este tipo de conectividad requiere que crees una configuración de conectividad privada para tu base de datos de destino de AlloyDB para PostgreSQL.

Crear perfiles de conexión

Cuando creas perfiles de conexión, estás creando registros que contienen información sobre las bases de datos de origen y destino. Database Migration Service usa la información de los perfiles de conexión para migrar datos de tu base de datos de origen de Oracle a la instancia de base de datos de destino de AlloyDB para PostgreSQL.

En esta sección, aprenderás a crear perfiles de conexión a:

  • Una base de datos de Oracle de origen
  • Una base de datos de destino de AlloyDB para PostgreSQL

Crea un perfil de conexión de Oracle

  1. Ve a la página Perfiles de conexión de Database Migration Service en la consola de Google Cloud .

    Ve a la página Perfiles de conexión del servicio de migración de bases de datos

  2. Haz clic en CREAR PERFIL.

  3. En la página Crear un perfil de conexión, en la lista Rol del perfil, selecciona Fuente.

  4. En la lista Motor de base de datos, selecciona Oracle.

  5. Proporciona la siguiente información:

    1. En el campo Nombre del perfil de conexión, ingresa un nombre para el perfil de conexión de tu base de datos de Oracle de origen, como My Oracle Connection Profile.

    2. Conserva el ID del perfil de conexión generado automáticamente.

    3. Selecciona la Región en la que se almacena el perfil de conexión.

    4. Ingresa el Nombre de host o IP (dominio o IP) y el Puerto para acceder a la base de datos de Oracle de origen. (El puerto predeterminado de Oracle es 1521).

    5. Ingresa un Nombre de usuario y una Contraseña para autenticar tu base de datos de origen.

    6. En el campo Nombre del servicio, ingresa el servicio que garantiza que la base de datos de Oracle de origen esté protegida y supervisada. En el caso de las bases de datos de Oracle, el servicio de base de datos suele ser ORCL.

  6. Haga clic en Continuar.

  7. En la sección Protege tu conexión, haz clic en Continuar.

  8. En la lista Método de conectividad, selecciona un método de conectividad de red. Este método define cómo se conectará Database Migration Service a la base de datos de Oracle de origen.

    Para esta guía de inicio rápido, selecciona Lista de IP permitidas como el método de red.

  9. Haz clic en Ejecutar prueba para verificar que Database Migration Service pueda comunicarse con la fuente.

    Si la prueba falla, indica qué parte del proceso tuvo un problema. Se pueden realizar los cambios necesarios y, luego, volver a realizar la prueba en la página Crear un perfil de conexión.

    Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.

  10. Haz clic en Crear.

Crea un perfil de conexión de destino

  1. Ve a la página Perfiles de conexión de Database Migration Service en la consola de Google Cloud .

    Ve a la página Perfiles de conexión del servicio de migración de bases de datos

  2. Haga clic en Crear perfil.

  3. En la página Crear un perfil de conexión, en la lista Rol del perfil, selecciona Destino.

  4. En la lista Motor de base de datos, selecciona AlloyDB para PostgreSQL.

  5. Proporciona la siguiente información:

    1. En el campo Nombre del perfil de conexión, ingresa un nombre para el perfil de conexión de tu base de datos de destino de AlloyDB para PostgreSQL, como My AlloyDB for PostgreSQL Connection Profile.

    2. Conserva el ID del perfil de conexión generado automáticamente.

    3. Selecciona la Región en la que se almacena el perfil de conexión.

    4. Selecciona el clúster de AlloyDB para PostgreSQL que deseas usar como base de datos de destino de la migración.

    5. Ingresa el Nombre de host o IP (dominio o IP) y el Puerto para acceder a la base de datos de destino. (El puerto predeterminado de AlloyDB para PostgreSQL es 5432).

    6. Ingresa un Nombre de usuario y una Contraseña para autenticarte en la base de datos de destino.

  6. Haga clic en Continuar.

  7. En la sección Protege tu conexión, haz clic en Continuar.

  8. En el menú Método de conectividad, selecciona el método de conectividad IP privada.

    El método de conectividad define cómo se conecta Database Migration Service a la base de datos de destino de AlloyDB para PostgreSQL. La IP privada requiere que primero crees una configuración de conectividad privada.

  9. Haz clic en Ejecutar prueba para verificar que Database Migration Service pueda comunicarse con la base de datos de destino.

    Si la prueba falla, indica qué parte del proceso tuvo un problema. Se pueden realizar los cambios necesarios y, luego, volver a realizar la prueba en la página Crear un perfil de conexión.

    Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.

  10. Haz clic en Crear.

Crea un lugar de trabajo de conversión

Los lugares de trabajo de conversión te ayudan a convertir el esquema y los objetos de la base de datos de origen en un formato compatible con la base de datos de destino. Esta conversión permite que Database Migration Service migre tus datos entre las bases de datos de origen y de destino.

Para crear un lugar de trabajo de conversión, sigue estos pasos:

  • Define la configuración del espacio de trabajo de conversión.
  • Conéctate a la base de datos de origen y extrae la información de tu esquema en Database Migration Service.

  • Realiza conversiones automáticas con ajustes opcionales mediante lo siguiente:

    • Editor del lugar de trabajo de conversión: Un espacio de editor en vivo en el que puedes modificar el SQL que se usa para las conversiones
    • Archivos de configuración de Ora2Pg para proporcionar asignaciones de conversión adicionales

  • Aplica el esquema convertido a tu base de datos de destino: Database Migration Service usa el SQL generado para crear todas las entidades requeridas en tu base de datos de destino para garantizar que los datos de migración se puedan cargar correctamente en la base de datos.

Define la configuración del espacio de trabajo de conversión

  1. Ve a la página Workspaces de conversión de Database Migration Service en la consola de Google Cloud .

    Ir a la página Lugares de trabajo de conversión de Database Migration Service

  2. Haga clic en Create workspace.

  3. Proporciona la siguiente información:

    1. En el campo Nombre del lugar de trabajo de conversión, ingresa un nombre para el lugar de trabajo de conversión, como My Conversion Workspace.

    2. Conserva el ID del lugar de trabajo de conversión generado automáticamente.

    3. Selecciona la región en la que se almacena el lugar de trabajo de conversión.

    4. La lista Motor de base de datos de origen se completa automáticamente con Oracle.

    5. En la lista Motor de la base de datos de destino, selecciona AlloyDB para PostgreSQL.

  4. Revisa los requisitos previos necesarios que se generan automáticamente para reflejar cómo se debe preparar el entorno para un lugar de trabajo de conversiones. Estos requisitos previos incluyen lo siguiente:

  5. Haz clic en Crear lugar de trabajo y continuar.

Conéctate a la fuente y convierte objetos

  1. Abre la lista Perfil de conexión de origen y selecciona el perfil de conexión que creaste.

  2. Haz clic en Ejecutar prueba para verificar que Database Migration Service pueda comunicarse con la fuente.

    Si una prueba falla, indica qué parte del proceso tuvo un problema. Se pueden realizar los cambios necesarios y, luego, volver a realizar la prueba.

    Navega a la parte del flujo en cuestión para corregir el problema y, luego, vuelve a realizar la prueba.

  3. Haz clic en Extraer el esquema y continuar.

    Database Migration Service comienza a conectarse a tu base de datos de origen para descargar información del esquema. Esta operación puede tardar unos minutos, según factores como la conectividad de red o el tamaño de la base de datos.

    Después de que Database Migration Service termine de extraer la información del esquema, se abrirá la sección Seleccionar y convertir objetos.

  4. Usa la vista de árbol del esquema para seleccionar todas las entidades que deseas que Database Migration Service convierta en un esquema compatible con el motor de SQL de tu base de datos de destino.

  5. Haz clic en Convertir y continuar.

    Database Migration Service crea tu lugar de trabajo de conversión y realiza la conversión del esquema. Ahora puedes obtener una vista previa del SQL generado automáticamente en el editor del espacio de trabajo de conversiones.

Aplicar al destino

Cuando se convierta el esquema que deseas usar en la base de datos de destino, usa la opción Aplicar a destino para ejecutar las instrucciones de SQL generadas en la base de datos de destino:

  1. Haz clic en Aplicar a destino y selecciona una de las siguientes opciones:

    • Prueba (recomendado): Esta operación realiza una ejecución de prueba para verificar si se puede crear correctamente tu esquema en la base de datos de destino.
    • Aplicar: Esta operación intenta crear el esquema convertido en la base de datos de destino.

  2. En la sección Definir destino, selecciona el perfil de conexión que apunta a tu base de datos de destino.

  3. Haz clic en Definir y continuar.

  4. En la sección Revisar objetos y aplicar conversión al destino, selecciona los esquemas de las entidades de la base de datos que deseas crear en tu base de datos de destino.

  5. Haz clic en Aplicar al destino.

Crea trabajos de migración

Database Migration Service usa trabajos de migración para migrar datos de tu instancia de base de datos de origen a la instancia de base de datos de destino de AlloyDB para PostgreSQL.

La creación de un trabajo de migración incluye lo siguiente:

  • Define la configuración del trabajo
  • Especifica la información sobre el perfil de conexión que creaste para tu base de datos de origen (perfil de conexión de origen)
  • Especifica la información sobre el perfil de conexión que creaste para tu base de datos de destino (perfil de conexión de destino)
  • Configura los objetos que deseas migrar desde la base de datos de origen
  • Probar el trabajo de migración para asegurarte de que la información de conexión que proporcionaste para el trabajo sea válida

Define la configuración del trabajo de migración

  1. Ve a la página Trabajos de migración de Database Migration Service en la consola de Google Cloud .

    Ir a la página Trabajos de migración de Database Migration Service

  2. Haz clic en Crear trabajos de migración.

  3. En el campo Nombre del trabajo de migración, ingresa un nombre para el trabajo de migración, como My Migration Job.

  4. Conserva el ID del trabajo de migración generado automáticamente.

  5. En el menú Motor de base de datos de origen, selecciona Oracle.

  6. En el menú Motor de la base de datos de destino, selecciona AlloyDB para PostgreSQL.

  7. Selecciona la región en la que se creará la instancia de destino.

  8. Revisa los requisitos previos necesarios que se generan de forma automática para reflejar cómo se debe preparar el entorno para un trabajo de migración. Estos requisitos previos pueden incluir cómo configurar la base de datos de origen y cómo conectarla a la instancia de base de datos de destino de AlloyDB para PostgreSQL. Es mejor completar estos requisitos previos en este paso, pero puedes completarlos en cualquier momento antes de probar o iniciar el trabajo de migración. Para obtener más información sobre estos requisitos previos, consulta Configura tu base de datos de Oracle de origen.

  9. Haz clic en Guardar y continuar.

Define la configuración de la fuente

En la página Define tu fuente, haz lo siguiente:

  1. En la lista Perfil de conexión de origen, selecciona el perfil de conexión de origen para tu instancia de Oracle.
  2. Haz clic en Guardar y continuar.
  3. (Opcional) En la sección Probar perfil de conexión, haz clic en Ejecutar prueba para verificar si Database Migration Service puede establecer una conexión de red con tu instancia de origen.

    Puedes crear el trabajo de migración incluso si falla la prueba de conexión, pero debes corregir cualquier problema de conectividad antes de ejecutarlo.

  4. En la sección Customize source configuration, configura los siguientes parámetros:
    • En la sección Configuración de volcado completo, selecciona Automático.
    • En la Configuración de lectura de la fuente, usa los valores predeterminados de simultaneidad sugeridos.
  5. Haz clic en Guardar y continuar.

Define la configuración de destino

En la página Define tu destino, haz lo siguiente:

  1. En la lista Perfil de conexión de destino, selecciona el perfil de conexión de destino.
  2. Haz clic en Guardar y continuar.
  3. (Opcional) En la sección Probar perfil de conexión, haz clic en Ejecutar prueba para verificar si Database Migration Service puede establecer una conexión de red con tu destino.

    Puedes crear el trabajo de migración incluso si falla la prueba de conexión, pero debes corregir cualquier problema de conectividad antes de ejecutarlo.

  4. En la sección Customize destination configuration, configura lo siguiente:
    • En la sección Máximo de conexiones de destino simultáneas, usa los valores predeterminados de simultaneidad sugeridos.
    • En la sección Tiempo de espera de la transacción, usa los valores predeterminados de tiempo de espera sugeridos.
  5. Haz clic en Guardar y continuar.

Selecciona los objetos que quieras migrar

  1. Selecciona tu lugar de trabajo de conversión en la lista Lugar de trabajo de conversión.

    Después de seleccionar un lugar de trabajo de conversión, en la región Seleccionar objetos para migrar de la página, se enumeran todos los objetos (esquemas y tablas) de la base de datos de origen de Oracle que se pueden migrar al destino.

  2. Selecciona los objetos de base de datos de la lista que deseas que Database Migration Service migre.

  3. Haz clic en Guardar y continuar.

Prueba y crea el trabajo de migración

  1. Revisa la configuración que elegiste para el trabajo de migración.

  2. Haz clic en Probar trabajo para verificar lo siguiente:

    • La fuente se configuró según los requisitos previos.

    • Database Migration Service puede conectarse a la fuente.

    • Database Migration Service puede conectarse al destino.

    • El trabajo de migración es válido y las versiones de origen y destino son compatibles.

    Si la prueba falla, puedes abordar el problema en la parte adecuada del flujo y volver a realizar la prueba.

  3. Haz clic en Crear y comenzar trabajo para crear el trabajo de migración y comenzarlo de inmediato.

  4. Haz clic en Crear y comenzar en el cuadro de diálogo que aparece a continuación.

  5. En la página Trabajos de migración, verifica que el trabajo de migración tenga el estado "Iniciando". Después de unos minutos, confirma que el estado cambie a "Running".

Verifica el trabajo de migración

En esta sección, confirmas que Database Migration Service usó el trabajo de migración para migrar datos de tu instancia de base de datos de origen a la instancia de destino de AlloyDB para PostgreSQL.

Realiza la verificación con la Herramienta de validación de datos

Existe una herramienta de validación de datos de código abierto que puedes usar para validar con mayor precisión que los datos coincidan entre la fuente y el destino.

En los siguientes pasos, se muestra un ejemplo mínimo para ejecutar validaciones más exactas:

  1. Implementa o usa una máquina virtual con acceso a la fuente y al destino.

  2. En la máquina virtual, crea una carpeta en la que instalar la herramienta de validación de datos.

  3. Navega a esta carpeta.

  4. Usa pip para instalar la Herramienta de validación de datos.

    pip install google-pso-data-validator

  5. Crea conexiones con la base de datos de Oracle de origen y la base de datos de destino de AlloyDB para PostgreSQL.

    data-validation connections add -c source Oracle --host 'ip-address' --port port --user username --password pswd --database database-name
data-validation connections add -c target Postgres --host 'ip-address' --port port --user username --password pswd --database database-name

    Por ejemplo:

    data-validation connections add -c source Oracle --host '10.10.10.11' --port 1521 --user system --password pswd --database XE
data-validation connections add -c target Postgres --host '10.10.10.12' --port 5432 --user postgres --password pswd --database postgres

  6. Crea o genera una lista de tablas para comparar los datos entre las bases de datos de origen y de destino.

    export TABLES_LIST=$(data-validation find-tables --source-conn target --target-conn target --allowed-schemas schema-name)

    Por ejemplo:

    export TABLES_LIST=$(data-validation find-tables --source-conn target --target-conn target --allowed-schemas public)

  7. Ejecuta la validación completa en todas las tablas.

    data-validation validate column --source-conn source --target-conn target --tables-list "${TABLES_LIST}"

Te sugerimos que ejecutes esta validación durante la replicación para garantizar la coherencia relativa. Las consultas de tablas grandes pueden tardar demasiado en ejecutarse durante un período de promoción pequeño. En esos casos, usa la herramienta de validación de datos para agregar filtros que reduzcan el tiempo de ejecución o prepara la lista de tablas para incluir un subconjunto de tablas para la validación final.

Esto confirma que Database Migration Service migró los datos.

Finaliza la migración

Para las migraciones continuas, finaliza el trabajo de migración cuando quieras comenzar a usar el clúster de destino para tu aplicación.

Puedes usar el botón Promote en la página de detalles del trabajo de migración para que Database Migration Service borre todos los datos de migración temporales y promocione tu destino.

  1. Regresa a la página Trabajos de migración.

  2. Haz clic en el trabajo de migración que creaste en esta guía de inicio rápido. Esto representa la migración que deseas finalizar. Aparecerá la página Detalles del trabajo de migración.

  3. Usa la Herramienta de validación de datos para hacer un seguimiento de la demora de replicación. Para ello, verifica los recuentos de filas.

    Espera a que la demora de replicación disminuya significativamente, idealmente en cuestión de minutos o segundos. La demora de replicación está disponible para su revisión en la página Trabajos de migración.

  4. Después de que el retraso en la replicación sea mínimo, inicia la migración. Para evitar la pérdida de datos, asegúrate de hacer lo siguiente:

    1. Detén todas las escrituras, las secuencias de comandos en ejecución y las conexiones de clientes a la base de datos de origen. Aquí comienza el período de tiempo de descanso.

    2. Espera hasta que la demora de replicación sea cero, lo que significa que la tarea de migración procesó todos los cambios pendientes.

    Puedes finalizar una migración incluso si la demora de replicación no es cero. Esto puede reducir el tiempo de inactividad de la base de datos, pero puede afectar la exactitud de los datos en el destino.

    1. En la página de detalles del trabajo de migración, haz clic en Promover y, luego, confirma la acción en la ventana ¿Deseas promover el trabajo de migración?.

    El trabajo de migración deja de leer de tu base de datos de origen. Database Migration Service promociona tu destino de AlloyDB para PostgreSQL para limpiar todos los datos de migración temporales. Este proceso puede tardar varios minutos.

  5. Cuando se completa el proceso de promoción, el estado del trabajo de migración cambia a Completado.

  6. Ahora puedes conectar tu aplicación a la instancia de destino de AlloyDB para PostgreSQL y borrar el trabajo de migración de forma segura.

Tu instancia de base de datos de AlloyDB para PostgreSQL está lista para usarse.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

  1. Usa la consola de Google Cloud para borrar tu trabajo de migración, espacio de trabajo de conversión, perfiles de conexión, instancia de destino de AlloyDB para PostgreSQL y proyecto si no los necesitas.

¿Qué sigue?