Migra a una instancia de destino nueva

En esta página, se describe cómo migrar tus bases de datos a una nueva instancia de Cloud SQL para PostgreSQL que Database Migration Service crea en tu nombre cuando configuras el trabajo de migración. Si tu migración tiene requisitos diferentes, considera seguir un flujo de migración distinto. Para obtener más información, consulta Guía: Migra a una instancia de Cloud SQL existente.

En general, la migración sigue estos pasos:

1. Configurar la base de datos de origen para permitir que Database Migration Service mueva tus datos a las bases de datos nuevas
2. Crea el perfil de conexión de origen y el trabajo de migración.
3. Según la configuración de conectividad, es posible que debas ajustar la configuración del firewall.
4. Inicia y supervisa el trabajo de migración.
5. Ascender el trabajo de migración y mover tu aplicación para que use las bases de datos nuevas

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

• Cloud SQL (consulta Precios de Cloud SQL).
• Si se usa para almacenar claves de encriptación administradas por el cliente (CMEK): Cloud Storage (consulta los precios de Cloud Storage).

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.

Antes de comenzar

1. Verifica si esta ruta de migración puede admitir por completo tu situación. Consulta las siguientes páginas:
   • En Fuentes y destinos compatibles, en la página Descripción general del caso de uso, se enumeran todas las versiones de origen y destino compatibles.
   • En Limitaciones conocidas, se describen los tipos de datos admitidos, los tamaños de las bases de datos y otras limitaciones.

   • Hay diferentes métodos de conectividad de red disponibles para diferentes bases de datos de origen. Considera y planifica tu conectividad de red antes de comenzar los procedimientos de migración. Para obtener más información, consulta Descripción general de las herramientas de redes.

     La migración a una instancia de destino nueva no admite la conectividad de las interfaces de Private Service Connect. Si deseas usar la conectividad de las interfaces de Private Service Connect, considera crear previamente tu instancia de destino directamente en Cloud SQL. Consulta Guía: Migra a una instancia de Cloud SQL existente.

2. Considera en qué región deseas crear la base de datos de destino. Database Migration Service es un producto completamente regional, lo que significa que todas las entidades relacionadas con tu migración (perfiles de conexión de origen y destino, trabajos de migración, bases de datos de destino y espacios de trabajo de conversión) deben guardarse en una sola región.
3. En la consola de Google Cloud , en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud .

   Ir al selector de proyectos

4. Habilita las APIs de Database Migration Service y Cloud SQL Admin.

   Habilita las API

Roles obligatorios

Para obtener los permisos que necesitas para realizar migraciones homogéneas de PostgreSQL con Database Migration Service, pídele a tu administrador que te otorgue los roles de IAM necesarios en tu proyecto:

• Administrador de Database Migration (roles/datamigration.admin)
• Editor de Cloud SQL (roles/cloudsql.editor)
• Usuario de Cloud SQL Studio (roles/cloudsql.studioUser)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso en la documentación de Identity and Access Management.

Estos roles predefinidos contienen los permisos necesarios para realizar migraciones homogéneas de PostgreSQL con Database Migration Service. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para realizar migraciones homogéneas de PostgreSQL con Database Migration Service:

• datamigration.*
• cloudsql.instances.create
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.instances.update
• cloudsql.instances.delete
• cloudsql.operations.get
• cloudsql.users.list
• cloudsql.users.get
• cloudsql.users.create
• cloudsql.users.update
• cloudsql.users.delete

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Prepara tu base de datos de origen

Para preparar tus datos de origen para la migración, sigue estos pasos:

1. Elige y configura el método de conectividad de red de origen.

   Para la conectividad de la lista de entidades permitidas de IP pública: Más adelante, después de que Database Migration Service cree la instancia de destino, es posible que debas agregar la dirección IP pública de Cloud SQL a la lista de entidades permitidas de tu firewall. Consulta con tu administrador de red sobre cómo programar mejor estos cambios de configuración.

2. Configura tu instancia de base de datos de origen. En un nivel alto, esto incluye los siguientes pasos:
   1. Instala la extensión de PostgreSQL pglogical (versión 2.2.1 o posterior) en la base de datos de origen y en todas las bases de datos que se migrarán.
   2. Configura los parámetros de PostgreSQL: establece wal_level = logical y asegúrate de que los valores de max_replication_slots, max_wal_senders y max_worker_processes sean adecuados.
   3. Otorga privilegios de replicación a tu usuario de migración y configura pg_hba.conf para permitir conexiones desde la instancia de Cloud SQL de destino.

   Para obtener instrucciones detalladas, consulta Configura tu base de datos de origen.

3. Crea el perfil de conexión de origen.

Crea y ejecuta el trabajo de migración

Nota: Cuando Database Migration Service crea tu instancia de Cloud SQL de destino, esta no se degrada y no se ejecuta en modo de solo lectura. Sin embargo, debes evitar realizar operaciones de escritura en las tablas o bases de datos incluidas en la migración para evitar conflictos de replicación. Las copias de seguridad automáticas, la recuperación de un momento determinado (PITR) y la creación de réplicas de lectura se suspenden hasta que asciendas el trabajo de migración. Para obtener más información, consulta Limitaciones conocidas.

Para configurar y ejecutar la migración, sigue estos pasos:

1. Opcional: Si deseas administrar tus propias claves de encriptación para la instancia de destino, prepara las claves de encriptación administradas por el cliente (CMEK).
2. Crea y ejecuta el trabajo de migración.

   Puedes supervisar el progreso de la migración y el estado de la instancia de destino con las funciones de observabilidad de Database Migration Service. Consulta Métricas de trabajos de migración.

Finaliza la migración

Cuando decidas cambiar tu aplicación a la nueva instancia de Cloud SQL para PostgreSQL, finaliza la migración con estos pasos:

1. Opcional: Configura réplicas de lectura en cascada. Si quieres usar réplicas de lectura en cascada, puedes configurarlas cuando el trabajo de migración ingrese a la fase de CDC.
2. Detén todas las operaciones de escritura en la base de datos de origen. Puedes cambiarlas al modo de solo lectura para conservar la funcionalidad operativa.
3. Ascender el trabajo de migración.
4. Opcional: Verifica que los datos de la migración estén completos.

¿Qué sigue?

Obtén más información sobre las funciones de Google Cloud para Cloud SQL para PostgreSQL. Consulta Funciones de Cloud SQL para PostgreSQL.