Cómo migrar una base de datos a AlloyDB para PostgreSQL con Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL a AlloyDB

En esta guía de inicio rápido, se muestra cómo usar Database Migration Service para migrar datos 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.

   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 y métodos de conectividad. Las diferentes fuentes 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 PostgreSQL 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 en las instalaciones 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.

En esta guía de inicio rápido, seleccionarás PostgreSQL para el motor de base de datos de origen, AlloyDB para PostgreSQL para el motor de base de datos de destino y intercambio de tráfico entre VPC como método de red.

Crear un perfil de conexión fuente

Cuando creas un perfil de conexión, estás creando un registro que contiene información sobre la base de datos de origen. Database Migration Service usa la información del perfil de conexión para migrar datos de tu base de datos de origen a la instancia de base de datos de AlloyDB 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. 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 uno de los siguientes tipos de clasificación de tu base de datos de origen:

   • Una instancia independiente de PostgreSQL (PostgreSQL)
   • Una instancia existente de Cloud SQL para PostgreSQL (Cloud SQL para PostgreSQL)
   • Una instancia de Amazon RDS para PostgreSQL (Amazon RDS para PostgreSQL)

   Para esta guía de inicio rápido, selecciona PostgreSQL.

4. Proporciona la siguiente información:
   • En el campo Nombre del perfil de conexión, ingresa un nombre para el perfil de conexión de tu base de datos de origen, como My Connection Profile.
   • Conserva el ID del perfil de conexión generado automáticamente.
   • Ingresa la información de conectividad:
     • Si realizas la replicación desde una base de datos alojada por ti, ingresa el Nombre de host o dirección IP (dominio o IP) y el Puerto para acceder al host. (El puerto predeterminado de PostgreSQL es 5432).
     • Si realizas la replicación desde una base de datos de Cloud SQL, selecciona la instancia de Cloud SQL en la lista desplegable.
   • Ingresa un Nombre de usuario y una Contraseña para autenticar tu instancia de origen.

5. En la sección Región del perfil de conexión de la página, selecciona la región en la que deseas guardar el perfil de conexión.

   Los perfiles de conexión, como todos los recursos, se guardan en una región. La selección de una región no afecta qué trabajos de migración pueden usarlos o qué regiones pueden conectarse a la ubicación de los datos en sí, pero sí puede afectar la disponibilidad en caso de que se produzca un tiempo de inactividad regional.

6. Haz clic en CREAR.

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 AlloyDB de destino.

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

• Define la configuración del trabajo
• Selecciona el perfil de conexión que creaste para tu base de datos de origen (perfil de conexión fuente).
• Define la configuración de la instancia de base de datos de AlloyDB de destino
• Configura la conectividad entre las instancias de base de datos de origen y de destino
• 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. Abre la lista desplegable Motor de la base de datos de origen y selecciona el tipo de clasificación de tu base de datos de origen. En esta guía de inicio rápido, selecciona AlloyDB para PostgreSQL.

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

7. Establece el Tipo de trabajo de migración en "Continuo" porque deseas que los cambios en curso en tu base de datos de origen se migren a la instancia de base de datos de AlloyDB 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. 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 Cómo configurar tu fuente.

9. Haz clic en GUARDAR Y CONTINUAR.

Especifica la información sobre el perfil de conexión de origen

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

2. Haz clic en GUARDAR Y CONTINUAR.

Crea un clúster de AlloyDB de destino

Los clústeres son el recurso de nivel superior en AlloyDB. Para crear un clúster de destino, sigue estos pasos:

1. Elige un tipo de clúster. Actualmente, Database Migration Service admite clústeres de AlloyDB de alta disponibilidad. Pueden entregar datos de más de una zona en una región, sin grupos de lectura.
2. Haz clic en CONTINUAR.
3. Configura tu clúster:
   1. En el campo ID de clúster, ingresa un ID para tu clúster.
   2. En el campo Contraseña, ingresa una contraseña para el usuario postgres predeterminado. Necesitarás la contraseña para acceder a tu base de datos.
   3. En el campo Red, selecciona una ruta de red para definir qué recursos están disponibles cuando se configura la conectividad de migración. Los clústeres solo se pueden configurar con una ruta de red de IP privada. Si planeas conectarte a la base de datos de origen mediante el intercambio de tráfico entre VPC, selecciona la VPC en la que reside.
   4. De manera opcional, selecciona un nombre de rango de IP asignado para especificar las direcciones IP con las que se puede conectar tu instancia.
   5. Haz clic en CONTINUAR.
4. Configura tu instancia principal. Una instancia principal determina la capacidad de procesamiento de un clúster y admite operaciones de lectura y escritura:
1. En el campo ID de instancia, ingresa un ID para tu instancia principal.
2. Selecciona un tipo de máquina.
3. Opcional: Establece marcas para tu instancia. Puedes usar marcas para personalizar tu instancia. Para obtener información sobre las marcas compatibles, consulta la documentación de AlloyDB. Para cada marca, haz lo siguiente:
   1. Haz clic en AGREGAR MARCA.
   2. Selecciona una marca de la lista Nueva marca de base de datos.
   3. Proporciona un valor para la marca.
   4. Haz clic en LISTO.
5. Haz clic en GUARDAR Y CONTINUAR.
6. Haz clic en CREAR DESTINO Y CONTINUAR para confirmar tu elección.
7. Espera a que termine de crearse la instancia de destino.

Tu clúster de AlloyDB estará en un estado de "Inicio" mientras Database Migration Service lo administra. Mientras esté en "Inicialización", no podrás realizar ninguna operación en el clúster. Si aún deseas borrar el clúster, puedes hacerlo con gcloud y la opción --force.

Configura la conectividad

1. Elige el método de red que deseas usar para establecer la conectividad entre las bases de datos de origen y de destino. En esta guía de inicio rápido, usa la lista Método de conectividad para seleccionar Intercambio de tráfico entre VPC como el método de red.
2. Revisa la red de VPC de tu base de datos de origen. Haz clic en CONFIGURAR Y CONTINUAR para completar la configuración del perfil de conexión.

Configura las bases de datos de migración

Puedes seleccionar las bases de datos que deseas migrar.

1. En la lista Bases de datos para migrar, selecciona Todas las bases de datos.

   Se seleccionan todas las bases de datos que existen en la fuente para la migración.

2. 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 TEST JOB para verificar que la fuente se haya configurado de forma correcta, que las instancias de origen y destino puedan comunicarse entre sí y que el trabajo de migración sea válido.

3. Verifica que veas el estado “Las pruebas se aprobaron correctamente”.

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

4. Haz clic en CREATE & START JOB para crear el trabajo de migración y comenzarlo de inmediato.

5. Haz clic en START en el siguiente cuadro de diálogo.

6. 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 destino de AlloyDB.

1. Ve a la página Clústeres de AlloyDB en la consola de Google Cloud.

   Ve a la página Clústeres de AlloyDB

2. Haz clic en la entrada de réplica de lectura de tu trabajo de migración.
3. Haz clic en el ícono Activar Cloud Shell que aparece en la región superior derecha de la página.
4. En el mensaje de Cloud Shell, presiona Intro.
5. Opcional: Si aparece un cuadro de diálogo Autorizar Cloud Shell, haz clic en Autorizar.
6. En el mensaje Ingresar contraseña, ingresa la contraseña que proporcionaste o que Database Migration Service generó en Define y crea la instancia de destino de AlloyDB.

7. En el cuadro de postgres, ingresa \list para enumerar las bases de datos y verificar que veas la instancia de base de datos de origen.
8. En el prompt de postgres, ingresa \connect SOURCE_DB_NAME porque quieres ver las tablas asociadas con esta instancia de base de datos. El nombre del mensaje cambia de postgres a SOURCE_DB_NAME.
9. En la instrucción SOURCE_DB_NAME, ingresa \dt para ver las tablas de esta instancia.
10. En la solicitud SOURCE_DB_NAME, ingresa GRANT alloydbexternalsync to USER; porque quieres otorgarle permiso a este usuario para acceder a los datos en las tablas de esta instancia.

    Reemplaza USER por el nombre del usuario que usaste para conectarte a la instancia de base de datos de destino.

11. En el mensaje SOURCE_DB_NAME, ingresa SELECT * from TABLE_NAME; para ver la información que se replica desde una tabla en tu instancia de base de datos de origen.
12. Verifica que veas la información correcta en la tabla.

Esto confirma que Database Migration Service migró los datos.

Promociona el trabajo de migración

Ya está todo listo para ascender el trabajo de migración. Como resultado, la instancia de base de datos de AlloyDB de destino reemplaza a la instancia de base de datos de origen como la base de datos principal.

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

2. Haz clic en el trabajo de migración que deseas ascender. Aparecerá la página Detalles del trabajo de migración.

3. Espera a que el retraso de replicación tienda a cero.

4. Detén todas las operaciones de escritura en la base de datos de origen.

   Debes detener todas las operaciones de escritura en la base de datos de origen porque, cuando promocionas el trabajo de migración, la base de datos de destino de AlloyDB se convierte en tu base de datos principal.

5. Espera hasta que la demora de replicación sea cero.

6. Haz clic en el trabajo de migración que deseas ascender. Este trabajo debe tener el estado "Running".

7. Haz clic en PROMOVER para ascender el trabajo de migración.

8. Vuelve a hacer clic en PROMOVER en el siguiente cuadro de diálogo.

9. Verifica que el trabajo de migración tenga el estado “Promoción en curso”. Después de unos minutos, confirma que el estado cambie a "Completado".

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

Limpia

Para evitar que se apliquen cargos a tu Google Cloud cuenta por los recursos que usaste en esta página, sigue estos pasos.

1. Usa la consola de Google Cloud para borrar tu trabajo de migración, perfil de conexión, clúster de AlloyDB 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 sobre los estados de los trabajos de migración.
• Obtén más información sobre las métricas de los trabajos de migración.