Eseguire l'upgrade di un'istanza alla versione Cloud SQL Enterprise Plus utilizzando le liste consentite di IP

MySQL   |  PostgreSQL   |  SQL Server

Nota: questa pagina contiene funzionalità relative alle versioni di Cloud SQL. Per ulteriori informazioni sulle versioni di Cloud SQL, consulta Introduzione alle versioni di Cloud SQL.

Questa pagina mostra come utilizzare il metodo di connettività di rete della lista consentita degli IP pubblici di Database Migration Service per eseguire l'upgrade di un'istanza della versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Database Migration Service crea una nuova istanza Cloud SQL ed esegue la migrazione dei dati in quell'istanza.

Panoramica

La versione Cloud SQL Enterprise Plus è ideale per le applicazioni che richiedono le massime prestazioni di scrittura. Per saperne di più su questi miglioramenti, consulta la sezione Miglioramenti delle prestazioni.

Per abilitare questi miglioramenti per le istanze esistenti della versione Cloud SQL Enterprise, devi eseguirne l'upgrade alla versione Cloud SQL Enterprise Plus utilizzando Database Migration Service.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Abilita l'API Database Migration Service.

   Abilitare l'API

7. Assicurati che il ruolo Database Migration Admin (Amministratore migrazione database) sia stato assegnato al tuo account utente.

   Vai a IAM

Requisiti

Database Migration Service offre varie opzioni di database di origine e metodi di connettività di rete. Origini diverse funzionano meglio con una certa connettività che con altri metodi. In questa pagina, supponiamo che tu stia utilizzando un Istanza della versione Cloud SQL Enterprise in un ambiente in cui puoi configurare la rete per aggiungere una regola firewall in entrata. Poiché non possiamo conoscere le specifiche del tuo ambiente, non possiamo fornire passaggi dettagliati per la configurazione di rete.

Configura l'istanza di origine

Per configurare l'istanza della versione Cloud SQL Enterprise di origine, completa i seguenti passaggi:

1. Se non disponi del database postgres per l'istanza di origine, creane uno. Per saperne di più, consulta Creare un database sull'istanza Cloud SQL.
2. Installa il pacchetto pglogical sui database della tua istanza di origine. Assicurati che il pacchetto sia incluso nella variabile shared_preload_libraries. Per ulteriori informazioni, consulta Configurare i database di origine.
3. Abilita la replica e la decodifica logiche per i database dell'istanza di origine. Per ulteriori informazioni, consulta Attivare la replica logica e la decodifica per i database di origine.

Configura i database di origine

Nota: per PostgreSQL 9.4, installa l'estensione pglogical_origin. Poi, installa l'estensione su ogni database eseguendo i seguenti comandi:

• CREATE EXTENSION IF NOT EXISTS pglogical_origin;
• CREATE EXTENSION IF NOT EXISTS pglogical;

A parte i database template0 e template1, Database Migration Service esegue la migrazione di ogni altro database nell'istanza della versione Cloud SQL Enterprise di origine.

Completa i seguenti passaggi su ogni database dell'istanza di origine non menzionato in precedenza:

1. Per installare l'estensione pglogical nel database, esegui il comando CREATE EXTENSION IF NOT EXISTS pglogical.

2. Per le tabelle senza chiavi primarie, esegui manualmente la migrazione delle istruzioni UPDATE e DELETE.

   Nota: per le tabelle che non hanno chiavi primarie, Database Migration Service supporta la migrazione dello snapshot iniziale e delle istruzioni INSERT durante la fase CDC (Change Data Capture).

   Per scoprire come generare una query per elencare le tabelle in un database PostgreSQL senza chiavi primarie, consulta Debug e altri strumenti. Per ogni tabella di database che trovi priva di una chiave primaria e che non fa parte dei database di cui non viene eseguita la migrazione, modifica la tabella in modo che abbia una chiave primaria o esegui la migrazione delle operazioni UPDATE e DELETE per la tabella. Per le tabelle che non hanno chiavi primarie, viene eseguita la migrazione solo dello snapshot iniziale e delle istruzioni INSERT.

3. Per impostare questi privilegi su ciascuno dei database di cui è stata eseguita la migrazione, crea un utente o imposta i privilegi di un utente esistente. Puoi utilizzare questo utente per connetterti all'istanza di origine e configurarlo come utente nella pagina Profili di connessione. Questo utente deve disporre di determinati privilegi su ogni database di cui viene eseguita la migrazione e sul database postgres predefinito.

   Per impostare questi privilegi, connettiti all'istanza ed esegui questi comandi:

   1. GRANT USAGE on SCHEMA SCHEMA to USER su tutti gli schemi (a parte lo schema di informazioni e gli schemi che iniziano con pg_) in ogni database di cui vuoi eseguire la migrazione.
   2. GRANT USAGE on SCHEMA pglogical to PUBLIC; su ciascun database di cui vuoi eseguire la migrazione.
   3. GRANT SELECT on ALL TABLES in SCHEMA pglogical to USER su tutti i database per recuperare le informazioni di replica dai database di origine.
   4. GRANT SELECT on ALL TABLES in SCHEMA SCHEMA to USER su tutti gli schemi (a parte lo schema di informazioni e gli schemi che iniziano con pg_) in ogni database di cui vuoi eseguire la migrazione.
   5. GRANT SELECT on ALL SEQUENCES in SCHEMA SCHEMA to USER su tutti gli schemi (a parte lo schema di informazioni e gli schemi che iniziano con pg_) in ogni database di cui vuoi eseguire la migrazione.
   6. ALTER USER USER with REPLICATION role

Attiva la replica logica e la decodifica per i database di origine

Abilita la replica e la decodifica logica per i database dell'istanza Cloud SQL Enterprise Edition di origine impostando i flag cloudsql.logical_decoding e cloudsql.enable_pglogical su On. Per ulteriori informazioni su questi flag, consulta Configurare i flag di database.

Per attivare entrambi questi flag, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic sull'istanza di origine.
3. Fai clic su Modifica.
4. Nella sezione Personalizza la tua istanza, se il campo Mostra configurazione opzioni, quindi fai clic sul menu.

5. Espandi la sezione Indicatori.

6. Per impostare cloudsql.logical_decoding e cloudsql.enable_pglogical flag, completa i seguenti passaggi:

   1. Fai clic su Aggiungi un flag di database.
   2. Dal menu a discesa, scegli il flag cloudsql.logical_decoding.
   3. Imposta il valore per questo flag su On.
   4. Fai clic su Fine.
   5. Ripeti questi passaggi per il flag cloudsql.enable_pglogical.

7. Fai clic su Salva.

8. Nella finestra di dialogo Le modifiche richiedono il riavvio, fai clic su Salva e riavvia. Cloud SQL riavvia l'istanza di origine affinché le modifiche alla configurazione apportate ai flag abbiano effetto.

9. Nel riquadro Configurazione, conferma le modifiche nella sezione Flag di database.

Crea un profilo di connessione

Un profilo di connessione contiene informazioni sul database Cloud SQL Enterprise Edition di origine. Database Migration Service utilizza le informazioni nel profilo di connessione per eseguire la migrazione dei dati dal database di origine all'istanza Cloud SQL Enterprise Plus di destinazione.

Per creare un profilo di connessione, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Profili di connessione in Database Migration Service.

   Vai a Profili di connessione

2. Fai clic su Crea profilo.

3. Nell'elenco a discesa Motore del database, seleziona Cloud SQL per PostgreSQL.

4. Nel campo Nome profilo di connessione, inserisci un nome per il profilo di connessione per il database di origine, ad esempio My Connection Profile.

   Nota: Cloud SQL genera automaticamente l'ID profilo di connessione con le informazioni sull'istanza di origine. Ti consigliamo di non modificare questo valore.

5. Seleziona la regione in cui vuoi salvare il profilo di connessione.

   Nota: i profili di connessione, come tutte le risorse, vengono salvati in una regione. La selezione della regione non influisce sui job di migrazione che possono utilizzare i profili di connessione o sulle regioni che possono collegarsi alla località dei dati. Tuttavia, la selezione della regione può influire sulla disponibilità in caso di tempo di inattività della regione.

6. Nell'elenco a discesa Istanza Cloud SQL, seleziona il nome dell'istanza della versione Cloud SQL Enterprise.

7. Per autenticarti nell'istanza di origine, inserisci un nome utente e una password. Poi, fai clic su Continua.

   Nota: Cloud SQL compila automaticamente i campi Nome host o indirizzo IP e Porta con le informazioni sull'istanza di origine. Se questi campi sono vuoti, inserisci i valori appropriati.

8. Se vuoi criptare i tuoi dati, attiva la crittografia SSL/TLS per la connessione tra i database di origine e di destinazione. In caso contrario, mantieni il valore predefinito Nessuna.

9. Fai clic su Continua.

10. Dal menu a discesa Test di connettività, seleziona IP pubblico.

11. Verifica che l'origine sia stata configurata correttamente e che Database Migration Service possa comunicare con l'origine:

    1. Fai clic su Esegui test.

    2. Verifica che lo stato sia visualizzato: Your connection profile test was successful!.

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

12. Fai clic su Crea.

Creazione di un job di migrazione

Database Migration Service utilizza i job di migrazione per eseguire la migrazione dei dati dall'istanza del database della versione Cloud SQL Enterprise di origine all'istanza della versione Cloud SQL Enterprise Plus di destinazione.

La creazione di un job di migrazione include i seguenti passaggi:

• Definizione delle impostazioni per il job.
• Seleziona il profilo di connessione che hai creato per il database Cloud SQL Enterprise Edition di origine. Questo è il tuo profilo di connessione di origine.
• Definizione delle impostazioni per l'istanza Cloud SQL Enterprise Plus di destinazione.
• Configurazione della connettività tra le istanze del database di origine e di destinazione.
• Eseguire il test del job di migrazione per assicurarti che i dati di connessione forniti per il job siano validi.

Definisci le impostazioni per il job di migrazione

1. Nella console Google Cloud, vai alla pagina Job di migrazione in Database Migration Service.

   Vai a Job di migrazione

2. Fai clic su Crea job di migrazione.

3. Nel campo Nome job di migrazione, inserisci un nome per il job di migrazione, ad esempio My Migration Job.

4. Nell'elenco a discesa Motore del database di origine, seleziona Cloud SQL per PostgreSQL.

5. Nell'elenco a discesa Motore del database di destinazione, seleziona Cloud SQL per PostgreSQL.

6. Seleziona la regione di destinazione in cui viene creata l'istanza della versione Cloud SQL Enterprise Plus.

7. Nell'elenco a discesa Tipo del job di migrazione, seleziona Continuo perché vuoi eseguire la migrazione delle modifiche continue nel database della versione Cloud SQL Enterprise di origine nell'istanza della versione Cloud SQL Enterprise Plus di destinazione.

8. Esamina i prerequisiti richiesti che vengono generati automaticamente per riflettere la modalità di preparazione dell'ambiente per un job di migrazione. Questi prerequisiti possono includere la configurazione del database Cloud SQL Enterprise di origine e la connessione all'istanza Cloud SQL Enterprise Plus di destinazione.

   Ti consigliamo di completare questi prerequisiti in questo passaggio, ma puoi completarli in qualsiasi momento prima di testare o avviare il job di migrazione.

9. Fai clic su Salva e continua.

Specifica le informazioni sul profilo di connessione di origine

1. Nell'elenco a discesa Seleziona profilo di connessione di origine, seleziona il profilo di connessione che hai creato.

2. Fai clic su Salva e continua.

Definisci le impostazioni per l'istanza Cloud SQL Enterprise Plus di destinazione

1. Nel campo Password, inserisci una password alfanumerica per l'istanza della versione Cloud SQL Enterprise Plus di destinazione. Questa è la password per l'account amministratore postgres nell'istanza.

2. Nell'elenco a discesa Versione database, seleziona l'istanza di destinazione dall'elenco delle versioni Cloud SQL supportate per il motore del database specificato.

3. Seleziona Enterprise Plus.

4. Nella sezione Scegli regione e zona, seleziona la zona Google Cloud che ti interessa per la nuova Istanza della versione Cloud SQL Enterprise Plus (o lascia Qualsiasi).

5. Seleziona la casella di controllo IP pubblico.

6. Seleziona la forma della macchina per l'istanza della versione Cloud SQL Enterprise Plus. La dimensione del disco deve essere uguale o superiore a quella del database di origine.

7. Definisci il tipo di archiviazione e la capacità di archiviazione per l'istanza Cloud SQL.

8. Per creare la nuova istanza, fai clic su Crea e continua.

9. Nella finestra di dialogo visualizzata, fai clic su Crea destinazione e continua. La creazione dell'istanza potrebbe richiedere alcuni minuti.

   Importante: questa procedura crea un'istanza Cloud SQL Enterprise Plus. Gli addebiti vengono effettuati in base alla configurazione che selezioni.

Configurare la connettività

1. Nell'elenco a discesa Metodo di connettività, seleziona Lista consentita IP.

   Nota : una lista consentita di IP è una funzionalità di sicurezza che viene spesso utilizzata per limitare e controllare l'accesso ai dati nei database di origine e di destinazione solo per gli utenti attendibili. Puoi utilizzare le liste consentite di IP per creare elenchi di indirizzi IP o intervalli IP attendibili da cui gli utenti possono accedere a questi dati. Inoltre, per utilizzare le liste consentite IP, devi aprire il database o il firewall di origine alle connessioni in entrata dall'istanza della versione Cloud SQL Enterprise Plus di destinazione.

   Potrebbero essere necessari alcuni minuti prima che gli indirizzi IP vengano visualizzati nella regione Indirizzi IP di uscita di destinazione.

2. Per utilizzare gli indirizzi IP in uscita dell'istanza della versione Cloud SQL Enterprise Plus di destinazione al fine di stabilire una connessione all'istanza della versione Cloud SQL Enterprise di origine, completa i seguenti passaggi:

   1. Nella regione Indirizzi IP in uscita di destinazione, fai clic su Copia tutto.
   2. Apri un'altra scheda del browser.

   3. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

      Vai a Istanze Cloud SQL

   4. Fai clic sull'istanza di origine.
   5. Fai clic su Modifica.
   6. Nella sezione Personalizza la tua istanza, fai clic sul menu Mostra opzioni di configurazione se viene visualizzato.
   7. Fai clic sulla sezione Connessioni.
   8. Fai clic su Aggiungi una rete.
   9. Nel campo Nome, fornisci un nome per la rete che rappresenti il primo indirizzo IP che hai copiato, ad esempio My First Network. Questa rete viene utilizzata per stabilire una connessione tra le istanze di database Cloud SQL Enterprise Edition di origine e Cloud SQL Enterprise Plus Edition di destinazione.
   10. Nel campo Rete, inserisci il primo indirizzo IP che hai copiato, seguito da /32. In questo modo la rete può accettare solo connessioni da questo indirizzo IP.
   11. Fai clic su Fine.
   12. Ripeti questi passaggi per ciascun indirizzo IP copiato.
   13. Fai clic su Salva. Cloud SQL riavvia l'istanza della versione Cloud SQL Enterprise di origine per rendere effettive le modifiche apportate alla configurazione.

3. Nella scheda contenente il job di migrazione, fai clic su Salva e continua.

Testa, crea e avvia il job di migrazione

1. Rivedi le impostazioni che hai scelto per il job di migrazione.

2. Verifica che l'origine sia stata configurata correttamente, che le istanze della versione Cloud SQL Enterprise di origine e della versione Cloud SQL Enterprise Plus di destinazione siano in grado di comunicare e che il job di migrazione sia valido:

   1. Fai clic su Testa il job.

   2. Verifica che sia visualizzato lo stato Your migration job test was successful!.

   Se il test non riesce, puoi risolvere il problema nella parte appropriata della il flusso e tornare a eseguire un nuovo test.

3. Per creare il job di migrazione e avviarlo immediatamente, fai clic su Crea & avvia job.

4. Nella finestra di dialogo visualizzata, fai clic su Crea e avvia.

5. Nella pagina Job di migrazione, verifica che lo stato del job di migrazione sia Starting.

6. Dopo qualche minuto, verifica che lo stato diventi Running.

Verifica il job di migrazione

Per verificare che Database Migration Service abbia utilizzato il job di migrazione per eseguire la migrazione dei dati dall'istanza del database Cloud SQL Enterprise di origine all'istanza del database Cloud SQL Enterprise Plus di destinazione, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Istanze SQL.

   Vai a Istanze Cloud SQL

2. Fai clic sulla voce della replica di lettura del job di migrazione.

   Nota: assicurati che la versione Cloud SQL per questa voce sia Enterprise Plus e non Enterprise.
3. Fai clic sull'icona Attiva Cloud Shell accanto al campo Cerca.

4. Al prompt, utilizza il comando gcloud sql connect per connetterti all'istanza del database Cloud SQL Enterprise Plus di destinazione.

   gcloud sql connect DESTINATION_INSTANCE_NAME --user=postgres

   Sostituisci DESTINATION_INSTANCE_NAME con il nome dell'istanza della versione Cloud SQL Enterprise Plus di destinazione.

5. Facoltativo: se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
6. Al prompt Inserisci password, inserisci la password fornita in Definisci le impostazioni per l'istanza della versione Cloud SQL Enterprise Plus di destinazione.

7. Al prompt postgres, per elencare i database e verificare che vedi l'istanza del database della versione Cloud SQL Enterprise di origine, inserisci \list.
8. Al prompt postgres, per visualizzare le tabelle associate a questa istanza di database, inserisci \connect SOURCE_DB_NAME. Il nome della richiesta cambia da postgres a SOURCE_DB_NAME.
9. Nel prompt SOURCE_DB_NAME, per visualizzare le tabelle di questa istanza, inserisci \dt.
10. Al prompt SOURCE_DB_NAME, per concedere all'utente l'autorizzazione ad accedere ai dati nelle tabelle di questa istanza, inserisci GRANT cloudsqlexternalsync to USER;.

    Sostituisci USER con il nome dell'utente che hai utilizzato per connetterti all'istanza di database Cloud SQL Enterprise Plus di destinazione.

11. Al prompt SOURCE_DB_NAME, per visualizzare le informazioni replicate da una tabella nell'istanza del database Cloud SQL Enterprise di origine, inserisci SELECT * from TABLE_NAME;.
12. Verifica di visualizzare le informazioni corrette nella tabella.

Promuovi il job di migrazione

La promozione del job di migrazione sostituisce l'istanza del database della versione Cloud SQL Enterprise di origine con l'istanza del database della versione Cloud SQL Enterprise Plus di destinazione come database principale.

Per promuovere il job di migrazione, completa i seguenti passaggi:

1. Torna alla pagina Job di migrazione.

2. Fai clic sul job di migrazione che vuoi promuovere. Viene visualizzata la pagina Dettagli job di migrazione.

3. Interrompi tutte le scritture nel database Cloud SQL Enterprise di origine.

   Importante: prima di interrompere le scritture sul database di origine, attendi che il ritardo di replica sia minimo.

   Devi arrestare tutte le scritture su questo database perché, promuovendo il job di migrazione, il database di destinazione della versione Cloud SQL Enterprise Plus diventa il tuo database principale.

4. Verifica che il ritardo di replica sia minimo.

5. Fai clic sul job di migrazione da promuovere. Questo job ha lo stato Running.

6. Per promuovere il job di migrazione, fai clic su Promuovi.

7. Nella finestra di dialogo visualizzata, fai clic su Promuovi.

8. Verifica che lo stato del job di migrazione sia Promote in progress. Dopo qualche minuto, verifica che lo stato cambi in Completed.

La nuova istanza di database della versione Cloud SQL Enterprise Plus è pronta per l'uso.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, utilizza la console Google Cloud per eliminare il job di migrazione, il profilo di connessione, l'istanza della versione Cloud SQL Enterprise di origine e il progetto se non ti servono.

Passaggi successivi

• Scopri di più sulle funzionalità principali della versione Cloud SQL Enterprise Plus.
• Scopri di più sui miglioramenti delle prestazioni per la versione Cloud SQL Enterprise Plus.
• Scopri di più sul supporto delle regioni per la versione Cloud SQL Enterprise Plus.
• Scopri di più sui prezzi per la versione Cloud SQL Enterprise Plus.