Esegui la migrazione di un database ad AlloyDB per PostgreSQL utilizzando Database Migration Service | Database Migration Service for PostgreSQL to AlloyDB

Questa pagina è stata tradotta dall'API Cloud Translation.

MySQL | PostgreSQL | PostgreSQL ad AlloyDB

Eseguire la migrazione di un database ad AlloyDB per PostgreSQL

Prima di iniziare

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Database Migration Service API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API
Assicurati di avere il ruolo Amministratore della migrazione del 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à. Fonti diverse funzionano meglio con alcuni 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.

Vai alla pagina Profili di connessione di Database Migration Service nella console Google Cloud .

Vai alla pagina Profili di connessione di Database Migration Service
Fai clic su CREA PROFILO.
Nella pagina Crea un profilo di connessione, seleziona Origine dall'elenco Ruolo profilo.
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.

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

Vai alla pagina Job di migrazione di Database Migration Service nella console Google Cloud .

Vai alla pagina dei job di migrazione di Database Migration Service
Fai clic su CREA JOB DI MIGRAZIONE.
Nel campo Nome job di migrazione, inserisci un nome per il job di migrazione, ad esempio My Migration Job.
Conserva l'ID job di migrazione generato automaticamente.
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.
Seleziona la regione di destinazione in cui creare l'istanza di destinazione.
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.
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 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 Configura l'origine.
Fai clic su SALVA E CONTINUA.

Specifica le informazioni sul profilo di connessione di origine

Apri l'elenco a discesa Seleziona profilo di connessione di origine e seleziona il profilo di connessione che hai creato.
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:

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.
Fai clic su CONTINUA.
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 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.
Configura l'istanza principale. Un'istanza principale determina la capacità di calcolo di un cluster e supporta le operazioni di lettura e scrittura:

Nel campo ID istanza, inserisci un ID per l'istanza principale.
Seleziona un tipo di macchina.
(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.

Fai clic su SALVA E CONTINUA.
Conferma la tua scelta facendo clic su CREA DESTINAZIONE E CONTINUA.
Attendi il completamento della creazione dell'istanza di destinazione.

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

Configurare la connettività

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

Nell'elenco Database da migrare, seleziona Tutti i database.
Tutti i database esistenti nell'origine sono selezionati per la migrazione.
Fai clic su Salva e continua.

Testa e crea il job di migrazione

Controlla le impostazioni scelte per il job di migrazione.
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.
Verifica che venga visualizzato lo stato "Verifiche superate correttamente".

Se il test ha esito negativo, puoi risolvere il problema nella parte appropriata del flusso e tornare a eseguire di nuovo il test.
Fai clic su CREA E AVVIA JOB per creare il job di migrazione e avviarlo immediatamente.
Fai clic su AVVIA nella finestra di dialogo successiva.
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.

Vai alla pagina Cluster di AlloyDB nella console Google Cloud .
Vai alla pagina Cluster AlloyDB
Fai clic sulla voce della replica di lettura del job di migrazione.
Fai clic sull'icona Attiva Cloud Shell visualizzata nella parte in alto a destra della pagina.
Nel prompt di Cloud Shell, premi Invio.
(Facoltativo) Se viene visualizzata la finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza.
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.

Al prompt postgres, inserisci \list per elencare i database e verificare che venga visualizzata l'istanza del database di origine.

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.

Al prompt SOURCE_DB_NAME, inserisci \dt per visualizzare le tabelle di questa istanza.

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.

Al prompt SOURCE_DB_NAME, inserisci SELECT * from TABLE_NAME; per visualizzare le informazioni replicate da una tabella nell'istanza del database di origine.

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.

Torna alla pagina Job di migrazione.
Fai clic sul job di migrazione che vuoi promuovere. Viene visualizzata la pagina Dettagli job di migrazione.
Attendi che il ritardo di replica tenda a zero.
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.
Attendi che il ritardo di replica sia pari a zero.
Fai clic sul job di migrazione che vuoi promuovere. Questo job deve avere lo stato "In esecuzione".
Fai clic su PROMUOVI per promuovere il job di migrazione.
Fai di nuovo clic su PROMUOVI nella finestra di dialogo successiva.
Verifica che lo stato del job di migrazione sia "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.

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.