Cómo ascender un trabajo de migración

En el caso de las migraciones continuas, puedes iniciar el proceso de promoción después de que sea el momento de transferir las lecturas y escrituras a las bases de datos de destino. La promoción significa que las bases de datos de Cloud SQL migradas ahora son accesibles para todas las operaciones de lectura y escritura.

Puedes promover un trabajo de migración o promover bases de datos seleccionadas desde un trabajo de migración.

1. Inicia la promoción. Para evitar la pérdida de datos, asegúrate de detener todas las escrituras, los secuencias de comandos en ejecución y las conexiones de clientes a la base de datos de origen. Aquí comienza el período de inactividad.
2. Asegúrate de que todos los datos disponibles de los archivos de registro de transacciones se repliquen en la instancia de destino de Cloud SQL para SQL Server.

   Para lograr este resultado, puedes realizar una de las siguientes acciones:

   • Detén las cargas de archivos de copias de seguridad automatizadas o sube el último archivo de registro de transacciones. Supervisa el tamaño de las copias de seguridad del registro de transacciones sin procesar para determinar cuándo Database Migration Service termina de procesar ese archivo.
   • De manera opcional, puedes subir un archivo de registro de transacciones cuyo nombre termine con el sufijo .trn.final. Database Migration Service detiene las cargas continuas cuando detecta un archivo de copia de seguridad cuyo nombre coincide con la convención de sufijos .trn.final.

     Cuando Database Migration Service termina de procesar ese archivo, el estado del trabajo de migración cambia a Listo para promover.

3. Realiza la acción de promoción:

   Console

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

      Ir a Trabajos de migración

   2. En la pestaña Trabajos, haz clic en el nombre visible del trabajo de migración que deseas promover.

   Se abrirá la página de detalles del trabajo de migración.

   3. Realiza una de las siguientes acciones de promoción:

      • Si deseas promover todas las bases de datos incluidas en la migración, haz clic en Promote en la barra de herramientas del trabajo de migración.

        Aparecerá el diálogo para promover el trabajo de migración.

      • Si solo deseas promocionar bases de datos específicas, selecciónalas con las casillas de verificación junto a los nombres de las bases de datos y, en la pestaña Bases de datos, haz clic en Promocionar.

        Aparecerá el diálogo con la cantidad de bases de datos que deseas promover.

   4. En el diálogo, asegúrate de que no se muestren errores y, luego, haz clic en Promote.

   gcloud

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

   • MIGRATION_JOB_ID por el identificador de tu trabajo de migración.

     Si no conoces el identificador, puedes usar el comando gcloud database-migration migration-jobs list para enumerar todos los trabajos de migración en una región determinada y ver sus identificadores.

   • REGION con el identificador de la región en la que se guarda tu perfil de conexión.

   • Opcional: De forma predeterminada, Database Migration Service migra todas las bases de datos de tu origen. Si solo deseas 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 --database-filter flag usando el comando gcloud database-migration migration-jobs update.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   gcloud database-migration migration-jobs \
   promote MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

   gcloud database-migration migration-jobs `
   promote MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

   gcloud database-migration migration-jobs ^
   promote MIGRATION_JOB_ID ^
     --region=REGION

   Resultado

   La acción se realiza de forma asíncrona. Por lo tanto, este comando devuelve una entidad Operation que representa una operación de larga duración:

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   Para ver si la operación se realizó correctamente, puedes consultar el objeto de operación devuelto o verificar el estado del trabajo de migración:

   • Usa el comando gcloud database-migration migration-jobs describe para ver el estado del trabajo de migración.
   • Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.
4. Se promueven la instancia de destino o las bases de datos que seleccionaste, y ahora se puede acceder a las bases de datos migradas para todas las operaciones de lectura y escritura. El estado del trabajo de migración cambia a Completed.
5. Ahora se puede conectar la aplicación a la instancia de Cloud SQL y se puede borrar el trabajo de migración de forma segura.