Migra cargas de trabajo de Oracle a Cloud SQL 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 Cloud SQL 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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 usas una base de datos de Oracle independiente en un entorno en el que puedes 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.

También suponemos que deseas migrar tus cargas de trabajo de Oracle a una base de datos de destino de Cloud SQL para PostgreSQL.

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

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 Oracle de origen a la instancia de base de datos de Cloud SQL para PostgreSQL de destino.

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 Cloud SQL 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.

      Los perfiles de conexión, como todos los recursos, se guardan en una región, y un trabajo de migración o un lugar de trabajo de conversión solo pueden usar perfiles de conexión almacenados en la misma región. La selección de la región no influye en si Database Migration Service puede conectarse a la fuente, pero puede afectar la conectividad al destino y la disponibilidad si la región experimenta tiempo de inactividad. Esta opción es permanente y no se puede cambiar.

   4. Ingresa el Nombre de host o dirección 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. Haz clic en CONTINUAR.

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

   El uso de listas de IP permitidas es una función de seguridad que se usa a menudo para controlar y limitar el acceso a los datos en tus bases de datos de origen y destino solo a los usuarios de confianza. Puedes usar las listas de IP permitidas para crear listas de direcciones IP o rangos de IP de confianza desde los que tus usuarios pueden acceder a estos datos. Además, para usar las listas de IP permitidas, debes abrir la base de datos o firewall de origen para las conexiones entrantes desde las direcciones IP públicas de Database Migration Service de la región que especificaste para este perfil de conexión.

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

9. Haz clic en CREAR.

Crea un perfil de conexión de Cloud SQL para PostgreSQL

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

4. En la lista Motor de base de datos, selecciona Cloud SQL para PostgreSQL (porque deseas crear un perfil de conexión para una base de datos de destino de Cloud SQL 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 Cloud SQL para PostgreSQL, como My Cloud SQL 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 la instancia de Cloud SQL para PostgreSQL que deseas usar como base de datos de destino de la migración.

   5. Ingresa el Nombre de host o dirección IP (dominio o IP) y el Puerto para acceder a la base de datos de destino. (el puerto predeterminado de Cloud SQL para PostgreSQL es 5432).

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

      El Nombre de usuario es el nombre del usuario de Database Migration Service que creaste para la base de datos de destino (por ejemplo, postgres).

      Para obtener más información sobre cómo crear este usuario, consulta Configura tu base de datos de destino de Cloud SQL para PostgreSQL.

6. Haz clic en CONTINUAR.

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

8. En el menú desplegable 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.

   Para esta guía de inicio rápido, selecciona IP pública como el método de conectividad porque usas este perfil de conexión para migrar datos de un tipo de base de datos de origen diferente, como Oracle.

   Este método funciona si configuraste tu instancia de Cloud SQL para PostgreSQL de destino para que acepte conexiones a través de una dirección IP pública. Para obtener más información sobre cómo habilitar conexiones a través de una dirección IP pública, consulta Configura una IP pública.

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. Haz clic en CREAR ESPACIO DE TRABAJO.

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 desplegable Motor de base de datos de origen se completa automáticamente con Oracle.

   5. En la lista desplegable Motor de base de datos de destino, selecciona Cloud SQL 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:

   • Crea un perfil de conexión a la base de datos de Oracle de origen

   • Configura tu base de datos de Oracle de origen para que el espacio de trabajo de conversión pueda recuperar datos de ella.

   • (Opcional) Usa la herramienta de migración de Ora2Pg para crear asignaciones adicionales para el editor del espacio de trabajo de conversión.

5. Haz clic en CREAR ESPACIO DE TRABAJO Y CONTINUAR.

Conéctate a la fuente y convierte objetos

1. Abre la lista desplegable 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 Cloud SQL para PostgreSQL de destino.

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 TAREA 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 base de datos de destino, selecciona Cloud SQL 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 Cloud SQL 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 el menú desplegable 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 el menú desplegable Destination connection profile, 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 desplegable 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 CREATE & START JOB para crear el trabajo de migración y comenzarlo de inmediato.

4. Haz clic en CREAR Y COMENZAR en el siguiente cuadro de diálogo.

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 base de datos de Cloud SQL para PostgreSQL de destino.

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 Cloud SQL para PostgreSQL de destino.

   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 la instancia 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 instancia de destino de Cloud SQL 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 Cloud SQL para PostgreSQL de destino y borrar el trabajo de migración de forma segura.

Tu instancia de base de datos de Cloud SQL 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 Cloud SQL para PostgreSQL y proyecto si no los necesitas.

¿Qué sigue?

• Obtén más información para administrar perfiles de conexión.
• Obtén más información para administrar los lugares de trabajo de conversión.
• Obtén más información sobre los estados de los trabajos de migración.