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 di migrazione del database assegnato al tuo account utente.

   Vai alla pagina IAM

Requisiti

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

In questa guida rapida, seleziona PostgreSQL per il Motore del database di origine e Lista consentita IP come metodo di rete.

Creazione di un profilo di connessione di origine

Creando un profilo di connessione, crei un record contenente 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 autonoma (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 del 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 auto-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 autenticarti nell'istanza di origine.
   • (Facoltativo) Se prevedi di trasferire informazioni sensibili su una rete pubblica (utilizzando liste consentite 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 Nessuna.

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 dell'area geografica 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à dell'area geografica.

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
• Seleziona il profilo di connessione che hai 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 assicurarti che i dati di connessione forniti per il job siano validi

Definisci le impostazioni per il job di migrazione

1. Vai alla pagina dei job di migrazione di Database Migration Service nella console Google Cloud.

   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. Mantieni 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 verrà creata l'istanza di destinazione.

7. Imposta Tipo di 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 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 di origine e il collegamento all'istanza di database Cloud SQL di destinazione. È preferibile 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 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 consentire a Database Migration Service di crearne una automaticamente.

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

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

4. Seleziona la Google Cloud Zona desiderata per la nuova istanza Cloud SQL (o lasciala impostata su "Qualsiasi").

5. Seleziona la casella di controllo IP pubblico perché, per questa guida rapida, utilizzi la lista consentita IP come metodo di rete. Questo metodo funziona configurando il server di database di origine in modo che accetti le 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 superiore a quella 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 alcuni minuti.

   Importante: questa procedura crea un'istanza Cloud SQL. Ti verrà addebitato il costo 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.

Configurare la connettività

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

   La lista consentita di IP è una funzionalità di sicurezza spesso utilizzata per limitare e controllare l'accesso ai dati nei database di origine e di destinazione solo da parte di utenti attendibili. Puoi utilizzare le liste consentite 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 in uscita della 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 utilizzalo per configurare il firewall di rete in modo che il server di database di origine accetti connessioni da questo indirizzo IP.
   
   1. Aggiorna il file pg_hba.conf o i gruppi di sicurezza Amazon RDS in modo da accettare connessioni da questo indirizzo IP.
   2. Nelle regole del 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.

Testa e crea il job di migrazione

1. Controlla le impostazioni che hai scelto 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 siano in grado di comunicare tra loro e che il job di migrazione sia valido.

3. Verifica di visualizzare lo stato "Verifiche superate correttamente".

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

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

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

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

Verifica il job di migrazione

In questa sezione confermi 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 nella console Google Cloud.
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. Al prompt di Google Cloud Shell, premi Invio.
5. (Facoltativo) Se viene visualizzata la 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 Definire le impostazioni per l'istanza Cloud SQL di destinazione.

8. Al prompt postgres, inserisci \list per elencare i database e verificare di vedere 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 ad 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 di visualizzare le informazioni corrette nella tabella.

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

Promuovi il job di migrazione

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

1. Torna alla pagina Job di migrazione.

2. Fai clic sul job di migrazione da 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 da promuovere. Questo job deve avere lo stato "In esecuzione".

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

8. Fai nuovamente clic su PROMOVI nella finestra di dialogo successiva.

9. Verifica che lo stato del job di migrazione sia "Promozione in corso". Dopo alcuni minuti, 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 su 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.