Creare un job di migrazione in una nuova istanza di destinazione

MySQL   |  PostgreSQL   |  PostgreSQL ad AlloyDB

La creazione di un job di migrazione include:

• Definizione delle impostazioni per il job di migrazione.
• Specifica le informazioni sul profilo di connessione che hai creato per il database di origine (profilo di connessione di origine).
• Definisci le impostazioni per l'istanza del database Cloud SQL di destinazione e crea l'istanza.
• Configurazione della connettività tra le istanze del database di origine e di destinazione.
• Testare il job di migrazione per assicurarti che i dati di connessione forniti per il job siano validi.

Per creare un job di migrazione in una nuova istanza di destinazione:

Console

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 di configurazione.

   Puoi mettere in pausa la creazione di un job di migrazione in qualsiasi momento facendo clic su Salva ed esci. Tutti i dati inseriti fino a quel punto vengono salvati in una bozza del job di migrazione. Puoi completare il job di migrazione della bozza in un secondo momento.

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

      Si tratta di 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. Utilizza questo valore per lavorare con i job di migrazione utilizzando i comandi o l'API Google Cloud CLI di Database Migration Service.

   3. Nell'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 Il supporto delle regioni per la versione 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 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:
   • In base a dati fisici: seleziona questa opzione se vuoi utilizzare l'utilità Percona XtraBackup per fornire il tuo file di backup. Questo approccio richiede passaggi di preparazione aggiuntivi. Per la guida completa sull'utilizzo dei file di backup fisici generati da Percona XtraBackup, consulta Eseguire la migrazione dei database utilizzando un file fisico Percona XtraBackup.
   • In base a logica: seleziona questa opzione se vuoi utilizzare un file di backup logico creato dall'utilità mysqlshell. 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, fai clic su Sfoglia in Fornisci la tua cartella, quindi seleziona la cartella in cui hai caricato il file 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 i passaggi completi del file di backup logico

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

     1. Genera automaticamente il dump iniziale (opzione consigliata)

        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 e i dati delle tabelle originali 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 5.7 o 8 di MySQL.
          Se scegli di utilizzare il parallelismo di caricamento, 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, consulta Configura 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 un carico ottimale sul database di origine.
          • Massima: fornisce 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 maggiore velocità in termini di throughput del dump.
        • Flag di dump: questa opzione è esclusiva del parallismo del dump dei dati. Utilizza questa impostazione per configurare direttamente i flag per l'utilità mysqldump utilizzata per creare il file 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 dump con istruzioni LOCK TABLES e UNLOCK TABLES. Ciò comporta inserimenti più rapidi quando il file 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; 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 indicatore che vuoi aggiungere.

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

     2. Fornire il proprio

        Questa opzione è sconsigliata 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 SFOGLA, 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 per i dump.

5. Fai clic su Salva e continua.

Configura e crea l'istanza Cloud SQL di destinazione

1. Nella pagina Definire una destinazione, seleziona Nuova istanza dal menu a discesa Tipo di istanza destinazione. Definisci tutte le impostazioni pertinenti:
   1. Nel campo ID istanza di destinazione, fornisci un identificatore per l'istanza Cloud SQL o utilizza l'identificatore generato automaticamente.

      Non includere informazioni sensibili o che consentono l'identificazione personale nell'identificatore. Non è necessario includere l'ID progetto nel nome dell'istanza. Questa operazione viene eseguita automaticamente, se opportuno, (ad esempio nei file di log).

   2. Nel campo Password, fornisci una password alfanumerica per l'istanza Cloud SQL di destinazione. Questa è la password dell'account amministratore root nell'istanza.

      Puoi inserire la password manualmente o fare clic su Genera per consentire a Database Migration Service di crearne una automaticamente.

   3. Nel menu a discesa Versione database, scegli la versione del database per l'istanza di destinazione.

      Fai clic su Mostra versioni secondarie per visualizzare tutte le versioni secondarie. Scopri di più sul supporto della migrazione tra versioni.

   4. Seleziona la versione Cloud SQL per MySQL per l'istanza di destinazione. Sono disponibili due opzioni: Cloud SQL per MySQL Enterprise e Cloud SQL per MySQL Enterprise Plus.

      Le versioni di Cloud SQL per MySQL sono disponibili con diversi set di funzionalità, tipi di macchine e prezzi. Assicurati di consultare la documentazione di Cloud SQL per scegliere la versione più adatta alle tue esigenze. Per ulteriori informazioni, consulta Introduzione alle versioni di Cloud SQL per MySQL.

   5. Il menu Regione mostra la stessa regione selezionata nella pagina Inizia.

      Se configuri l'istanza per la disponibilità elevata, seleziona Più zone (disponibilità elevata). Puoi selezionare sia la zona principale che quella secondaria. Quando viene utilizzata la zona secondaria durante la creazione dell'istanza, si applicano le seguenti condizioni:

      • Per impostazione predefinita, le zone sono Qualsiasi per la zona principale e Qualsiasi (diversa dalla principale) per la zona secondaria.
      • Se sono specificate entrambe le zone, primaria e secondaria, devono essere zone diverse.
   6. Nella sezione Connessioni, scegli se aggiungere un indirizzo IP pubblico o privato per l'istanza di destinazione. Puoi configurare l'istanza in modo che abbia entrambi i tipi di indirizzi IP, ma per la migrazione è necessario almeno un tipo. Seleziona una delle seguenti opzioni:
      • Se vuoi eseguire la migrazione utilizzando il peering VPC o un tunnel SSH inverso, seleziona IP privato.

        • Per attivare la connettività con IP privato, assicurati di soddisfare tutti i requisiti di rete aggiuntivi.

          Espandi questa sezione per visualizzare i requisiti completi per gli IP privati.

          • L'API Service Networking è abilitata. Puoi abilitare l' API Service Networking utilizzando la console Google Cloud.
          • Disponi dell' autorizzazione IAM servicenetworking.services.addPeering.
          • Hai configurato l'accesso privato ai servizi per il tuo progetto, per il quale devi disporre del ruolo IAM compute.networkAdmin.
          • Nel progetto è presente almeno una rete VPC non legacy o una rete VPC condivisa.
          • Se utilizzi una rete VPC condivisa, devi anche eseguire le seguenti operazioni:
            • Abilita l'API Service Networking per il progetto host.
            • Aggiungi il tuo utente al progetto host.
            • Assegna all'utente il ruolo IAM compute.networkAdmin nel progetto host.
        • Seleziona la rete VPC associata al peering. Se prevedi di connetterti all'origine di migrazione utilizzando il peering VPC, scegli il VPC in cui risiede l'istanza.
        • Se per il VPC selezionato non è mai stata configurata una rete di servizi gestita, puoi scegliere di selezionare un intervallo IP e fare clic su Connetti oppure utilizzare un intervallo IP selezionato automaticamente e fare clic su Alloca e connetti.
      • Se vuoi eseguire la migrazione tramite internet utilizzando una lista consentita IP, seleziona IP pubblico.
        

        Se vuoi, fai clic sul campo Reti autorizzate in IP pubblico e autorizza una rete o un proxy a connettersi all'istanza Cloud SQL. Le reti sono autorizzate solo con gli indirizzi forniti. Consulta Configurare l'IP pubblico nella documentazione di Cloud SQL.

      Configura la connettività del job di migrazione in un passaggio successivo. Per scoprire di più sui metodi di networking disponibili, consulta Configurare la connettività.

2. Seleziona il tipo di macchina per l'istanza Cloud SQL. La dimensione del disco deve essere uguale o superiore a quella del database di origine. Scopri di più sui tipi di macchine MySQL.
   Nota: le macchine disponibili nella selezione Tipo di macchina dipendono dalla versione di Cloud SQL in uso.
3. Per la versione Cloud SQL per MySQL Enterprise Plus: seleziona la casella di controllo Abilita cache dei dati se vuoi utilizzare la funzionalità di cache dei dati nel database di destinazione.

   La cache dei dati è una funzionalità facoltativa disponibile per le istanze di Cloud SQL per MySQL Enterprise Plus che aggiunge un'unità a stato solido locale ad alta velocità al database di destinazione. Questa funzionalità può comportare costi aggiuntivi per Cloud SQL. Per ulteriori informazioni sulla cache dei dati, consulta Panoramica della cache dei dati nella documentazione di Cloud SQL.

4. Specifica il tipo di archiviazione per l'istanza Cloud SQL. Puoi scegliere tra un' unità a stato solido (SSD) o un'unità disco rigido (HDD).
5. Specifica la capacità di archiviazione (in GB) per l'istanza Cloud SQL.

   Assicurati che l'istanza abbia una capacità di archiviazione sufficiente per gestire i dati del database di origine. Puoi aumentare questa capacità in qualsiasi momento, ma non puoi diminuirla.

6. (Facoltativo) Configura le opzioni di crittografia dei dati o le etichette delle risorse per l'istanza di destinazione.

   Espandi questa sezione per visualizzare i passaggi facoltativi.

   Fai clic su Mostra configurazioni facoltative e poi:

   1. Specifica se vuoi gestire la crittografia dei dati sottoposti a migrazione dall'origine alla destinazione. Per impostazione predefinita, i tuoi dati sono criptati con una chiave gestita da Google Cloud. Se vuoi gestire la crittografia, puoi utilizzare una chiave di crittografia gestita dal cliente (CMEK). Ecco come fare:

      1. Seleziona la casella di controllo Usa una chiave di crittografia gestita dal cliente (CMEK).
      2. Dal menu Seleziona una chiave gestita dal cliente, seleziona la tua CMEK.

      Se non vedi la chiave, fai clic su Inserisci il nome risorsa della chiave per fornire il nome della risorsa della chiave che vuoi utilizzare. Esempio di nome della risorsa chiave: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

      Durante la creazione del job di migrazione, Database Migration Service verifica che la chiave CMEK esista e che il servizio abbia le autorizzazioni per utilizzarla.

      Se Database Migration Service non dispone di queste autorizzazioni, verranno visualizzate informazioni che specificano che l'account di servizio Database Migration Service non può utilizzare CMEK. Fai clic su Concede per concedere a Database Migration Service le autorizzazioni per utilizzare la chiave.

      Per ulteriori informazioni sulla creazione di una chiave CMEK, consulta Utilizzo delle chiavi di crittografia gestite dal cliente (CMEK).

   2. Aggiungi eventuali flag necessari da applicare al server di database. Se possibile, assicurati che i flag di database sull'istanza Cloud SQL di destinazione creata siano gli stessi del database di origine. Scopri di più sui flag di database supportati per MySQL.
   3. Aggiungi eventuali etichette specifiche per l'istanza Cloud SQL.

      Le etichette consentono di organizzare le istanze. Ad esempio, puoi organizzare le etichette per centro di costo o ambiente. Le etichette sono incluse anche nella fattura, pertanto puoi vedere come sono distribuiti i costi nelle varie etichette.

7. Fai clic su Crea destinazione e continua. Database Migration Service sta ora creando l'istanza Cloud SQL di destinazione. Questa procedura può richiedere diversi minuti.
   Punto chiave:

   • Database Migration Service crea un'istanza Cloud SQL per la quale ti verrà addebitato un importo in base alla configurazione specificata. Se il flusso di creazione del job di migrazione viene interrotto prima del completamento, utilizza il pulsante Annulla per ripulire l'istanza Cloud SQL. Se il browser o la scheda vengono chiusi, se si fa clic su Salva ed esci o se si esce dalla schermata, l'istanza Cloud SQL non viene ripulita e dovrà essere eliminata manualmente dalla pagina Istanze Cloud SQL.
   • Una volta creata l'istanza di destinazione, le impostazioni dell'istanza Cloud SQL non possono più essere modificate nella console del servizio di migrazione del database. Puoi comunque accedere all'istanza direttamente nella console Cloud SQL per modificarla.

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 e peering VPC.

Se vuoi utilizzare…	Poi…
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 di alta disponibilità, includi gli indirizzi IP in uscita sia per l'istanza principale sia 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 con connettività sia al database di origine sia a Google Cloud.
Il metodo di connettività di rete del peering VPC,	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, esamina il riepilogo delle impostazioni, dell'origine, della destinazione e del metodo di connettività del job di migrazione, quindi verifica la validità della configurazione del job di migrazione. In caso di 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 non va a buon fine, puoi risolvere il problema nella parte appropriata del flusso e riprovare. Per informazioni sulla risoluzione dei problemi relativi a un test del job di migrazione non riuscito, consulta Diagnostica i problemi per 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 dall'ora di inizio del job di migrazione, alla tua organizzazione viene addebitato il costo dell'esistenza dell'istanza di destinazione.

   La migrazione è in corso. 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 meno di un minuto) all'inizio della migrazione. Per ulteriori informazioni, consulta 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 applicare nuovamente le impostazioni di Terraform prima del completamento della migrazione. Per maggiori informazioni, consulta la sezione Drift della configurazione Terraform.
3. Vai a Rivedere il job di migrazione.

gcloud

1. Crea il profilo di connessione di destinazione.
   Quando esegui la migrazione a una nuova istanza di destinazione con Google Cloud CLI, crei l'istanza di destinazione e il profilo di connessione in un'unica azione.
   Esegui il seguente comando (fai clic sul link per espandere):

   gcloud database-migration connection-profiles create cloudsql

   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 è 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.
   • DATABASE_VERSION con la versione MySQL che vuoi utilizzare nell'istanza di destinazione. Le versioni del database vengono specificate come stringhe che includono sia la versione principale che quella secondaria. Ad esempio: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

     Per tutte le possibili versioni di MySQL, consulta il riferimento al flag --database-version.

   • (Facoltativo) EDITION Per impostazione predefinita, le nuove istanze create con Google Cloud CLI utilizzano Cloud SQL per la versione Enterprise Plus di MySQL. 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 per Cloud SQL per MySQL Enterprise Plus.

     Puoi modificare la versione utilizzando il flag --edition con uno dei seguenti valori:

     • enterprise-plus per la versione Cloud SQL per MySQL Enterprise Plus
     • enterprise per la versione Enterprise di Cloud SQL per MySQL
   • TIER con il nome del tipo di macchina Cloud SQL che vuoi utilizzare. I tipi di macchine vengono specificati come stringhe che seguono la convenzione Cloud SQL, ad esempio db-n1-standard-1, db-perf-optimized-N-2. Per un elenco completo dei tipi di macchine disponibili e dei relativi identificatori da utilizzare con l'interfaccia a riga di comando Google Cloud, consulta Tipo di macchine nella documentazione di Cloud SQL per MySQL.

     Per impostazione predefinita, le istanze create con Google Cloud CLI utilizzano la versione Enterprise Plus di Cloud SQL per MySQL, che offre diversi tipi di macchine. Se vuoi utilizzare un tipo di macchina disponibile solo nella versione Enterprise di Cloud SQL per MySQL, utilizza il flag facoltativo --edition=enterprise per specificare la versione.

   • REGION con l'identificatore della regione in cui vuoi salvare il profilo di connessione.

     Per impostazione predefinita, le nuove istanze create con Google Cloud CLI utilizzano la versione Enterprise Plus di Cloud SQL per MySQL. 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 per Cloud SQL per MySQL Enterprise Plus. Puoi modificare la versione utilizzando il flag facoltativo --edition.

   • (Facoltativo) CONNECTION_PROFILE_NAME con un nome leggibile per il profilo di connessione. Questo valore viene visualizzato nella console Google Cloud.
   • Configurazione della rete

     Per impostazione predefinita, alle nuove istanze create con Google Cloud CLI è assegnato un indirizzo IP pubblico e sono configurate per utilizzare la connettività IP pubblico. Puoi utilizzare altri metodi di connettività. Per ulteriori informazioni, consulta la pagina Configurare la connettività.

     Non è necessario utilizzare flag aggiuntivi se vuoi utilizzare la connettività IP pubblico. Se vuoi utilizzare la connettività IP privata con il peering di rete VPC o un tunnel SSH inverso, assicurati di soddisfare i seguenti requisiti di rete aggiuntivi per attivare la connettività IP privato e includi flag aggiuntivi nel comando.

     Espandi questa sezione per visualizzare i requisiti completi per gli IP privati.

     • L'API Service Networking è abilitata. Puoi abilitare l' API Service Networking utilizzando la console Google Cloud.
     • Disponi dell' autorizzazione IAM servicenetworking.services.addPeering.
     • Hai configurato l'accesso privato ai servizi per il tuo progetto, per il quale devi disporre del ruolo IAM compute.networkAdmin.
     • Nel progetto è presente almeno una rete VPC non legacy o una rete VPC condivisa.
     • Se utilizzi una VPC condiviso condivisa, devi anche eseguire le seguenti operazioni:
       • Abilita l'API Service Networking per il progetto host.
       • Aggiungi il tuo utente al progetto host.
       • Assegna all'utente il ruolo IAM compute.networkAdmin nel progetto host.

     Includi i seguenti flag aggiuntivi se vuoi utilizzare la connettività IP privato (con il peering di rete VPC o con un tunnel SSH inverso su una VM Compute Engine):

     • --no-enable-ip-v4: (Facoltativo) Per non assegnare un indirizzo IP pubblico all'istanza di destinazione. Puoi assegnare sia un indirizzo IP pubblico che uno privato all'istanza di destinazione, ma potresti non volere un indirizzo IP pubblico se utilizzi la connettività IP privata.
     • --private-network: per assegnare un indirizzo IP privato all'istanza di destinazione, specifica il nome del Virtual Private Cloud a cui vuoi assegnare un indirizzo IP privato.

   Esegui il seguente comando:

   Linux, macOS o Cloud Shell

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

   gcloud database-migration connection-profiles \
   create mysql CONNECTION_PROFILE_ID \
     --no-async \
     --region=REGION \
     --database-version=DATABASE_VERSION \
     --tier=TIER \
     --display-name=CONNECTION_PROFILE_NAME

   Windows (PowerShell)

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

   gcloud database-migration connection-profiles `
   create mysql CONNECTION_PROFILE_ID `
     --no-async `
     --region=REGION `
     --database-version=DATABASE_VERSION `
     --tier=TIER `
     --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; oppure gcloud auth login e gcloud config set project.

   gcloud database-migration connection-profiles ^
   create mysql CONNECTION_PROFILE_ID ^
     --no-async ^
     --region=REGION ^
     --database-version=DATABASE_VERSION ^
     --tier=TIER ^
     --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]
   

2. Crea il job di migrazione.
   Se utilizzi il peering VPC o una connettività del 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 interfaccia a riga di comando Google Cloud.
   Esegui il seguente comando (fai clic sul link per espandere):

   gcloud database-migration migration-jobs 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 è 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. Utilizza 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.

   Esegui il seguente comando:

   Linux, macOS o Cloud Shell

   Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto, eseguendo gcloud init; oppure 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; oppure 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; oppure 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]