Eseguire l'upgrade di un'istanza alla versione Cloud SQL Enterprise Plus utilizzando il peering VPC

MySQL   |  PostgreSQL   |  SQL Server

Nota: questa pagina contiene le 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 VPC privato di Database Migration Service per eseguire l'upgrade di un'istanza 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 ulteriori informazioni su questi miglioramenti, consulta Miglioramenti delle prestazioni.

Per attivare questi miglioramenti per le istanze Cloud SQL Enterprise esistenti, devi eseguirne l'upgrade alla versione Cloud SQL Enterprise Plus utilizzando il servizio di migrazione del database.

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 di avere il ruolo Amministratore di migrazione del database 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. Fonti diverse funzionano meglio con alcuni metodi di connettività rispetto ad altri. In questa pagina, presupponiamo che tu stia utilizzando un'istanza Cloud SQL Enterprise Edition in un ambiente in cui puoi configurare la rete per aggiungere una regola del 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 hai il database postgres per l'istanza di origine, creane uno. Per ulteriori informazioni, consulta Creare un database nell'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 tutti gli altri database nell'istanza Cloud SQL Enterprise Edition 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 non ha una chiave primaria e non fa parte dei database di cui non è stata 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. Utilizza questo utente per connetterti all'istanza di origine e configuralo come utente nella pagina Profili di connessione. Questo utente deve disporre di determinati privilegi su ciascuno dei database migrati e sul database postgres predefinito.

   Per impostare questi privilegi, connettiti all'istanza ed esegui i seguenti 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 ogni database di cui vuoi eseguire la migrazione.
   3. GRANT SELECT on ALL TABLES in SCHEMA pglogical to USER su tutti i database per ottenere 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 i flag cloudsql.logical_decoding e cloudsql.enable_pglogical, 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 di 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 in modo che le modifiche alla configurazione apportate ai flag possano essere applicate.

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

Recuperare le informazioni dall'istanza di origine

Per eseguire l'upgrade di un'istanza Cloud SQL Enterprise di origine, devi recuperare le seguenti informazioni:

• L'indirizzo IP privato dell'istanza. Utilizza questo indirizzo IP quando crei un profilo di connessione in Database Migration Service.
• Il nome della rete VPC che consente l'istanza di destinazione della versione Cloud SQL Enterprise Plus per comunicare direttamente con l'istanza di origine della versione Cloud SQL Enterprise. Devi usare questo VPC rete quando crei un job di migrazione in Database Migration Service.

Per recuperare le informazioni dall'istanza Cloud SQL Enterprise di origine, completa i seguenti passaggi:

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

   Vai a Istanze Cloud SQL

2. Fai clic sull'istanza di origine.
3. Nella sezione Connetti a questa istanza, fai clic su Copia negli appunti nel campo Indirizzo IP privato.
4. Nella parte superiore della pagina, fai clic su Modifica.
5. Espandi la sezione Connessioni.
6. Nella sezione Networking associato, prendi nota del nome della rete VPC che compare nel campo Rete.

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 del 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 connettersi 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. Nel campo Nome host o Indirizzo IP, sostituisci il valore con l'indirizzo IP privato che hai copiato in Recupero delle informazioni dall'istanza Cloud SQL Enterprise Edition di origine.

8. Per eseguire l'autenticazione nell'istanza di origine, inserisci un nome utente e una password. Poi, fai clic su Continua.

   Nota: Cloud SQL compila automaticamente il campo Porta con le informazioni sull'istanza di origine. Se questo campo è vuoto, inserisci il numero di porta appropriato.

9. 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 None.

10. Fai clic su Continua.

11. Dal menu a discesa Test di connettività, seleziona Non definito.

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.
• Test del job di migrazione per verificare che le informazioni di connessione fornite per il job siano valide.

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 di job di migrazione, seleziona Continuo perché vuoi che le modifiche in corso nel database della versione Cloud SQL Enterprise di origine vengano migrate all'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 farlo 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 della versione Cloud SQL Enterprise Plus di destinazione

1. Nel campo Password, inserisci una password alfanumerica per l'istanza 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 desiderata per la nuova istanza della versione Cloud SQL Enterprise Plus (oppure lascia l'impostazione Qualsiasi).

5. Seleziona la casella di controllo IP privato.

6. Dall'elenco a discesa VPC, seleziona la rete VPC che hai annotato in Recuperare informazioni dall'istanza della versione Cloud SQL Enterprise di origine.

7. Seleziona la forma della macchina per l'istanza della versione Cloud SQL Enterprise Plus. Le dimensioni del disco devono essere uguali o superiori a quelle del database di origine.

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

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

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

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

Configura la connettività

1. Scegli come stabilire la connettività tra i database Cloud SQL Enterprise di origine e Cloud SQL Enterprise Plus di destinazione. Per questa procedura, utilizza il menu a discesa Metodo di connettività per selezionare L'origine e la destinazione usano un IP privato.
2. Dall'elenco a discesa VPC, seleziona la rete VPC in cui si trova l'istanza Cloud SQL Enterprise di origine. Questa è la rete VPC che hai annotato in Recuperare informazioni dall'istanza della versione Cloud SQL Enterprise di origine.
3. Fai clic su Configura 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 Cloud SQL Enterprise di origine e Cloud SQL Enterprise Plus di destinazione siano in grado di comunicare tra loro e che il job di migrazione sia valido:

   1. Fai clic su Testa il job.

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

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

3. Per creare il job di migrazione e avviarlo immediatamente, fai clic su Crea e 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 cambi in Running.

Verifica il job di migrazione

Per confermare che Database Migration Service ha 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 passaggi seguenti:

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 di vedere l'istanza del database Cloud SQL Enterprise Edition 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 del prompt 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 la connessione all'istanza del database della versione 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 che nella tabella siano visualizzate le informazioni corrette.

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 nel database di origine, attendi che il ritardo di replica sia minimo.

   Devi interrompere tutte le scritture in questo database perché, promuovendo il job di migrazione, il database Cloud SQL Enterprise Plus di destinazione diventa il tuo database principale.

4. Verifica che il ritardo di replica sia minimo.

5. Fai clic sul job di migrazione che vuoi promuovere. Lo stato di questo job è 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 Cloud SQL Enterprise Edition 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.