Esegui la migrazione di un database ad AlloyDB 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 ad AlloyDB 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 il motore del database di origine, AlloyDB per PostgreSQL per il motore del database di destinazione e peering VPC 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 AlloyDB 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.

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 AlloyDB 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 AlloyDB 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. In questa guida rapida, seleziona AlloyDB per PostgreSQL.

6. Seleziona la regione di destinazione in cui creare 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 nell'istanza del database AlloyDB 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 del database AlloyDB 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.

Crea un cluster AlloyDB di destinazione

I cluster sono la risorsa di primo livello in AlloyDB. Per creare un cluster di destinazione:

1. Scegli un tipo di cluster. Al momento, Database Migration Service supporta cluster AlloyDB ad alta disponibilità. Possono pubblicare dati da più zone in una regione, senza pool di lettura.
2. Fai clic su CONTINUA.
3. Configura il cluster:
   1. Nel campo ID cluster, inserisci un ID per il cluster.
   2. Nel campo Password, inserisci una password per l'utente postgres predefinito. Avrai bisogno della password per accedere al tuo database.
   3. Nel campo Rete, seleziona un percorso di rete per definire le risorse disponibili durante l'impostazione della connettività di migrazione. I cluster possono essere configurati solo con un percorso di rete IP privato. Se prevedi di connetterti al database di origine tramite peering VPC, seleziona il VPC in cui si trova.
   4. (Facoltativo) Seleziona il nome di un intervallo IP allocato per specificare gli indirizzi IP con cui l'istanza può connettersi.
   5. Fai clic su CONTINUA.
4. Configura l'istanza principale. Un'istanza principale determina la capacità di calcolo di un cluster e supporta le operazioni di lettura e scrittura:
1. Nel campo ID istanza, inserisci un ID per l'istanza principale.
2. Seleziona un tipo di macchina.
3. (Facoltativo) Imposta i flag per l'istanza. Puoi utilizzare i flag per personalizzare l'istanza. Per informazioni sui flag supportati, consulta la documentazione di AlloyDB. Per ogni segnalazione:
   1. Fai clic su AGGIUNGI FLAG.
   2. Seleziona un flag dall'elenco Nuovo flag database.
   3. Specifica un valore per il flag.
   4. Fai clic su FINE.
5. Fai clic su SALVA E CONTINUA.
6. Conferma la tua scelta facendo clic su CREA DESTINAZIONE E CONTINUA.
7. Attendi il completamento della creazione dell'istanza di destinazione.

Il cluster AlloyDB sarà nello stato "Bootstrap" mentre viene gestito da Database Migration Service. Durante il "bootstrap", non potrai eseguire alcuna operazione sul cluster. Se vuoi comunque eliminare il cluster, puoi farlo utilizzando gcloud con l'opzione --force.

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 Peering VPC come metodo di networking.
2. Rivedi la rete VPC del database di origine. 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, 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 AlloyDB di destinazione.

1. Vai alla pagina Cluster di AlloyDB nella console Google Cloud .

   Vai alla pagina Cluster AlloyDB

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 Cloud Shell, premi Invio.
5. (Facoltativo) Se viene visualizzata una finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
6. Al prompt Inserisci password, inserisci la password che hai fornito o che Database Migration Service ha generato per te in Definisci e crea l'istanza AlloyDB di destinazione.

7. Al prompt postgres, inserisci \list per elencare i database e verificare che venga visualizzata l'istanza del database di origine.
8. 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.
9. Al prompt SOURCE_DB_NAME, inserisci \dt per visualizzare le tabelle di questa istanza.
10. Al prompt SOURCE_DB_NAME, inserisci GRANT alloydbexternalsync 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.

11. Al prompt SOURCE_DB_NAME, inserisci SELECT * from TABLE_NAME; per visualizzare le informazioni replicate da una tabella nell'istanza del database di origine.
12. 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 AlloyDB 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é, con la promozione del job di migrazione, il database AlloyDB 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 AlloyDB è 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, il cluster AlloyDB 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.