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 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 provider cloud. Poiché non possiamo conoscere le specifiche del tuo ambiente, non possiamo fornire passaggi dettagliati per la configurazione di rete.

In questa guida introduttiva, seleziona PostgreSQL per il Motore del database di origine, AlloyDB per PostgreSQL per il Motore del database di destinazione e Peering VPC 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 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 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.

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 AlloyDB 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 AlloyDB di destinazione
• Configurazione della connettività tra le istanze del database di origine e di destinazione
• Testare il 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. In questa guida rapida, seleziona AlloyDB per PostgreSQL.

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 AlloyDB 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 la connessione all'istanza del database AlloyDB 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.

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 i cluster AlloyDB ad alta disponibilità. Possono pubblicare dati di più di una zona 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. Ti servirà la password per accedere al 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 il peering VPC, seleziona il VPC in cui risiede.
   4. Se vuoi, 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 indicatore:
   1. Fai clic su AGGIUNGI FLAG.
   2. Seleziona un indicatore dall'elenco Nuovo indicatore 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à in stato "Bootstrap" mentre viene gestito da Database Migration Service. In "Avvio", non potrai eseguire alcuna operazione sul cluster. Se vuoi comunque eliminare il cluster, puoi farlo utilizzando gcloud con l'opzione --force.

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 Peering VPC come metodo di rete.
Rivedi la rete VPC del database di origine. 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 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. Al prompt di Cloud Shell, premi Invio.
5. (Facoltativo) Se viene visualizzata la 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 Definire e creare l'istanza AlloyDB di destinazione.

7. Al prompt postgres, inserisci \list per elencare i database e verificare di vedere 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 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.

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 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 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 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 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 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 AlloyDB è 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, 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.