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 mover las operaciones de lectura y escritura a las bases de datos de destino. La promoción significa que ahora se puede acceder a las bases de datos de Cloud SQL migradas para todas las operaciones de lectura y escritura.

Puedes ascender un trabajo de migración o 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 operaciones de escritura, las secuencias de comandos en ejecución y las conexiones de clientes a la base de datos de origen. Aquí comienza el período de tiempo de descanso.
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 automáticas de archivos de copia de seguridad 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 el servicio de migración de bases de datos termina de procesar ese archivo.
   • De manera opcional, puedes subir un archivo de registro de transacciones cuyo nombre finalice en el sufijo .trn.final. El servicio de migración de bases de datos detiene las cargas contínuas cuando detecta un archivo de copia de seguridad cuyo nombre coincide con la convención de sufijo .trn.final.

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

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.

      Ve a Trabajos de migración

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

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

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

      • Si quieres ascender todas las bases de datos incluidas en la migración, haz clic en Ascender en la barra de herramientas del trabajo de migración.

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

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

        Aparecerá el diálogo con varias bases de datos que deseas promocionar.

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

   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 todas las tareas de migración en una región determinada y ver sus identificadores.

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

   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 muestra una entidad de operación 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 que se muestra o verificar el estado de la tarea de migración:

   • Usa el comando gcloud database-migration migration-jobs describe para ver el estado de la tarea de migración.
   • Usa gcloud database-migration operations describe con OPERATION_ID para ver el estado de la operación.
4. Se promocionan 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, la aplicación se puede conectar a la instancia de Cloud SQL y el trabajo de migración se puede borrar de forma segura.