Esegui la migrazione di un database a Cloud SQL per PostgreSQL utilizzando Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL ad AlloyDB

Questa guida rapida mostra come utilizzare Database Migration Service per eseguire la migrazione dei dati a Cloud SQL per PostgreSQL. Le risorse create in questa guida rapida in genere costano meno di un dollaro (USD), a condizione che tu completi i passaggi, inclusa la pulizia, in modo tempestivo.

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. Enable the Database Migration Service API.

   Enable the API

7. Assicurati di avere il ruolo Amministratore migrazione database assegnato al tuo account utente.

   Vai alla pagina IAM

Requisiti

Database Migration Service offre una serie di opzioni di database di origine e metodi di connettività. Alcune fonti funzionano meglio con determinati metodi di connessione rispetto ad altri. In questa guida rapida, presupponiamo che tu stia utilizzando un database PostgreSQL standalone in un ambiente in cui puoi configurare la rete per aggiungere una regola firewall in entrata. Il database di origine può essere on-premise o in un provider cloud. Poiché non possiamo conoscere i dettagli del tuo ambiente, non possiamo fornire passaggi dettagliati per la configurazione della rete.

In questa guida rapida, selezionerai PostgreSQL per Motore del database di origine e IP consentiti come metodo di networking.

Creazione di un profilo di connessione di origine

Creando un profilo di connessione, crei un record che contiene informazioni sul database di origine. Database Migration Service utilizza le informazioni nel profilo di connessione per eseguire la migrazione dei dati dal database di origine all'istanza del database Cloud SQL di destinazione.

1. Vai alla pagina Profili di connessione del servizio di migrazione del database nella console Google Cloud .

   Vai alla pagina Profili di connessione del servizio di migrazione del database

2. Fai clic su CREA PROFILO.

3. Nella pagina Crea un profilo di connessione, seleziona Origine dall'elenco Ruolo profilo.

4. Nell'elenco Motore del database, seleziona uno dei seguenti tipi di classificazione del database di origine:

   • Un'istanza PostgreSQL standalone (PostgreSQL)
   • Un'istanza Cloud SQL per PostgreSQL esistente (Cloud SQL per PostgreSQL)
   • Un'istanza Amazon RDS per PostgreSQL (Amazon RDS per PostgreSQL)

   Per questa guida rapida, seleziona PostgreSQL.

4. Fornisci le seguenti informazioni:
   • Nel campo Nome profilo di connessione, inserisci un nome per il profilo di connessione per il tuo database di origine, ad esempio My Connection Profile.
   • Mantieni l'ID profilo di connessione generato automaticamente.
   • Inserisci le informazioni sulla connettività:
     • Se esegui la replica da un database self-hosted, inserisci il nome host o l'indirizzo IP (dominio o IP) e la porta per accedere all'host. La porta PostgreSQL predefinita è 5432.
     • Se esegui la replica da un database Cloud SQL, seleziona l'istanza Cloud SQL dall'elenco a discesa.
   • Inserisci un nome utente e una password per l'autenticazione all'istanza di origine.
   • (Facoltativo) Se prevedi di trasferire informazioni sensibili su una rete pubblica (utilizzando elenchi consentiti di IP), ti consigliamo di utilizzare la crittografia SSL/TLS per la connessione tra i database di origine e di destinazione. In caso contrario, mantieni il valore predefinito Nessuno.

5. Nella sezione Regione del profilo di connessione della pagina, seleziona la regione in cui vuoi salvare il profilo di connessione.

   I profili di connessione, come tutte le risorse, vengono salvati in una regione. La selezione della regione non ha effetti su quali job di migrazione possono utilizzarli o su quali regioni possono collegarsi alla località dei dati stessa, ma può incidere sulla disponibilità in caso di tempo di inattività della regione.

6. 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 di origine all'istanza del database Cloud SQL di destinazione.

La creazione di un job di migrazione include:

• Definizione delle impostazioni per il job
• Selezionando il profilo di connessione creato per il database di origine (profilo di connessione di origine)
• Definizione delle impostazioni per l'istanza del database Cloud SQL 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. Vai alla pagina Job di migrazione del servizio di migrazione del database nella Google Cloud console.

   Vai alla pagina dei job di migrazione di Database Migration Service

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. Conserva l'ID job di migrazione generato automaticamente.

5. Apri l'elenco a discesa Motore del database di origine e seleziona il tipo di classificazione del database di origine.

6. Seleziona la regione di destinazione in cui creare l'istanza di destinazione.

7. Imposta Tipo del job di migrazione su "Continuo" perché vuoi che le modifiche in corso nel database di origine vengano migrate all'istanza del database Cloud SQL di destinazione.

8. Esamina i prerequisiti richiesti generati automaticamente per riflettere il modo in cui l'ambiente deve essere preparato per un job di migrazione. Questi prerequisiti possono includere la configurazione del database di origine e la sua connessione all'istanza di database Cloud SQL di destinazione. È consigliabile completare questi prerequisiti in questo passaggio, ma puoi farlo in qualsiasi momento prima di testare o avviare il job di migrazione. Per ulteriori informazioni su questi prerequisiti, consulta Configurare l'origine.

9. Fai clic su SALVA E CONTINUA.

Specifica le informazioni sul profilo di connessione di origine

1. Apri l'elenco a discesa Seleziona profilo di connessione di origine e seleziona il profilo di connessione che hai creato.

2. Fai clic su SALVA E CONTINUA.

Definisci le impostazioni per l'istanza Cloud SQL di destinazione

1. Fornisci un ID istanza di destinazione per l'istanza Cloud SQL. Per impostazione predefinita, l'ID del job di migrazione è precompilato in questo campo. Puoi mantenere questo nome o inserirne un altro.

2. Fornisci una password alfanumerica per l'istanza Cloud SQL di destinazione. Questa sarà la password dell'account amministratore postgres nell'istanza.

   Puoi inserire la password manualmente o fare clic su GENERA per farla creare automaticamente da Database Migration Service.

   Suggerimento:per visualizzare la password in testo normale, fai clic sull'icona Mostra. Questa icona ha l'aspetto di un occhio.

3. Scegli la Versione database per l'istanza di destinazione dall'elenco delle versioni di Cloud SQL supportate per il motore del database specificato.

4. Seleziona la Google Cloud zona desiderata per la nuova istanza Cloud SQL (o lascia l'impostazione "Qualsiasi").

5. Seleziona la casella di controllo IP pubblico perché, per questa guida rapida, utilizzi la lista consentita IP come metodo di networking. Questo metodo funziona configurando il server di database di origine in modo che accetti connessioni dall'indirizzo IP in uscita dell'istanza Cloud SQL.

   Per altri metodi di networking, come il tunnel SSH inverso, il peering VPC o la VPN, seleziona la casella di controllo IP privato.

6. Seleziona il Tipo di macchina per l'istanza Cloud SQL. La dimensione del disco deve essere uguale o maggiore della dimensione del database di origine.

7. Definisci il Tipo di archiviazione e la Capacità dello spazio di archiviazione per l'istanza Cloud SQL.

8. Fai clic su CREA E CONTINUA per creare la nuova istanza.

9. Fai clic su CREA DESTINAZIONE E CONTINUA nella finestra di dialogo successiva. La creazione dell'istanza potrebbe richiedere diversi minuti.

   Importante: questa procedura crea un'istanza Cloud SQL. Ti vengono addebitati costi in base alla configurazione selezionata.
   Nota: dopo la creazione dell'istanza di destinazione, alcune impostazioni del job di migrazione non possono più essere modificate. Non puoi modificare il motore del database o il tipo di migrazione.

Configura la connettività

1. Scegli il metodo di networking che vuoi utilizzare per stabilire la connettività tra i database di origine e di destinazione. Per questa guida rapida, utilizza l'elenco Metodo di connettività per selezionare Lista consentita IP come metodo di networking.

   L'elenco consentito di indirizzi IP è una funzionalità di sicurezza spesso utilizzata per limitare e controllare l'accesso ai dati nei database di origine e di destinazione solo agli utenti attendibili. Puoi utilizzare le liste consentite di indirizzi 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 di IP, devi aprire il database o il firewall di origine alle connessioni in entrata dall'istanza Cloud SQL di destinazione.

   Potrebbero essere necessari alcuni minuti prima che un indirizzo IP venga visualizzato nel campo Indirizzo IP di uscita di destinazione.

2. Se l'indirizzo IP di origine non è precompilato in questo campo, copia l'indirizzo IP in uscita dell'istanza Cloud SQL dalla console e usalo per configurare il firewall di rete per il server di database di origine in modo che accetti connessioni da questo indirizzo IP.
   
   1. Aggiorna il file pg_hba.conf o i gruppi di sicurezza Amazon RDS per accettare connessioni da questo indirizzo IP.
   2. Nelle regole firewall, crea una regola in entrata (o Ingress) per consentire le connessioni sulla porta 5432 dall'indirizzo IP di connettività dell'istanza Cloud SQL di destinazione.
3. Fai clic su CONFIGURA E CONTINUA per completare la configurazione del profilo di connessione.

Configura database di migrazione

Puoi selezionare i database di cui vuoi eseguire la migrazione.

1. Nell'elenco Database di cui eseguire la migrazione, seleziona Tutti i database.

   Tutti i database esistenti nell'origine vengono selezionati per la migrazione.

2. Fai clic su Salva e continua.

Testa e crea il job di migrazione

1. Controlla le impostazioni scelte per il job di migrazione.

2. Fai clic su TEST JOB per verificare che l'origine sia stata configurata correttamente, che le istanze di origine e di destinazione possano comunicare tra loro e che il job di migrazione sia valido.

3. Verifica che venga visualizzato lo stato "Verifiche superate correttamente".

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

4. Fai clic su CREA E AVVIA JOB per creare il job di migrazione e avviarlo immediatamente.

5. Fai clic su AVVIA nella finestra di dialogo successiva.

6. Nella pagina Job di migrazione, verifica che lo stato del job di migrazione sia "Avvio in corso". Dopo qualche minuto, verifica che lo stato cambi in "In esecuzione".

Verificare il job di migrazione

In questa sezione, confermerai che Database Migration Service ha utilizzato il job di migrazione per eseguire la migrazione dei dati dall'istanza del database di origine all'istanza del database Cloud SQL di destinazione.

1. Vai alla pagina Istanze SQL in Google Cloud console.
2. Fai clic sulla voce della replica di lettura del job di migrazione.
3. Fai clic sull'icona Attiva Cloud Shell visualizzata nella parte in alto a destra della pagina.
4. Nel prompt di Google Cloud Shell, premi Invio.
5. (Facoltativo) Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
6. Connettiti all'istanza di database Cloud SQL di destinazione.
7. Al prompt Inserisci password, inserisci la password che hai fornito o che Database Migration Service ha generato per te in Definisci le impostazioni per l'istanza Cloud SQL di destinazione.

8. Al prompt postgres, inserisci \list per elencare i database e verificare che venga visualizzata l'istanza del database di origine.
9. Al prompt postgres, inserisci \connect SOURCE_DB_NAME perché vuoi visualizzare le tabelle associate a questa istanza di database. Il nome della richiesta cambia da postgres a SOURCE_DB_NAME.
10. Al prompt SOURCE_DB_NAME, inserisci \dt per visualizzare le tabelle di questa istanza.
11. Al prompt SOURCE_DB_NAME, inserisci GRANT cloudsqlexternalsync to USER; perché vuoi concedere a questo utente l'autorizzazione per accedere ai dati nelle tabelle di questa istanza.

    Sostituisci USER con il nome dell'utente che hai utilizzato per connetterti all'istanza del database di destinazione.

12. Al prompt SOURCE_DB_NAME, inserisci SELECT * from TABLE_NAME; per visualizzare le informazioni replicate da una tabella nell'istanza del database di origine.
13. Verifica che nella tabella siano visualizzate le informazioni corrette.

Ciò conferma che Database Migration Service ha eseguito la migrazione dei dati.

Promuovere il job di migrazione

Ora puoi promuovere il job di migrazione. Di conseguenza, l'istanza del database Cloud SQL di destinazione sostituisce l'istanza del database di origine come database principale.

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. Attendi che il ritardo di replica tenda a zero.

4. Interrompi tutte le scritture nel database di origine.

   Devi interrompere tutte le scritture nel database di origine perché, promuovendo il job di migrazione, il database Cloud SQL di destinazione diventerà il tuo database principale.

5. Attendi che il ritardo di replica sia pari a zero.

6. Fai clic sul job di migrazione che vuoi promuovere. Questo job deve avere lo stato "In esecuzione".

7. Fai clic su PROMUOVI per promuovere il job di migrazione.

8. Fai di nuovo clic su PROMUOVI nella finestra di dialogo successiva.

9. Verifica che il job di migrazione abbia lo stato "Promozione in corso". Dopo qualche minuto, verifica che lo stato cambi in "Completato".

La nuova istanza del database Cloud SQL è 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, segui questi passaggi.

1. Utilizza la console Google Cloud per eliminare il job di migrazione, il profilo di connessione, l'istanza Cloud SQL e il progetto se non ti servono.

Passaggi successivi

• Scopri di più su come gestire i profili di connessione.
• Scopri di più sugli stati dei job di migrazione.
• Scopri di più sulle metriche dei job di migrazione.