Migra una base de datos a Cloud SQL 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 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 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 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.

En esta guía de inicio rápido, seleccionarás PostgreSQL para el motor de base de datos de origen y IP allowlist como el 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 Cloud SQL 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.
   • (Opcional) Si planeas transferir información sensible a través de una red pública (mediante listas de IP permitidas), te recomendamos que uses la encriptación SSL/TLS para la conexión entre las bases de datos de origen y de destino. De lo contrario, conserva el valor predeterminado de None.

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

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 Cloud SQL 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 la base de datos de Cloud SQL 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.

Define la configuración de la instancia de Cloud SQL de destino

1. Proporciona un ID de instancia de destino para la instancia de Cloud SQL. De forma predeterminada, el ID del trabajo de migración se prepropaga en este campo. Puedes conservar este nombre o ingresar otro.

2. Proporciona una contraseña alfanumérica para la instancia de Cloud SQL de destino. Esta será la contraseña de la cuenta de administrador postgres en la instancia.

   Puedes ingresar la contraseña de forma manual o hacer clic en GENERAR para que Database Migration Service cree una de forma automática.

   Sugerencia: Para ver la contraseña en texto no encriptado, haz clic en el ícono Mostrar. Este ícono tiene forma de ojo.

3. Elige la Versión de la base de datos para la instancia de destino de la lista de versiones compatibles de Cloud SQL para el motor de base de datos especificado.

4. Selecciona la Zona Google Cloud deseada para la instancia nueva de Cloud SQL (o deja como "Cualquier").

5. Selecciona la casilla de verificación IP pública porque, en esta guía de inicio rápido, usarás la lista de IP permitidas como el método de red. Este método funciona configurando el servidor de base de datos de origen para que acepte conexiones desde la dirección IP saliente de la instancia de Cloud SQL.

   Para otros métodos de red, como el túnel SSH inverso, el intercambio de tráfico de VPC o la VPN, selecciona la casilla de verificación IP privada.

6. Selecciona el Tipo de máquina para la instancia de Cloud SQL. El tamaño del disco debe ser igual o mayor que el tamaño de la base de datos de origen.

7. Define el Tipo de almacenamiento y la Capacidad de almacenamiento para la instancia de Cloud SQL.

8. Haz clic en CREAR Y CONTINUAR para crear la instancia nueva.

9. Haz clic en CREATE DESTINATION & CONTINUE en el siguiente cuadro de diálogo. La creación de la instancia puede tardar varios minutos en completarse.

   Importante: En este procedimiento, se crea una instancia de Cloud SQL. Se te cobrará según la configuración que selecciones.
   Nota: Después de crear la instancia de destino, ya no se pueden editar algunos parámetros de configuración del trabajo de migración. No puedes cambiar el motor de base de datos ni el tipo de migración.

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 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 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 la instancia de Cloud SQL de destino.

   Es posible que una dirección IP tarde unos minutos en aparecer en el campo Direcciones IP salientes de destino.

2. Si la dirección IP de origen no se prepropaga en este campo, copia la dirección IP de salida de la instancia de Cloud SQL desde la consola y úsala para configurar el firewall de red del servidor de base de datos de origen para que acepte las conexiones desde esta dirección IP.
   
   1. Actualiza el archivo pg_hba.conf o los grupos de seguridad de Amazon RDS para aceptar conexiones desde esta dirección IP.
   2. En tus reglas de firewall, crea una regla entrante (o de entrada) para permitir conexiones en el puerto 5432 desde la dirección IP de conectividad de la instancia de Cloud SQL de destino.
3. Haz clic en CONFIGURAR Y CONTINUAR para completar la configuración del perfil de conexión.

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

1. Ve a la página Instancias de SQL en la consola de Google Cloud.
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 Google Cloud Shell, presiona Intro.
5. Opcional: Si aparece un cuadro de diálogo Autorizar Cloud Shell, haz clic en Autorizar.
6. Conéctate a la instancia de base de datos de Cloud SQL de destino.
7. En el mensaje Ingresar contraseña, ingresa la contraseña que proporcionaste o que Database Migration Service generó por ti en Define la configuración para la instancia de Cloud SQL de destino.

8. 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.
9. 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.
10. En la instrucción SOURCE_DB_NAME, ingresa \dt para ver las tablas de esta instancia.
11. En la solicitud SOURCE_DB_NAME, ingresa GRANT cloudsqlexternalsync 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.

12. 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.
13. 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 Cloud SQL 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 Cloud SQL de destino 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 Cloud SQL 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, perfil de conexión, instancia de Cloud SQL 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.