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 (USD), bajo la suposición de que completas los pasos, incluida la limpieza, de manera correcta.

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 un entorno local 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 este 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 redes.

Crear un perfil de conexión fuente

Cuando creas un perfil de conexión, creas 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 .

   Ir a la página Perfiles de conexión de Database Migration Service

2. Haz clic en CREAR PERFIL.

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

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

   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 tu cuenta, 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 la región no afecta los trabajos de migración que pueden usar perfiles de conexión o las regiones que pueden conectarse a la ubicación de los datos, 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:

• Cómo definir la configuración del trabajo
• Selecciona el perfil de conexión que creaste para tu base de datos de origen (perfil de conexión de origen).
• Cómo definir la configuración de la instancia de base de datos de AlloyDB de destino
• Configurar 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 Google Cloud consola.

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

2. Haz clic en CREATE MIGRATION JOB.

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 la 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 AlloyDB de destino. 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 con alta disponibilidad. Pueden entregar datos desde 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 del 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 fuente a través del 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 New database flag.
   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 finalice la creación de la instancia de destino.

Tu clúster de AlloyDB estará en estado "Bootstrapping" mientras lo administre Database Migration Service. Mientras se encuentre en "Bootstrapping", no podrás realizar ninguna operación en tu 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 destino. Para 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 fuente. 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 para la migración todas las bases de datos que existen en la fuente.

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 PROBAR TRABAJO para verificar que la fuente se haya configurado correctamente, 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 CREAR Y COMENZAR TRABAJO para crear el trabajo de migración y comenzarlo de inmediato.

5. Haz clic en INICIAR 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, confirmarás 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 AlloyDB de destino.

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

   Ir 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 símbolo del sistema 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ó para ti en Define y crea la instancia de AlloyDB de destino.

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. Cuando se te solicite SOURCE_DB_NAME, ingresa GRANT alloydbexternalsync to USER; porque quieres otorgar 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 símbolo del sistema 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 puedes 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 escrituras 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 "En ejecución".

7. Haz clic en PROMOCIONAR para promocionar el trabajo de migración.

8. Vuelve a hacer clic en PROMOCIONAR 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

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 Google Cloud consola 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.