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

MySQL   |  PostgreSQL   |  PostgreSQL to AlloyDB

Panoramica

Database Migration Service utilizza i job di migrazione per migrare i 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
• Selezione del profilo di connessione al database di origine
• Selezione dell'istanza del 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 assicurarti che le informazioni di connessione che hai fornito 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. Per saperne di più, consulta Limitazioni note.

La procedura guidata di Database Migration Service ti aiuta a creare un job di migrazione. Questa procedura guidata è composta dai seguenti riquadri: Inizia, Definisci un'origine, Crea una destinazione, Definisci il metodo di connettività, Configura i database di migrazione e Testa e crea il job di migrazione. Le informazioni su come compilare ogni riquadro sono fornite nelle sezioni seguenti di questa pagina.

Crea un job di migrazione utilizzando la console Google Cloud

Puoi mettere in pausa la creazione di un job di migrazione facendo clic su Salva ed esci. Tutti i dati inseriti fino a quel momento vengono salvati in una bozza del job di migrazione, a cui puoi accedere nella scheda Bozze.

Per completare la creazione di un job di migrazione, vai alla scheda e fai clic sul job. Il flusso di creazione riprende da dove era stato interrotto. Il job rimane una bozza finché non fai clic su Crea o Crea e avvia.

Definisci le impostazioni per il job di migrazione

1. Vai a Job di migrazione nella console Google Cloud .

2. Fai clic su Crea job di migrazione nella parte superiore della pagina.

3. Specifica un nome per il job di migrazione. Scegli un nome intuitivo che ti aiuti a identificare il job di migrazione. Non includere informazioni sensibili o che consentono l'identificazione personale nel nome del job.

4. Mantieni l'ID job di migrazione generato automaticamente.

5. Seleziona il motore del database di origine.

6. Seleziona AlloyDB per PostgreSQL come motore di destinazione.

7. Seleziona la regione di destinazione per la migrazione. Questa regione deve essere la stessa in cui si trova il database di destinazione. Dopo aver scelto la regione di destinazione, questa selezione non può essere modificata.

8. Scegli Continuo (snapshot + modifiche in corso) come tipo di prestazione di migrazione.

9. Nella sezione Prima di continuare, esamina i prerequisiti, fai clic su Apri per visualizzare le istruzioni generate automaticamente che possono aiutarti a preparare il database di origine per la migrazione. È preferibile completare questi prerequisiti in questo passaggio, ma puoi completarli in qualsiasi momento prima di testare o avviare il job di migrazione. Per saperne di più, consulta Configura l'origine.

10. Fai clic su Salva e continua.

Specifica le informazioni sul profilo di connessione di origine

1. Se hai creato un profilo di connessione, selezionalo dall'elenco dei profili di connessione esistenti.

   Se non hai creato un profilo di connessione, creane uno facendo clic su Crea un profilo di connessione in fondo all'elenco a discesa, quindi esegui gli stessi passaggi descritti in Crea un profilo di connessione di origine.

   Ti consigliamo di creare un profilo di connessione designato per la migrazione ad AlloyDB.

2. Nella sezione Personalizza le configurazioni del dump dei dati, fai clic su Mostra le configurazioni del dump dei dati.

   La velocità del parallelismo del dump dei dati è correlata alla quantità di carico sul database di origine. Puoi utilizzare le seguenti impostazioni:

   • Ottimale (consigliata): prestazioni bilanciate con un carico ottimale sul database di origine.
   • Massima: 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 un throughput di dump più lento.

   Se vuoi utilizzare le impostazioni di parallelismo del dump dei dati modificate, assicurati di aumentare i parametri max_replication_slots, max_wal_senders e max_worker_processes nel database di origine. Puoi verificare la configurazione eseguendo il test del job di migrazione al termine della creazione del job di migrazione.

3. Fai clic su Salva e continua.

Se il database di origine è un'istanza Cloud SQL e ha solo l'IP pubblico abilitato, assicurati di abilitare l'IP privato prima di continuare con la sezione successiva. Ricordati di aggiornare il profilo di connessione con l'IP privato.

Seleziona l'istanza di destinazione

Per le origini Cloud SQL: se esegui la migrazione da un'istanza Cloud SQL che utilizza una connessione IP privata a un'istanza Cloud SQL che utilizza un intervallo IP con indirizzo non RFC 1918, aggiungi l'intervallo non RFC 1918 alla configurazione di rete dell'istanza Cloud SQL di origine. Consulta Configura le reti autorizzate nella documentazione di Cloud SQL.

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

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

Nota: se l'origine è Cloud SQL per PostgreSQL, a seconda che l'istanza di origine Cloud SQL si trovi sulla vecchia o sulla nuova architettura di rete, le opzioni di connettività sono limitate al peering VPC e al proxy TCP tramite una VM ospitata nel cloud.

1. Dal menu a discesa Metodo di connettività, seleziona un metodo di connettività di rete. Questo metodo definisce il modo in cui il cluster AlloyDB appena creato si connetterà al database di origine. I metodi di connessione di rete attuali includono lista consentita di IP, peering VPC, interfacce Private Service Connect, tunnel SSH inverso e proxy TCP tramite una VM ospitata nel cloud.
2. Se selezioni il metodo di connettività di rete con lista consentita IP, devi specificare l'indirizzo IP in uscita dell'istanza di destinazione. Copia gli indirizzi IP in uscita per l'istanza principale e quella secondaria e utilizzali per configurare il firewall di rete per il server di database di origine e nel file pg_hba.conf, in modo che l'origine possa accettare connessioni da questi indirizzi.

3. Se selezioni il metodo di connettività di rete del tunnel SSH inverso, seleziona 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 con connettività sia al database di origine sia a Google Cloud.

4. Se utilizzi uno dei metodi di connettività con IP privato, seleziona Peering VPC o Interfaccia PSC.
5. Se selezioni il metodo di connessione di rete Peering VPC, seleziona la rete VPC in cui si trova il database di origine. L'istanza Cloud SQL verrà aggiornata per connettersi a questa rete.

6. Se selezioni il metodo di connettività Proxy TCP tramite VM ospitata nel cloud, inserisci i dettagli richiesti per la nuova istanza VM di Compute Engine che ospiterà il proxy TCP.

   Dopo aver specificato i dettagli, la console Google Cloud fornirà uno script che esegue i passaggi per configurare il proxy tra i database di origine e di destinazione. Dovrai eseguire lo script su una macchina con una versione aggiornata di Google Cloud CLI.

   Dopo l'esecuzione dello script, verrà visualizzato l'IP privato della VM appena creata. Inserisci l'IP e fai clic su Configura e continua.

7. Dopo aver selezionato il metodo di connettività di rete e aver fornito eventuali informazioni aggiuntive per il metodo, fai clic su CONFIGURA E CONTINUA.

Configura database di migrazione

Puoi selezionare i database di cui vuoi eseguire la migrazione.

1. Nell'elenco Database da migrare, seleziona una delle seguenti opzioni:
   • Tutti i database: seleziona tutti i database presenti nell'origine.
   • Database specifici: consente di selezionare database specifici da tutti i database esistenti nell'origine.

2. Se vuoi eseguire la migrazione di database specifici, puoi filtrare l'elenco visualizzato e selezionare i database di cui vuoi che Database Migration Service esegua la migrazione nella destinazione.

   Se l'elenco non viene visualizzato e viene mostrato un errore di rilevamento del database, fai clic su Ricarica. Se il rilevamento del database non va a buon fine, il job esegue la migrazione di tutti i database. Puoi continuare con la creazione di un job di migrazione e correggere gli errori di connettività in un secondo momento.

3. Fai clic su Salva e continua.

Testa e crea il job di migrazione

In questo passaggio finale, esamina 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. Fai clic su TESTA IL JOB per verificare che:

   • Il database di origine è stato configurato correttamente in base ai prerequisiti.
   • Le istanze di origine e di destinazione possono comunicare tra loro.
   • Gli aggiornamenti degli indirizzi IP privati necessari sulla destinazione sono stati eseguiti.
   • Il job di migrazione è valido e le versioni di origine e di destinazione sono compatibili.

   Se il test non va a buon fine, puoi risolvere il problema nella parte appropriata del flusso e tornare a ripetere il test.

   Per ulteriori informazioni sui motivi per cui il test potrebbe non riuscire e su come risolvere eventuali problemi associati al test non riuscito, consulta Diagnostica i problemi di AlloyDB.

   Il job di migrazione può essere creato anche se il test non va a buon fine, ma dopo l'avvio del job, potrebbe non riuscire in un momento qualsiasi durante l'esecuzione.

2. 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 per l'esistenza dell'istanza di destinazione.

   Quando avvii il job di migrazione, Database Migration Service avvia 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 un minuto) all'inizio della migrazione. Per saperne di più, consulta Considerazioni sul parallelismo dei dump dei dati.

3. Il job di migrazione viene aggiunto all'elenco dei job di migrazione e può essere visualizzato direttamente.

4. Vai a Esamina 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. Questo non è necessario quando utilizzi la console Google Cloud , poiché Database Migration Service si occupa della creazione e della rimozione del profilo di connessione di destinazione per te.

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. Consulta:
  • Configura l'origine
  • Crea il profilo di connessione di origine (l'identificatore del profilo di connessione di origine è obbligatorio per creare un job di migrazione).
  • Configura 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 un po' di tempo. Puoi saltare 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 è andata a buon fine.

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

• CONNECTION_PROFILE_ID con un identificatore leggibile da 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 postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=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 postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=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 postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=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: i seguenti esempi rappresentano uno scenario di migrazione in cui utilizzi la connettività con 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, come --peer-vpc o --vm, --vm-ip, --vm-port, --vpc. Per saperne di più, consulta Configura la connettività ed Esempi di Google Cloud CLI.

Nota: per le migrazioni ad AlloyDB è supportato solo il tipo di migrazione continua.

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 un po' di tempo. Puoi saltare 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 è andata a buon fine.

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

• MIGRATION_JOB_ID con un identificatore leggibile da macchina per il job di migrazione. Utilizza questo valore per lavorare con i job di migrazione utilizzando i comandi o l'API di 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 da macchina del profilo di connessione di origine.
• DESTINATION_CONNECTION_PROFILE_ID con un identificatore leggibile da 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

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

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=CONTINUOUS \

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=CONTINUOUS `

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=CONTINUOUS ^

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]

Retrocedi il database di destinazione

Database Migration Service richiede che l'istanza del database di destinazione funzioni come replica di lettura per il periodo della migrazione. Prima di avviare il job di migrazione, esegui il comando gcloud database-migration migration-jobs demote-destination per retrocedere l'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 visualizzarne gli 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 seguenti operazioni:

1. (Facoltativo) Verifica il job di migrazione.
   Ti consigliamo di verificare prima il job di migrazione eseguendo il comando gcloud database-migration migration-jobs verify.

   Per saperne di più, espandi la sezione seguente:

   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 visualizzarne gli 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 MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
   • Utilizza il comando gcloud database-migration operations describe con OPERATION_ID per visualizzare lo stato dell'operazione stessa.

2. (Facoltativo) Recupera le informazioni sui database selezionati per la migrazione.
   Quando esegui la migrazione di database specifici, Database Migration Service deve recuperare i dettagli dei database selezionati per il job di migrazione utilizzando il flag --database-filter.

   Prima di avviare il job di migrazione, esegui il comando gcloud database-migration migration-jobs fetch-source-objects.

   Per saperne di più, espandi la sezione seguente:

   gcloud database-migration migration-jobs fetch-source-objects

   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 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 \
   fetch-source-objects 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 `
   fetch-source-objects 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 ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   Risultato

   L'output è simile al seguente:

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   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 MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
   • Utilizza il comando gcloud database-migration operations describe con OPERATION_ID per visualizzare lo stato dell'operazione stessa.

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

   Per saperne di più, espandi la sezione seguente:

   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 visualizzarne gli 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 MIGRATION_JOB_ID per visualizzare lo stato del job di migrazione.
   • Utilizza il comando gcloud database-migration operations describe con OPERATION_ID per visualizzare lo stato dell'operazione stessa.

Promuovi il job di migrazione

Una volta che la migrazione raggiunge la fase di 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 visualizzarne gli 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 una query sull'oggetto operazione restituito o controllare lo stato del job di migrazione:

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