Crea un trabajo de migración a un clúster de destino nuevo

Cuando creas tu clúster de AlloyDB para PostgreSQL de destino con Database Migration Service, ese clúster se aprovisiona como un clúster de AlloyDB para PostgreSQL con una instancia principal. Ejecutar ciertas operaciones durante el proceso de migración puede generar errores de migración. A medida que migras a un clúster de destino nuevo, ten en cuenta las siguientes consideraciones operativas:

  • Evita las operaciones de escritura en los datos que se migran: No realices operaciones de escritura (como INSERT, UPDATE, DELETE o cambios en el esquema de DDL) en el clúster de destino en las tablas o bases de datos incluidas en la migración. Estas operaciones pueden generar conflictos de replicación con los datos que provienen de la fuente.
  • Administra usuarios de la base de datos: Puedes crear y administrar usuarios de la base de datos en cualquier momento con comandos estándar de psql o a través de AlloyDB para PostgreSQL en la consola de Google Cloud . Para obtener más información, consulta Administra usuarios de bases de datos en la documentación de AlloyDB para PostgreSQL.

Para obtener más información, consulta Limitaciones conocidas.

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

  1. Definir la configuración del trabajo de migración.
  2. 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).
  3. Definir la configuración del clúster de AlloyDB para PostgreSQL de destino y crearlo.
  4. Configurar la conectividad entre los entornos de base de datos de origen y de destino.
  5. Probar el trabajo de migración para asegurarte de que la información de conexión que proporcionaste para el trabajo sea válida

Para crear un trabajo de migración a un clúster de destino nuevo, haz lo siguiente:

Console

Define la configuración del trabajo de migración

  1. En la consola de Google Cloud , ve a la página Trabajos de migración.

    Ir a Trabajos de migración

  2. Haz clic en Crear trabajos de migración.

    Se abrirá la página del asistente de configuración del trabajo de migración. Este asistente contiene varios paneles que te guían por cada paso de la configuración.

    Puedes pausar la creación de un trabajo de migración en cualquier momento haciendo clic en Guardar y salir. Todos los datos que ingreses hasta ese punto se guardarán en un trabajo de migración de borrador. Puedes terminar el borrador del trabajo de migración más tarde.

  3. En la página Comenzar, ingresa la siguiente información:
    1. Nombre del trabajo de migración

      Este es un nombre legible por humanos para tu trabajo de migración. Este valor se muestra en la consola de Google Cloud .

    2. ID del trabajo de migración

      Este es un identificador legible por máquinas para tu trabajo de migración. Usa este valor para trabajar con trabajos de migración con los comandos de Google Cloud CLI o la API de Database Migration Service.

    3. En la lista Motor de base de datos de origen, selecciona PostgreSQL.
    4. En la lista Motor de base de datos de destino, selecciona AlloyDB para PostgreSQL.
    5. Selecciona la región en la que guardas el trabajo de migración.

      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 y bases de datos de destino) deben guardarse en una sola región. Selecciona la región según la ubicación de los servicios que necesitan tus datos, como instancias de Compute Engine o apps de App Engine, entre otros. Después de elegir la región de destino, no se puede cambiar esta selección.

    6. Especifica el tipo de trabajo de migración: Continuo (instantánea y cambios en curso). Las migraciones homogéneas de AlloyDB para PostgreSQL solo admiten migraciones continuas.
    7. Revisa los requisitos previos generados para tu entorno. Asegúrate de que tu base de datos de origen esté configurada de forma adecuada. Para obtener más información, consulta Configura la base de datos de origen.
  4. Haz clic en Guardar y continuar.

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

En la página Define una fuente, realiza los siguientes pasos:

  1. En el menú desplegable Perfil de conexión de origen, selecciona el perfil de conexión para tu base de datos de origen (o haz clic en Crear un perfil de conexión; consulta Crea un perfil de conexión de origen).
  2. En la sección Personaliza los parámetros de configuración del paralelismo, haz clic en Mostrar parámetros de configuración del paralelismo.

    Durante el volcado completo inicial, la extensión pglogical replica los datos a nivel de la tabla y no divide una tabla individual no particionada, una partición de hoja ni una tabla sin una clave primaria en varias suscripciones. Esto significa que el paralelismo mejorado del volcado de datos no puede aumentar la velocidad de volcado inicial para una sola tabla grande no particionada, ya que esa tabla se copia dentro de una suscripción. Para obtener más información, consulta Consideraciones sobre el paralelismo del volcado de datos.

    La velocidad del paralelismo de volcado de datos se relaciona con la cantidad de carga inducida en tu base de datos de origen:

    • Óptimo (recomendado): Rendimiento equilibrado con carga óptima en la base de datos de origen. Database Migration Service crea hasta 2 suscripciones por base de datos (hasta 2 en total en todas las bases de datos, con al menos 1 suscripción por base de datos migrada).
    • Máximo: Proporciona las velocidades de volcado más altas, pero puede aumentar la carga en la base de datos de origen. Database Migration Service crea hasta 4 suscripciones por base de datos (hasta 4 en total en todas las bases de datos, con al menos 1 suscripción por base de datos migrada).
    • Mínimo: Toma la menor cantidad de recursos de procesamiento en la base de datos de origen, pero puede tener una capacidad de procesamiento de volcado más lenta. Database Migration Service crea 1 suscripción por base de datos.

    Si eliges la configuración de paralelismo de volcado de datos ajustada, asegúrate de aumentar los parámetros max_replication_slots, max_wal_senders y max_worker_processes en tu base de datos de origen.

  3. Haz clic en Guardar y continuar.

Configura y crea el clúster de destino de AlloyDB para PostgreSQL

Ahora, crearás un nuevo clúster de destino de AlloyDB para PostgreSQL para tu trabajo de migración. Los clústeres son los recursos de nivel superior en AlloyDB para PostgreSQL. Contienen una sola instancia principal para el acceso de lectura y escritura a la base de datos que creas durante el proceso de migración.

  1. En la página Define un destino, en el menú desplegable Tipo de instancia de destino, selecciona Clúster nuevo.
  2. Elige un tipo de clúster. Database Migration Service admite clústeres de AlloyDB para PostgreSQL de alta disponibilidad, que pueden entregar datos de más de una zona en una región, sin grupos de lectura durante el aprovisionamiento inicial.
  3. Haz clic en Continuar.
  4. Configura tu clúster:
    1. En el campo ID del clúster, ingresa un identificador para el clúster de AlloyDB para PostgreSQL o usa el identificador generado de forma automática.

      No incluyas información sensible ni de identificación personal en el identificador. No es necesario que incluyas el ID del proyecto en el nombre del clúster. Esto se hace de manera automática cuando es apropiado.

    2. En el campo Contraseña, proporciona una contraseña alfanumérica para el clúster de AlloyDB para PostgreSQL de destino. Esta es la contraseña de la cuenta de administrador postgres en el clúster.

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

    3. En el menú desplegable Versión de la base de datos, elige la versión de la base de datos para el clúster de destino.

      Obtén más información sobre la compatibilidad con la migración entre versiones.

    4. En el campo Red, haz lo siguiente:
      1. Selecciona una ruta de red para definir qué recursos están disponibles cuando se configure la conectividad de migración. Los clústeres se configuran con una ruta de red de IP privada. Si planeas conectarte a la base de datos de origen con el intercambio de tráfico entre VPC, selecciona la VPC en la que reside.
      2. Si tu red no está configurada para el acceso privado a servicios, haz clic en Configurar conexión y sigue el asistente de configuración de la conexión.
      3. Si nunca se configuró una red de servicios administrados para la VPC seleccionada, puedes elegir un rango de IP y hacer clic en Conectar o usar un rango de IP seleccionado automáticamente y hacer clic en Asignar y conectar.
    5. Opcional: Configura las opciones de encriptación de datos para tu clúster de destino.

      Expande esta sección para ver los pasos opcionales.

      Haz clic en Mostrar opciones avanzadas para especificar si quieres administrar la encriptación de los datos que se migran de la fuente al destino. De forma predeterminada, tus datos se encriptan con una clave administrada por Google Cloud.

      Si quieres administrar la encriptación, puedes usar una clave de encriptación administrada por el cliente (CMEK). La clave debe estar en la misma ubicación que tu clúster de AlloyDB para PostgreSQL. Por ejemplo, los clústeres ubicados en us-west1 solo pueden usar claves en us-west1.

      1. Selecciona el botón de selección Usar una clave de encriptación administrada por el cliente (CMEK).
      2. En el menú Selecciona una clave administrada por el cliente, elige tu CMEK.

      Si no ves la clave, haz clic en Ingresar el nombre del recurso de la clave para proporcionar el nombre del recurso de la clave que quieres usar. Por ejemplo, ingresa projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key en el campo Nombre del recurso de la clave y, luego, haz clic en Guardar.

    6. Haz clic en Continuar.
  5. 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 para la instancia principal.
    3. Si planeas usar el método de conectividad de lista de IP permitidas, selecciona la casilla de verificación Habilitar IP pública saliente.
    4. Configura marcas de base de datos para tu instancia principal (opcional).

      Expande esta sección para ver los pasos opcionales.

      Haz clic en Mostrar opciones avanzadas para establecer marcas de base de datos para tu instancia principal. Para obtener información sobre las marcas compatibles, consulta Configura marcas de base de datos en la documentación de AlloyDB para PostgreSQL. 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.
  6. Haz clic en Guardar y continuar y, luego, confirma tu elección haciendo clic en Crear destino y continuar. Database Migration Service crea tu clúster de AlloyDB para PostgreSQL de destino y su instancia principal. Este proceso puede tardar varios minutos.

Configura la conectividad entre la instancia de base de datos de origen y el clúster de destino

En el menú desplegable Método de conectividad, selecciona un método de conectividad de red. Este método define cómo se conecta el clúster de AlloyDB para PostgreSQL de destino a la base de datos de origen. Los métodos de conectividad de red actuales para migrar a un clúster nuevo incluyen la lista de IPs permitidas, el intercambio de tráfico entre VPC, el túnel SSH inverso y el proxy TCP a través de una VM alojada en la nube.

Si quieres usar…Luego, haz lo siguiente:
El método de conectividad de red de lista de IPs permitidas Copia las dos direcciones IP públicas de salida de la instancia principal del clúster de destino y úsalas para configurar el firewall de red del servidor de la base de datos de origen y en el archivo pg_hba.conf.
El método de conectividad de red de túnel SSH inverso Selecciona la instancia de VM de Compute Engine que alojará el túnel.

Después de especificar la instancia, Google proporciona una secuencia de comandos que realiza los pasos para configurar el túnel entre las bases de datos de origen y de destino. Ejecuta la secuencia de comandos en Google Cloud CLI desde una máquina que tenga conectividad con la base de datos de origen y con Google Cloud.

El método de conectividad de red de intercambio de tráfico de VPC Selecciona la red de VPC en la que reside la base de datos de origen. El clúster de destino se conecta a esta red con el acceso privado a servicios.
El método de conectividad de proxy TCP a través de una VM alojada en la nube Ingresa los detalles requeridos para la nueva instancia de VM de Compute Engine que alojará el proxy TCP.

Después de especificar los detalles, la consola de Google Cloud proporciona una secuencia de comandos que configura el proxy entre las bases de datos de origen y de destino. Ejecuta la secuencia de comandos en una máquina con Google Cloud CLI actualizada.

Después de ejecutar la secuencia de comandos, ingresa la dirección IP privada de la VM recién creada y haz clic en Configurar y continuar.

Después de seleccionar y configurar la conectividad de red, haz clic en Configurar y continuar.

Configura las bases de datos de migración

Puedes migrar todas las bases de datos de tu instancia de origen o elegir solo bases de datos específicas.

  1. En la lista Bases de datos para migrar, selecciona una de las siguientes opciones:
    • Todas las bases de datos: Selecciona todas las bases de datos que existen en la fuente.
    • Bases de datos específicas: Te permite seleccionar bases de datos específicas de todas las bases de datos que existen en la fuente.
  2. Si quieres migrar bases de datos específicas, filtra la lista que aparece y selecciona las bases de datos que quieres que Database Migration Service migre a tu destino.

    Si la lista no aparece y se muestra un error de descubrimiento de la base de datos, haz clic en Volver a cargar. Si falla el descubrimiento de bases de datos, el trabajo migra todas las bases de datos. Puedes continuar con la creación de un trabajo de migración y corregir los errores de conectividad más adelante.

  3. Haz clic en Guardar y continuar.

Prueba, crea y ejecuta el trabajo de migración

En este paso final, revisa el resumen de la configuración del trabajo de migración, la fuente, el destino y el método de conectividad y, luego, prueba la validez de la configuración del trabajo de migración. Si se detecta algún problema, puedes modificar la configuración del trabajo de migración.

  1. En la página Prueba y crea el trabajo de migración, haz clic en Probar trabajo.

    Si la prueba falla, aborda el problema en la parte adecuada del flujo y vuelve a realizar la prueba. Para obtener información sobre cómo solucionar problemas de una prueba de trabajo de migración con errores, consulta Diagnostica problemas de AlloyDB para PostgreSQL.

  2. Cuando finalice la prueba del trabajo de migración, haz clic en Crear y comenzar trabajo para crear el trabajo de migración y comenzarlo de inmediato, o haz clic en Crear trabajo para crear el trabajo de migración sin comenzarlo de inmediato.

    Si el trabajo no se inicia en el momento en que se crea, se puede iniciar desde la página Trabajos de migración haciendo clic en Iniciar. Independientemente de cuándo comience el trabajo de migración, se le cobrará a tu organización por la existencia del clúster de destino.

    Cuando inicias el trabajo de migración, Database Migration Service comienza el volcado completo inicial y la replicación continua. Para obtener más información, consulta Limitaciones conocidas.

  3. Continúa con Revisa el trabajo de migración.

Google Cloud CLI

  1. Crea el perfil de conexión de destino.
    Cuando migras a un clúster de destino nuevo con Google Cloud CLI, creas el clúster de destino y el perfil de conexión en una sola acción.
    Ejecuta el siguiente comando (haz clic en el vínculo para expandir):

    gcloud database-migration connection-profiles create alloydb

    En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

    Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

    • DEST_CONN_ID por el identificador del perfil de conexión de destino.
    • REGION por la región en la que deseas guardar el perfil de conexión y crear el clúster de destino.
    • DEST_PASSWORD por la contraseña inicial del usuario postgres en tu clúster de AlloyDB para PostgreSQL de destino.
    • PRIMARY_ID por el ID de la instancia principal en tu clúster de AlloyDB para PostgreSQL de destino.
    • CPU_COUNT por la cantidad de CPU virtuales de la instancia principal (por ejemplo, 2, 4 o 8).
    • VPC_NETWORK por el nombre o el URI de recurso completo de la red de nube privada virtual configurada para el acceso privado a servicios.
    • Opcional: Para configurar parámetros adicionales para tu nuevo clúster de destino de AlloyDB para PostgreSQL y la instancia principal, puedes pasar las siguientes marcas:
      • --enable-outbound-public-ip: Habilita la IP pública saliente en la instancia principal (obligatorio si usas la conectividad de la lista de IPs permitidas).
      • --kms-key, --kms-keyring y --kms-project: Encripta el clúster de destino con una clave de encriptación administrada por el cliente (CMEK).
      • --database-version: Especifica la versión principal de PostgreSQL para el clúster de destino (por ejemplo, POSTGRES_15).
      • --database-flags: Especifica una lista separada por comas de marcas de base de datos (KEY=VALUE) para la instancia principal de destino.

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID \
      --region=REGION \
      --password=DEST_PASSWORD \
      --primary-id=PRIMARY_ID \
      --cpu-count=CPU_COUNT \
      --network=VPC_NETWORK \
      --no-async

    Windows (PowerShell)

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID `
      --region=REGION `
      --password=DEST_PASSWORD `
      --primary-id=PRIMARY_ID `
      --cpu-count=CPU_COUNT `
      --network=VPC_NETWORK `
      --no-async

    Windows (cmd.exe)

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID ^
      --region=REGION ^
      --password=DEST_PASSWORD ^
      --primary-id=PRIMARY_ID ^
      --cpu-count=CPU_COUNT ^
      --network=VPC_NETWORK ^
      --no-async

    Deberías recibir una respuesta similar a la que figura a continuación:

    Waiting for connection profile [DEST_CONN_ID]
    to be created with [OPERATION_ID]
    
    Waiting for operation [OPERATION_ID] to complete...done.
    
    Created connection profile DEST_CONN_ID [OPERATION_ID]
    
  2. Crea el trabajo de migración.
    Si usas la lista de entidades permitidas de IP, el intercambio de tráfico entre VPC o la conectividad de túnel SSH inverso, asegúrate de agregar las marcas requeridas, como --static-ip, --peer-vpc o --vm, --vm-ip, --vm-port y --vpc. Para obtener más información, consulta Configura la conectividad y Ejemplos de Google Cloud CLI.
    Ejecuta el siguiente comando (haz clic en el vínculo para expandir):

    gcloud database-migration migration-jobs create

    En este ejemplo, se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

    Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

    • MIGRATION_JOB_ID por un identificador legible por máquinas para tu trabajo de migración. Usa este valor para trabajar con trabajos de migración con los comandos de Google Cloud CLI o la API de Database Migration Service.
    • REGION por el identificador de la región en la que deseas guardar el trabajo de migración.
    • MIGRATION_JOB_NAME por un nombre legible por humanos para tu trabajo de migración. Este valor se muestra en Database Migration Service en la consola de Google Cloud .
    • SOURCE_CONNECTION_PROFILE_ID por un identificador legible por máquinas del perfil de conexión de origen. Para obtener más información, consulta Crea un perfil de conexión de origen.
    • DESTINATION_CONNECTION_PROFILE_ID por un identificador legible por máquinas del perfil de conexión de destino.
    • Opcional: Database Migration Service migra todas las bases de datos de tu origen de forma predeterminada. Si solo quieres migrar bases de datos específicas, usa la marca --databases-filter y especifica sus identificadores como una lista separada por comas.

      Por ejemplo: --databases-filter=my-business-database,my-other-database.

      Más adelante, puedes editar los trabajos de migración que creaste con la marca --databases-filter con el comando gcloud database-migration migration-jobs update.

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

    gcloud database-migration migration-jobs \
    create MIGRATION_JOB_ID \
      --no-async \
      --region=REGION \
      --display-name=MIGRATION_JOB_NAME \
      --source=SOURCE_CONNECTION_PROFILE_ID \
      --destination=DESTINATION_CONNECTION_PROFILE_ID \
      --type=CONTINUOUS

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
    create MIGRATION_JOB_ID `
      --no-async `
      --region=REGION `
      --display-name=MIGRATION_JOB_NAME `
      --source=SOURCE_CONNECTION_PROFILE_ID `
      --destination=DESTINATION_CONNECTION_PROFILE_ID `
      --type=CONTINUOUS

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
    create MIGRATION_JOB_ID ^
      --no-async ^
      --region=REGION ^
      --display-name=MIGRATION_JOB_NAME ^
      --source=SOURCE_CONNECTION_PROFILE_ID ^
      --destination=DESTINATION_CONNECTION_PROFILE_ID ^
      --type=CONTINUOUS

    Deberías recibir una respuesta similar a la que figura a continuación:

    Waiting for migration job [MIGRATION_JOB_ID]
    to be created with [OPERATION_ID]
    
    Waiting for operation [OPERATION_ID] to complete...done.
    
    Created migration job MIGRATION_JOB_ID [OPERATION_ID]