Creare un job di migrazione in un'istanza di destinazione esistente

MySQL   |  PostgreSQL   |  PostgreSQL ad AlloyDB

Database Migration Service utilizza i job di migrazione per eseguire la migrazione dei dati dall'istanza del database di origine all'istanza del database di destinazione. La creazione di un job di migrazione per un'istanza di destinazione esistente include:

• Definizione delle impostazioni per il job di migrazione
• Selezionare il profilo di connessione del database di origine
• Selezionare l'istanza di database di destinazione esistente
• Retrocedere l'istanza esistente per convertirla in una replica di lettura
• Configurazione della connettività tra le istanze del database di origine e di destinazione
• Test del job di migrazione per verificare che le informazioni di connessione fornite per il job siano valide

Esistono alcune limitazioni da considerare quando vuoi eseguire la migrazione a un'istanza di destinazione creata al di fuori di Database Migration Service. Ad esempio, l'istanza di destinazione Cloud SQL deve essere vuota o contenere solo dati di configurazione del sistema. Per ulteriori informazioni, vedi Limitazioni note.

Definisci le impostazioni per il job di migrazione

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

   Vai a Job di migrazione

2. Fai clic su Crea job di migrazione.

   Si apre la pagina della procedura guidata di configurazione del job di migrazione. Questa procedura guidata contiene più riquadri che ti guidano in ogni passaggio della configurazione.

   Puoi mettere in pausa la creazione di un job di migrazione in qualsiasi momento facendo clic su SALVA ED ESCI. Tutti i dati che inserisci fino a quel punto vengono salvati in una bozza di job di migrazione. Puoi completare la bozza del job di migrazione in un secondo momento.

3. Nella pagina Inizia, inserisci le seguenti informazioni:
   1. Nome job di migrazione

      Un nome leggibile per il job di migrazione. Questo valore viene visualizzato nella console Google Cloud .

   2. ID job di migrazione

      Si tratta di un identificatore leggibile dalla macchina per il job di migrazione. Utilizzi questo valore per lavorare con i job di migrazione utilizzando i comandi o l'API Google Cloud CLI di Database Migration Service.

   3. Dall'elenco Motore del database di origine, seleziona MySQL.

      Il campo Motore del database di destinazione viene compilato automaticamente e non può essere modificato.

   4. Seleziona la regione in cui salvi il job di migrazione.

      Database Migration Service è un prodotto completamente regionale, il che significa che tutte le entità correlate alla migrazione (profili di connessione di origine e di destinazione, job di migrazione, database di destinazione) devono essere salvate in un'unica regione. Seleziona la regione in base alla posizione dei servizi che richiedono i tuoi dati, ad esempio istanze di Compute Engine o app di App Engine e altri servizi. Una volta scelta la regione di destinazione, questa selezione non può essere modificata.

      Importante:se prevedi di utilizzare la versione Cloud SQL per MySQL Enterprise Plus, assicurati che la tua regione sia supportata per questa versione. Consulta Supporto delle regioni di Cloud SQL per MySQL Enterprise Plus.
4. Fai clic su Salva e continua.

Specifica le informazioni sul profilo di connessione di origine

Nella pagina Definisci un'origine, segui questi passaggi:

1. Nel menu a discesa Profilo di connessione di origine, seleziona il profilo di connessione per il tuo database di origine.
2. Nella sezione Personalizza la configurazione del dump completo, fai clic su Modifica configurazione.
3. Nel riquadro Modifica la configurazione del dump completo, seleziona una delle seguenti opzioni dal menu a discesa Metodo di dump completo:
   • Basato su file fisici: seleziona questa opzione se vuoi utilizzare l'utilità Percona XtraBackup per fornire il tuo file di backup. Questo approccio richiede ulteriori passaggi di preparazione. Per la guida completa all'utilizzo dei file di backup fisici generati da Percona XtraBackup, consulta Eseguire la migrazione dei database utilizzando un file fisico Percona XtraBackup.
   • Basato su logica: seleziona questa opzione se vuoi utilizzare un file di backup logico creato dall'utilità mysqldump. Database Migration Service può generare automaticamente questo file di backup per te oppure puoi fornire la tua copia.
4. Modifica le altre impostazioni del dump. Esegui una delle seguenti operazioni:
   • Se utilizzi il file di backup fisico, in Fornisci la cartella fai clic su Sfoglia, quindi seleziona la cartella in cui hai caricato il file di dump completo. Assicurati di selezionare la cartella dedicata che contiene il file di backup completo e non il bucket di archiviazione stesso.

   • Se utilizzi un file di backup logico, configura il parallelismo del dump dei dati o i flag di dump.

     Espandi questa sezione per visualizzare i passaggi completi del file di backup logico

     Nella sezione Scegli come generare il file di dump, utilizza una delle seguenti opzioni:

     1. Generato automaticamente (consigliato)

        Questa opzione è consigliata perché Database Migration Service genera sempre un file di dump del database iniziale dopo la creazione e l'avvio del job di migrazione.

        Database Migration Service utilizza questo file per riprodurre le definizioni degli oggetti originali e i dati delle tabelle del database di origine, in modo che queste informazioni possano essere migrate in un'istanza del database Cloud SQL di destinazione.

        Se utilizzi il dump generato automaticamente, seleziona il tipo di operazione che Database Migration Service deve eseguire nella sezione Configura operazione di dump dei dati:

        • Parallelismo del dump dei dati: utilizza un'opzione di parallelismo ad alte prestazioni, disponibile durante la migrazione alle versioni di MySQL 5.7 o 8.
          Se scegli di utilizzare il parallelismo del dump dei dati, assicurati di fornire i privilegi necessari sul database di origine per il tuo scenario (ad esempio LOCK_TABLES). Per ulteriori informazioni sulle autorizzazioni richieste per i database di origine, vedi Configurare il database di origine.

          La velocità del parallelismo dei dati è correlata alla quantità di carico indotto sul database di origine:

          • Ottimale (consigliato): prestazioni bilanciate con carico ottimale sul database di origine.
          • Massimo: offre le velocità di dump più elevate, ma potrebbe causare un aumento del carico sul database di origine.
          • Minimo: utilizza la quantità minima di risorse di calcolo sul database di origine, ma potrebbe avere una velocità di dump inferiore.
        • Flag di dump: questa opzione è esclusiva di Parallelismo del dump dei dati. Utilizza questa impostazione per configurare direttamente i flag per l'utilità mysqldump utilizzata per creare il file di dump.

          Per aggiungere un indicatore:

          1. Fai clic su AGGIUNGI FLAG.

          2. Seleziona uno dei seguenti flag:

             • add-locks: Questo flag racchiude ogni tabella contenuta nel file di dump con le istruzioni LOCK TABLES e UNLOCK TABLES. Ciò comporta inserimenti più rapidi quando il file di dump viene caricato nell'istanza di destinazione.
             • ignore-error: Utilizza questo flag per inserire un elenco di numeri di errore separati da virgole. Questi numeri rappresentano gli errori che l'utilità mysqldump ignorerà.
             • max-allowed-packet: Utilizza questo flag per impostare la dimensione massima del buffer per la comunicazione tra il client MySQL e il database MySQL di origine. La dimensione predefinita del buffer è 24 MB, mentre la dimensione massima è 1 GB.
               Se utilizzi colonne BLOB di grandi dimensioni o stringhe lunghe nelle tabelle del database di origine, devi aumentare le dimensioni del buffer per questo flag.
             Per ulteriori informazioni su questi flag, consulta la documentazione sull'utilità mysqldump nel manuale di riferimento di MySQL 8.0.
          3. Fai clic su FINE.
          4. Ripeti questi passaggi per ogni flag che vuoi aggiungere.

          Per rimuovere un flag, fai clic sull'icona del cestino a destra della riga che contiene il flag.

     2. Fornire il proprio

        Questa opzione non è consigliata perché per impostazione predefinita Database Migration Service esegue un dump iniziale nell'ambito dell'esecuzione del job di migrazione.

        Se vuoi utilizzare il tuo file di dump, seleziona Fornisci il tuo, fai clic su SFOGLIA, seleziona il file (o l'intera cartella Cloud Storage se utilizzi più file) e poi fai clic su SELEZIONA.

        Assicurati che il dump sia stato generato nelle ultime 24 ore e rispetti i requisiti di dump.

5. Fai clic su Salva e continua.

Seleziona l'istanza Cloud SQL di destinazione

1. Nel menu Tipo di istanza di destinazione, seleziona Istanza esistente.
2. Nella sezione Seleziona istanza di destinazione, seleziona l'istanza di destinazione.
3. Esamina le informazioni nella sezione Dettagli istanza e fai clic su Seleziona e continua.
4. Per eseguire la migrazione a un database di destinazione esistente, Database Migration Service fa retrocedere l'istanza di destinazione e la converte in una replica. Per indicare che il downgrade può essere eseguito in sicurezza, nella finestra di conferma inserisci l'identificatore dell'istanza di destinazione.
5. Fai clic su Conferma e continua.

Configurare la connettività tra le istanze del database di origine e di destinazione

Dal menu a discesa Metodo di connettività, seleziona un metodo di connettività di rete. Questo metodo definisce la modalità di collegamento dell'istanza Cloud SQL appena creata al database di origine. I metodi di connettività di rete attuali includono lista consentita di IP, tunnel SSH inverso, interfacce Private Service Connect e peering VPC.

Se vuoi utilizzare…	Devi…
Il metodo di connettività di rete della lista consentita IP.	Devi specificare l'indirizzo IP in uscita dell'istanza di destinazione. Se l'istanza Cloud SQL che hai creato è un'istanza ad alta disponibilità, includi gli indirizzi IP in uscita sia per l'istanza principale che per quella secondaria.
Il metodo di connettività di rete del tunnel SSH inverso.	Devi selezionare l'istanza VM di Compute Engine che ospiterà il tunnel. Dopo aver specificato l'istanza, Google fornirà uno script che esegue i passaggi per configurare il tunnel tra i database di origine e di destinazione. Dovrai eseguire lo script in Google Cloud CLI. Esegui i comandi da una macchina che ha connettività sia al database di origine sia a Google Cloud.
Il metodo di connettività delle interfacce Private Service Connect,	Database Migration Service stabilisce automaticamente le connessioni richieste. Questo metodo di connettività è disponibile solo se hai l'istanza abilitata per Private Service Connect con un collegamento di rete. Per ulteriori informazioni sulle interfacce Private Service Connect, consulta Connessioni in uscita di Private Service Connect nella documentazione di Cloud SQL.
Il metodo di connettività di rete VPC in peering.	Devi selezionare la rete VPC in cui si trova il database di origine. L'istanza Cloud SQL verrà aggiornata in modo da connettersi a questa rete.

Dopo aver selezionato e configurato la connettività di rete, fai clic su Configura e continua.

Testa, crea ed esegui il job di migrazione

In questo passaggio finale, rivedi il riepilogo delle impostazioni del job di migrazione, dell'origine, della destinazione e del metodo di connettività, quindi verifica la validità della configurazione del job di migrazione. Se si verificano problemi, puoi modificare le impostazioni del job di migrazione. Non tutte le impostazioni sono modificabili.

1. Nella pagina Testa e crea il job di migrazione, fai clic su Testa job.

   Se il test ha esito negativo, puoi risolvere il problema nella parte appropriata del flusso e tornare a eseguire il test. Per informazioni sulla risoluzione dei problemi relativi a un test del job di migrazione non riuscito, vedi Diagnosticare i problemi relativi a MySQL.

2. Al termine del test del job di migrazione, fai clic su Crea e avvia job per creare il job di migrazione e avviarlo immediatamente oppure fai clic su Crea job per creare il job di migrazione senza avviarlo immediatamente.

   Se il job non viene avviato al momento della creazione, può essere avviato dalla pagina Job di migrazione facendo clic su AVVIA. Indipendentemente da quando inizia il job di migrazione, alla tua organizzazione viene addebitato il costo dell'esistenza dell'istanza di destinazione.

   La migrazione è ora in corso. Quando avvii il job di migrazione, Database Migration Service inizia il dump completo, bloccando brevemente il database di origine. Se l'origine si trova in Amazon RDS o Amazon Aurora, Database Migration Service richiede inoltre un breve tempo di inattività in scrittura (circa meno di un minuto) all'inizio della migrazione. Per ulteriori informazioni, vedi Limitazioni note.

   Attenzione:se hai utilizzato Terraform per eseguire il provisioning del database di destinazione, potresti riscontrare una deriva della configurazione durante l'esecuzione del job di migrazione. Non tentare di riapplicare le impostazioni di Terraform prima del completamento della migrazione. Per maggiori informazioni, consulta Deriva della configurazione Terraform.
3. Vai a Rivedi il job di migrazione.

Crea un job di migrazione utilizzando Google Cloud CLI

Quando esegui la migrazione a un'istanza esistente utilizzando Google Cloud CLI, devi creare manualmente il profilo di connessione per l'istanza di destinazione. Non è necessario quando utilizzi la console Google Cloud , in quanto Database Migration Service si occupa della creazione e della rimozione del profilo di connessione di destinazione.

Prima di iniziare

Prima di utilizzare gcloud CLI per creare un job di migrazione in un'istanza di database di destinazione esistente, assicurati di:

• Crea l'istanza del database di destinazione.
• Prepara l'istanza del database di origine. Vedi:
  • Configurare l'origine
  • Crea il profilo di connessione di origine (l'identificatore del profilo di connessione di origine è necessario per creare un job di migrazione).
  • Configurare la connettività

Crea profilo di connessione di destinazione

Crea il profilo di connessione di destinazione per l'istanza di destinazione esistente eseguendo il comando gcloud database-migration connection-profiles create:

Questo esempio utilizza il flag facoltativo --no-async in modo che tutte le operazioni vengano eseguite in modo sincrono. Ciò significa che il completamento di alcuni comandi potrebbe richiedere del tempo. Puoi ignorare il flag --no-async per eseguire i comandi in modo asincrono. In questo caso, devi utilizzare il comando gcloud database-migration operations describe per verificare se l'operazione è riuscita.

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

• CONNECTION_PROFILE_ID con un identificatore leggibile dalla macchina per il tuo profilo di connessione.
• REGION con l'identificatore della regione in cui vuoi salvare il profilo di connessione.
• DESTINATION_INSTANCE_ID con l'identificatore dell'istanza di destinazione.
• (Facoltativo) CONNECTION_PROFILE_NAME con un nome leggibile per il profilo di connessione. Questo valore viene visualizzato nella console Google Cloud .

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 connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

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 connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

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 connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Dovresti ricevere una risposta simile alla seguente:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Crea il job di migrazione

Nota: gli esempi seguenti rappresentano uno scenario di migrazione in cui utilizzi la connettività IP privato tra i database di origine e di destinazione. Se utilizzi un tipo di connettività diverso (ad esempio il peering VPC o un tunnel SSH inverso), assicurati di aggiungere i flag richiesti, ad esempio --peer-vpc, o --vm, --vm-ip, --vm-port, --vpc. Per ulteriori informazioni, consulta Configurare la connettività e Esempi di Google Cloud CLI.

Questo esempio utilizza il flag facoltativo --no-async in modo che tutte le operazioni vengano eseguite in modo sincrono. Ciò significa che il completamento di alcuni comandi potrebbe richiedere del tempo. Puoi ignorare il flag --no-async per eseguire i comandi in modo asincrono. In questo caso, devi utilizzare il comando gcloud database-migration operations describe per verificare se l'operazione è riuscita.

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

• MIGRATION_JOB_ID con un identificatore leggibile dalla macchina per il tuo job di migrazione. Utilizzi questo valore per lavorare con i job di migrazione utilizzando i comandi o l'API Google Cloud CLI di Database Migration Service.
• REGION con l'identificatore della regione in cui vuoi salvare il job di migrazione.
• MIGRATION_JOB_NAME con un nome leggibile per il job di migrazione. Questo valore viene visualizzato in Database Migration Service nella console Google Cloud .
• SOURCE_CONNECTION_PROFILE_ID con un identificatore leggibile dalla macchina del profilo di connessione di origine.
• DESTINATION_CONNECTION_PROFILE_ID con un identificatore leggibile dalla macchina del profilo di connessione di destinazione.

• (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 che hai creato con --database-filter flag utilizzando il comando gcloud database-migration migration-jobs update.

• MIGRATION_JOB_TYPE con il tipo di job di migrazione. Sono consentiti due valori: ONE_TIME o CONTINUOUS. Per ulteriori informazioni, vedi Tipi di migrazione.

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 \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=MIGRATION_JOB_TYPE \

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 `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=MIGRATION_JOB_TYPE `

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 ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=MIGRATION_JOB_TYPE ^

Dovresti ricevere una risposta simile alla seguente:

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]

Retrocedere il database di destinazione

Database Migration Service richiede che l'istanza del database di destinazione funzioni come replica di lettura per la durata della migrazione. Prima di avviare il job di migrazione, esegui il comando gcloud database-migration migration-jobs demote-destination per eseguire il declassamento dell'istanza del database di destinazione.

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 visualizzare i relativi identificatori.

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

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 \
demote-destination 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 `
demote-destination 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 ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, 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: demote-destination
name: OPERATION_ID

Per verificare se l'operazione è riuscita, puoi eseguire una query sull'oggetto 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 gcloud database-migration operations describe con OPERATION_ID per visualizzare lo stato dell'operazione stessa.

Gestione dei job di migrazione

A questo punto, il job di migrazione è configurato e connesso all'istanza del database di destinazione. Puoi gestirlo utilizzando le operazioni verify,start, stop, restart e resume.

Verificare il job di migrazione

Ti consigliamo di verificare prima il job di migrazione eseguendo il comando gcloud database-migration migration-jobs verify.

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 visualizzare i relativi identificatori.

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

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 \
verify 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 `
verify 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 ^
verify MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, 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 è riuscita, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

• Utilizza il comando gcloud database-migration migration-jobs describe con l'opzione MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
• Utilizza il comando gcloud database-migration operations describe con l'opzione OPERATION_ID per visualizzare lo stato dell'operazione stessa.

Avviare il job di migrazione

Avvia il job di migrazione eseguendo il comando gcloud database-migration migration-jobs start.

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 visualizzare i relativi identificatori.

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

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 \
start 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 `
start 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 ^
start MIGRATION_JOB_ID ^
  --region=REGION

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, 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 è riuscita, puoi eseguire una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

• Utilizza il comando gcloud database-migration migration-jobs describe con l'opzione MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
• Utilizza il comando gcloud database-migration operations describe con l'opzione OPERATION_ID per visualizzare lo stato dell'operazione stessa.

Promuovere il job di migrazione

Una volta che la migrazione raggiunge la fase Change Data Capture (CDC), puoi promuovere l'istanza del database di destinazione da una replica di lettura a un'istanza autonoma. Esegui il comando gcloud database-migration migration-jobs promote:

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 visualizzare i relativi identificatori.

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

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. Pertanto, 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 è riuscita, puoi eseguire query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

• Utilizza il comando gcloud database-migration migration-jobs describe con l'opzione MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
• Utilizza il comando gcloud database-migration operations describe con l'opzione OPERATION_ID per visualizzare lo stato dell'operazione stessa.