Promuovere un job di migrazione

Per le migrazioni continue, puoi avviare il processo di promozione quando è il momento di spostare le letture e le scritture nei database di destinazione. La promozione significa che i database Cloud SQL di cui è stata eseguita la migrazione diventano ora accessibili per tutte le operazioni di lettura e scrittura.

Puoi promuovere un job di migrazione o promuovere i database selezionati da un job di migrazione.

1. Avvia la promozione. Per evitare la perdita di dati, assicurati di interrompere tutte le scritture, gli script in esecuzione e le connessioni client al database di origine. Il periodo di inattività inizia qui.
2. Assicurati che tutti i dati disponibili dai file di log delle transazioni vengano replicati nell'istanza di destinazione Cloud SQL per SQL Server.

   Origini Cloud SQL per SQL Server

   Per le origini Cloud SQL per SQL Server, Database Migration Service gestisce automaticamente il monitoraggio delle esportazioni dei log delle transazioni. Non devi eseguire altre azioni dopo aver interrotto le scritture sull'istanza di origine. Puoi procedere con la promozione del job di migrazione.

   Origini autogestite o Amazon RDS

   Per le origini autogestite o Amazon RDS, puoi ottenere questo risultato eseguendo una delle seguenti azioni:

   • Interrompi i caricamenti automatici dei file di backup, o carica l'ultimo file di log delle transazioni. Monitora le dimensioni dei backup dei log delle transazioni non elaborate per determinare quando Database Migration Service termina l'elaborazione del file.
   • (Facoltativo) Puoi caricare un file di log delle transazioni il cui nome termina con .trn.final suffisso. Database Migration Service interrompe i caricamenti continui quando rileva un file di backup il cui nome corrisponde alla .trn.final convenzione di suffisso.

     Quando Database Migration Service termina l'elaborazione del file, lo stato del job di migrazione cambia in Pronto per la promozione.

3. Esegui l'azione di promozione:

   Console

   1. Nella Google Cloud console, vai alla pagina Job di migrazione.

      Vai ai job di migrazione

   2. Nella scheda Job, fai clic sul nome visualizzato del job di migrazione che vuoi promuovere.

   Viene visualizzata la pagina dei dettagli del job di migrazione.

   3. Esegui una delle seguenti azioni di promozione:

      • Se vuoi promuovere tutti i database inclusi nella migrazione, fai clic su Promuovi nella barra degli strumenti del job di migrazione.

        Viene visualizzata la finestra di dialogo Promuovi job di migrazione.

      • Se vuoi promuovere solo database specifici, selezionali utilizzando le caselle di controllo accanto ai nomi dei database e fai clic su Promuovi nella scheda Database.

        Viene visualizzata la finestra di dialogo con il numero di database che vuoi promuovere.

   4. Nella finestra di dialogo, assicurati che non vengano visualizzati errori, quindi fai clic su Promuovi.

   gcloud

   Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

   • MIGRATION_JOB_ID con l'identificatore del job di migrazione.

     Se non conosci l'identificatore, puoi utilizzare il gcloud database-migration migration-jobs list comando per elencare tutti i job di migrazione in una determinata regione e visualizzarne gli identificatori.

   • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.

   • (Facoltativo) Per impostazione predefinita, Database Migration Service esegue la migrazione di tutti i database nell'origine. Se vuoi eseguire la migrazione solo di database specifici, utilizza il flag --databases-filter e specifica i relativi identificatori come elenco separato da virgole.

     Ad esempio: --databases-filter=my-business-database,my-other-database

     Puoi modificare in un secondo momento i job di migrazione creati con il --database-filter flag utilizzando il gcloud database-migration migration-jobs update comando.

   Esegui questo comando:

   Linux, macOS o Cloud Shell

   Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; o gcloud auth login e gcloud config set project.

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

   Windows (PowerShell)

   Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; o gcloud auth login e gcloud config set project.

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

   Windows (cmd.exe)

   Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; o gcloud auth login e gcloud config set project.

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

   Risultato

   L'azione viene eseguita in modo asincrono. Di conseguenza, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione:

   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
   

   Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto dell'operazione restituito o controllare lo stato del job di migrazione:

   • Utilizza il comando gcloud database-migration migration-jobs describe per visualizzare lo stato del job di migrazione.
   • Utilizza il gcloud database-migration operations describe con il OPERATION_ID per visualizzare lo stato dell'operazione stessa.
4. L'istanza di destinazione o i database selezionati vengono promossi e i database di cui è stata eseguita la migrazione sono ora accessibili per tutte le operazioni di lettura e scrittura. Lo stato del job di migrazione diventa Completed.
5. L'applicazione può ora essere connessa all'istanza Cloud SQL e il job di migrazione può essere eliminato in sicurezza.