Visualizzare e gestire i job di migrazione

Progetto: /database-migration/docs/sqlserver-to-csql-pgsql/_project.yaml Libro: /database-migration/docs/sqlserver-to-csql-pgsql/_book.yaml

Nella console Google Cloud, puoi eseguire azioni collettive per i job di migrazione che hanno lo stesso stato. Puoi eseguire azioni su un singolo job di migrazione sia nella console Google Cloud sia utilizzando Google Cloud CLI.

Puoi eseguire una delle seguenti azioni sul job di migrazione:

Azione Descrizione
Avvio Avvia i job di migrazione che non sono nello stato In esecuzione o Avvio. Consulta Stati dei job di migrazione.
Interrompi Interrompi un job di migrazione in esecuzione. Lo spostamento dei dati è in pausa. Lo stato del job di migrazione diventa prima Stopping e poi Stopped. Puoi ripristinare, eliminare o promuovere un job di migrazione interrotto.

In alcuni casi, il database di origine deve conservare i dati finché non riprendi il job di migrazione. Il periodo di conservazione del database di origine potrebbe essere limitato. Se il job di migrazione viene messo in pausa per più del periodo di conservazione, e poi viene ripreso, il job di migrazione può non riuscire. In questo caso, elimina o riavvia il job di migrazione.

Riprendi Puoi riprendere i job di migrazione interrotti durante la fase di CDC. Quando riprendi un job di migrazione, Database Migration Service riprende la replica degli eventi di modifica che si accumulano quando il job di migrazione viene interrotto.
Riavvia Puoi riavviare un job di migrazione che ha rilevato un errore e non può procedere con la replica dei dati. Il risultato del riavvio di un job di migrazione dipende dal motivo del mancato completamento:
  • Se la replica non è riuscita a causa di un errore in una o più tabelle del database di origine o di destinazione, il riavvio del job di migrazione cancellerà tutti i dati dalle tabelle del database di destinazione incluse nel job di migrazione.
  • Il riavvio del job di migrazione non comporta la replica delle nuove tabelle create nel database di origine da parte di Database Migration Service. Devi prima aggiungere le tabelle all'area di lavoro di conversione e convertire il relativo schema.
Modifica Vedi Modificare un job di migrazione.
Elimina Un job di migrazione può essere eliminato. Il risultato dipende dallo stato del compito:
  • Se il job di migrazione è nello stato Completed, il record viene eliminato dall'elenco dei job di migrazione.
  • Se il job di migrazione è in un altro stato, è possibile scegliere di eliminare il cluster AlloyDB per PostgreSQL di destinazione associato.
Promuovi Durante il processo di migrazione, il database di destinazione viene impostato su un stato di sola lettura in cui è completamente gestito da Database Migration Service. Quando vuoi passare l'applicazione al database di destinazione sottoposto a migrazione, la promozione del job di migrazione aggiorna il database di destinazione in una replica autonoma. Vedi Promuovere una migrazione.

Revisione di un job di migrazione

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

    Vai a Job di migrazione

  2. Seleziona un job di migrazione per visualizzarne la pagina dei dettagli, che include:
    • Metadati del job di migrazione, ad esempio nome visualizzato, ID, tipo di migrazione, profilo di connessione di origine, motore del database di origine, destinazione, metodo di connettività, data e ora di creazione del job di migrazione e durata dell'esecuzione del job di migrazione.
    • Stato e sottostato del job di migrazione e informazioni aggiuntive. Sono disponibili diverse azioni a seconda dello stato e del sottostato del job di migrazione.

Avviare un job di migrazione

Quando il job di migrazione è stato creato completamente (ovvero non è stato salvato come bozza), puoi avviarlo in qualsiasi momento per iniziare a migrare i dati.

Per avviare un job di migrazione, svolgi i seguenti passaggi:

Console

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

    Vai a Job di migrazione

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

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Avvia.
  4. Nella finestra di dialogo, fai clic su Avvia.

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 comando gcloud database-migration migration-jobs list 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.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
start 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 operazione restituito o controllare lo stato del job di migrazione:

Interrompere un job di migrazione

Puoi interrompere un job di migrazione in esecuzione in qualsiasi momento seguendo questi passaggi:

Console

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

    Vai a Job di migrazione

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

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Arresta.
  4. Nella finestra di dialogo, fai clic su Interrompi.

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 comando gcloud database-migration migration-jobs list 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.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
stop 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: stop
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

Riprendere un job di migrazione

Per riprendere un job di migrazione interrotto, svolgi i seguenti passaggi:

Console

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

    Vai a Job di migrazione

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

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Riprendi.
  4. Nella finestra di dialogo, fai clic su Riprendi.

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 comando gcloud database-migration migration-jobs list 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.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
resume 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: resume
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

Riavviare un job di migrazione

Per avviare un job di migrazione, svolgi i seguenti passaggi:

Console

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

    Vai a Job di migrazione

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

    Viene visualizzata la pagina dei dettagli del job di migrazione.

  3. Fai clic su Restart (Riavvia).
  4. Nella finestra di dialogo, fai clic su Riavvia.

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 comando gcloud database-migration migration-jobs list 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

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

Esegui il seguente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
restart 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: restart
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

Aggiornare una bozza di job di migrazione

Per completare la creazione di un job di migrazione, segui questi passaggi:

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

    Vai a Job di migrazione

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

    Viene visualizzata la procedura guidata per la creazione del job di migrazione.

  3. Completa la creazione del job di migrazione. Vedi Creare un job di migrazione.

Modificare un job di migrazione

Puoi modificare le informazioni di configurazione dell'origine, ad esempio le tabelle e gli schemi del database di origine di cui Database Migration Service eseguirà la migrazione alla destinazione. Database Migration Service utilizza queste informazioni di configurazione per eseguire la migrazione dei dati corretti dall'origine alla destinazione.

Aggiungere o rimuovere oggetti dalla migrazione

Per aggiungere o rimuovere tabelle o schemi dalla migrazione:

  1. Vai alla pagina Job di migrazione nella console Google Cloud.

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione da modificare. Viene visualizzata una pagina di panoramica del job di migrazione.

  3. Nella sezione Seleziona gli oggetti di cui eseguire la migrazione, seleziona o deseleziona le caselle di controllo per modificare le tabelle e gli schemi nell'origine di cui Database Migration Service eseguirà la migrazione nella destinazione.

  4. Fai clic su Salva o Salva e riavvia.

    • Se fai clic su Salva, Database Migration Service sposterà solo i dati storici per gli schemi e le tabelle selezionati.

    • Se fai clic su Salva e riavvia, Database Migration Service avvierà la migrazione dall'inizio, dopo aver ripulito le tabelle selezionate nella destinazione.

Modificare il numero massimo di connessioni simultanee al database di origine

Puoi personalizzare il numero massimo di connessioni contemporaneamente che Database Migration Service può stabilire con l'istanza di origine per la fase di dump completo o la fase di CDC.

  1. Vai alla pagina Job di migrazione nella Google Cloud console.

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione da modificare. Viene visualizzata una pagina di panoramica del job di migrazione.

  3. Espandi la sezione Personalizza la configurazione dell'origine > Impostazioni di lettura dell'origine.

  4. Nelle sezioni Numero massimo di connessioni di dump completo contemporanee o Numero massimo di connessioni CDC contemporanee, utilizza il campo Personalizzato per inserire il limite massimo di connessioni per le fasi di dump completo o CDC.

  5. Fai clic su Salva o Salva e riavvia.

Modificare le impostazioni di configurazione della destinazione

Puoi personalizzare il timeout delle transazioni e il numero massimo di connessioni simultanee per il database di destinazione:

  1. Vai alla pagina Job di migrazione nella console Google Cloud.

    Vai a Job di migrazione

  2. Fai clic sul nome visualizzato del job di migrazione da modificare.

    Viene visualizzata una pagina di panoramica del job di migrazione.

  3. Espandi la sezione Personalizza configurazione della destinazione e modifica le seguenti impostazioni:
    Numero massimo di connessioni contemporanee di destinazione

    Valore predefinito: 128

    Valori consentiti: minimo 2, massimo 256

    Puoi personalizzare il numero massimo di connessioni simultanee che Database Migration Service può effettuare con l'istanza di destinazione.

    Database Migration Service regola il numero di connessioni per garantire le migliori prestazioni nel rispetto del limite di connessioni specificato. L'aumento del limite di connessioni massime può migliorare la velocità della migrazione, ma introduce un carico aggiuntivo sui database di destinazione.

    Timeout transazione

    Valore predefinito: 30

    Valori consentiti: minimo 30, massimo 300

    Durante il processo di migrazione, Database Migration Service può riscontrare determinati problemi che causano il timeout della transazione. Puoi modificare il numero di secondi che Database Migration Service attende prima di annullare la transazione.

    Le transazioni annullate non causano l'errore del job di migrazione. Il job di migrazione continua a copiare i dati, ma passa allo stato In esecuzione con errori. Puoi visualizzare i dettagli del job di migrazione per verificare quali problemi devono essere risolti.

  4. Fai clic su Salva o Salva e riavvia.

Testa un job di migrazione

Prima di eseguire il job di migrazione, puoi eseguire un'operazione di test per verificare se Database Migration Service può raggiungere tutte le entità di origine e di destinazione necessarie. Nella console Google Cloud, puoi testare solo i job di migrazione di bozza che crei nella procedura guidata per la creazione dei job di migrazione (consulta Creare un job di migrazione).

Con l'interfaccia a riga di comando gcloud, puoi testare i job di migrazione creati, ma non ancora avviati.

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 comando gcloud database-migration migration-jobs list 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.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
verify 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: verify
name: OPERATION_ID
Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione: