Utilizzare le migrazioni rapide per eseguire la migrazione ad AlloyDB per PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL ad AlloyDB

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive come eseguire migrazioni rapide per le migrazioni PostgreSQL omogenee ad AlloyDB per PostgreSQL.

Panoramica

Le migrazioni rapide sono un flusso di migrazione continua leggero per scenari PostgreSQL omogenei. Con le migrazioni rapide, Database Migration Service può configurare automaticamente tutto ciò che ti serve per eseguire la migrazione dei database: componenti di rete (collegamenti di rete, subnet, configurazioni di connettività privata), profili di connessione e job di migrazione.

Con le migrazioni rapide, puoi spostare i dati in un cluster AlloyDB per PostgreSQL esistente o crearne uno nuovo durante la configurazione della migrazione. Le migrazioni rapide sono più adatte a:

• Migrazioni di base, in cui non è necessario un controllo preciso delle impostazioni di parallelismo del dump dei dati.
• Migrazione del database da un progetto Google Cloud all'altro. Quando configuri una migrazione rapida, puoi creare il cluster di destinazione in un progetto diverso da quello di origine e impostare Database Migration Service in modo che crei il collegamento di rete e la subnet nella rete Virtual Private Cloud (VPC) di un altro progetto.

• Migrazione da origini con un indirizzo IP privato nella tua rete Virtual Private Cloud (VPC), come database autogestiti su Compute Engine o istanze Cloud SQL per PostgreSQL abilitate per il networking privato. Google Cloud

  Le origini ospitate all'esterno Google Cloud potrebbero richiedere componenti di rete aggiuntivi (ad esempio una connessione Cloud VPN) per poter essere raggiunte a un indirizzo IP privato all'interno della rete VPC.

• L'unico metodo supportato per la connettività del database è Private Service Connect con le configurazioni di connettività privata di Database Migration Service. Al database di origine deve essere assegnato un IP privato nella rete VPC. Altri metodi di connettività di origine omogenei (come liste consentite di IP pubblici, tunnel SSH inversi o peering VPC) non sono supportati per le migrazioni rapide.

Per saperne di più sulle migrazioni rapide, consulta la panoramica delle migrazioni rapide nella documentazione principale di Database Migration Service.

Prima di iniziare

1. Verifica se le migrazioni rapide possono supportare completamente il tuo scenario. Consulta Limitazioni della migrazione rapida.
Accedi al tuo Account Google.

Se non ne hai già uno, registrati per creare un nuovo account.

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.

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

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.

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

Verify that billing is enabled for your Google Cloud project.

2. Attiva le API Database Migration Service, Compute Engine, Network Connectivity Center e AlloyDB per PostgreSQL Admin.

   Abilita le API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire migrazioni rapide ad AlloyDB per PostgreSQL con Database Migration Service, chiedi all'amministratore di concedere i ruoli Identity and Access Management (IAM) richiesti per gli account coinvolti nella migrazione nei progetti pertinenti. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso nella documentazione di IAM.

Importante :devi assegnare i ruoli direttamente a questi account. I ruoli ereditati tramite l'iscrizione al gruppo Google non sono supportati per le migrazioni rapide.

Ruoli e autorizzazioni nel progetto di origine

Concedi i seguenti ruoli ad account specifici nel progetto Google Cloud in cui risiede il database origine:

• Per l'account utente che esegue la migrazione: Ruolo Compute Network Admin (roles/compute.networkAdmin)
• Per il account di servizio Database Migration Service del progetto di destinazione: Compute Network Viewer (roles/compute.networkViewer)

  L'account di servizio Database Migration Service viene creato quando abiliti l'API Database Migration Service. L'indirizzo email associato a questo account viene generato automaticamente e non può essere modificato. Questo indirizzo email utilizza il seguente formato:

  [e-mail]

Questi ruoli predefiniti contengono le autorizzazioni necessarie per configurare la connettività nel progetto di database di origine nell'ambito di una migrazione rapida con Database Migration Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie (origine):

Autorizzazioni richieste (origine)

Per eseguire migrazioni di avvio rapido omogenee con Database Migration Service sono necessarie le seguenti autorizzazioni:

Per l'account utente che esegue la migrazione:

• compute.networks.*
• compute.subnetworks.*
• compute.networkAttachments.*

Per il account di servizio Database Migration Service del progetto di destinazione: compute.networkAttachments.get.

Ruoli e autorizzazioni nel progetto di destinazione

Concedi i seguenti ruoli all'account utente che esegue la migrazione nel progetto Google Cloud in cui si trova il database di destinazione:

• Database Migration Admin (roles/datamigration.admin)
• Amministratore AlloyDB (roles/alloydb.admin)

Questi ruoli predefiniti contengono le autorizzazioni necessarie per configurare i componenti di migrazione richiesti nel progetto di database di destinazione nell'ambito di una migrazione rapida con Database Migration Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie (destinazione):

Autorizzazioni obbligatorie (destinazione)

Per eseguire migrazioni di avvio rapido omogenee con Database Migration Service sono necessarie le seguenti autorizzazioni:

• datamigration.*
• alloydb.clusters.create
• alloydb.clusters.get
• alloydb.clusters.list
• alloydb.clusters.update
• alloydb.clusters.delete
• alloydb.instances.create
• alloydb.instances.get
• alloydb.instances.list
• alloydb.instances.update
• alloydb.instances.delete
• alloydb.instances.executeSql
• alloydb.operations.get
• alloydb.users.list
• alloydb.users.get
• alloydb.users.create
• alloydb.users.update
• alloydb.users.delete

Configurazione del database di origine

Per configurare il database PostgreSQL di origine:

1. Crea un account utente dedicato per la migrazione nell'istanza.
   • Per le origini Cloud SQL per PostgreSQL, consulta Crea un utente nella documentazione di Cloud SQL.
   • Per altre origini, consulta la documentazione del provider del database o crea e gestisci gli utenti nella documentazione di PostgreSQL.
2. Assegna i privilegi necessari all'account utente dedicato per la migrazione. Esegui i seguenti comandi per ogni database di cui vuoi eseguire la migrazione:

   -- Grant the REPLICATION attribute
   ALTER ROLE MIGRATION_USER REPLICATION;
   
   -- Grant database-level permissions.
   -- Repeat for each database you want to migrate.
   GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;
   
   -- Grant schema-level usage.
   -- Repeat for each schema in each database you want to migrate.
   GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;

   Sostituisci quanto segue:

   • MIGRATION_USER con il nome dell'account utente di migrazione.
   • DATABASE_NAME con il nome del database di cui vuoi eseguire la migrazione.
   • SCHEMA_NAME con il nome dello schema nel database di cui vuoi eseguire la migrazione.
3. L'account utente di migrazione deve disporre dell'accesso di proprietà alle tabelle di cui esegui la migrazione. Per concedere questo livello di accesso, procedi in uno dei seguenti modi:
   • Assegna il ruolo PostgreSQL SUPERUSER all'account di migrazione.
     • Per le origini Cloud SQL per PostgreSQL, assegna il ruolo cloudsqlsuperuser.
     • Per altre origini, assegna il SUPERUSER ruolo o consulta la documentazione del fornitore del database per un insieme equivalente di autorizzazioni.
   • Aggiungi l'account utente di migrazione al gruppo di utenti proprietario delle tabelle. Esegui questo comando:

     -- Grant table ownership.
     GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;

     Sostituisci quanto segue:

     • TABLE_OWNER_GROUP_NAME con il nome del gruppo di utenti proprietario di ogni tabella di cui vuoi eseguire la migrazione.
     • MIGRATION_USER con il nome dell'account utente di migrazione.
4. Per le tabelle senza chiavi primarie: Database Migration Service non replica le operazioni UPDATE o DELETE per le tabelle senza chiavi primarie durante la fase Change Data Capture (CDC). Se vuoi includere queste operazioni nella replica, modifica le tabelle senza chiavi primarie con REPLICA IDENTITY:

   ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
   ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;

   Sostituisci quanto segue:

   • TABLE_NAME è il nome della tabella che non ha chiavi primarie.
   • INDEX_NAME è l'indice univoco che può monitorare le righe delle tabelle senza chiavi primarie.
5. Configura le impostazioni di replica utilizzando i flag di database.

   Origini autogestite

   Il salvataggio delle modifiche ai flag del database richiede il riavvio completo del database. Gli esempi riportati di seguito utilizzano query SQL per modificare i valori dei flag. Se non riesci a eseguire query SQL direttamente, consulta la documentazione del provider per i passaggi relativi alla modifica di questi flag.

   1. Imposta il parametro wal_level su logical. Esegui questo comando:

      ALTER SYSTEM SET wal_level = 'logical';

   2. Imposta il parametro wal_sender_timeout su 0. Questo valore disabilita il meccanismo di timeout utilizzato per terminare le connessioni di replica inattive. Esegui questo comando:

      ALTER SYSTEM SET wal_sender_timeout = 0;
          

   3. Configura il numero massimo di slot di replica con il parametro max_replication_slots. Questo parametro deve essere impostato almeno sul numero di database che stai migrando per job di migrazione, più alcune riserve per la sincronizzazione delle tabelle.

      Ad esempio, se esegui la migrazione di 5 database e sono stati creati 2 job di migrazione per l'istanza di origine, il numero di slot di replica deve essere almeno 5 * 2 = 10, più il numero di slot di replica già utilizzati.

      Per impostare questo parametro, esegui il comando seguente:

      ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
          

      dove NUMBER_OF_SLOTS rappresenta il numero massimo di slot di replica.
   4. Configura il parametro max_wal_senders in modo che abbia almeno lo stesso valore di max_replication_slots, più il numero di mittenti già utilizzati nella tua istanza.

      Ad esempio, se il parametro max_replication_slots è impostato su 10 e stai già utilizzando due mittenti, il numero di processi del mittente WAL in esecuzione contemporaneamente sarà 10 + 2 = 12.

      Per impostare questo parametro, esegui il comando seguente:

      ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
          

      Dove NUMBER_OF_SENDERS rappresenta il numero di processi del mittente WAL in esecuzione contemporaneamente.
   5. Imposta max_worker_processes almeno al numero di database che vuoi migrare, più il numero di max_worker_processes già utilizzati nella tua istanza. Per impostare questo parametro, esegui il comando seguente:

      ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
          

      Dove NUMBER_OF_PROCESSES rappresenta il numero di database di cui verrà eseguita la migrazione.

   Origini Cloud SQL per PostgreSQL

   Per le origini Cloud SQL, configura i flag di database nella Google Cloud console. Per applicare l'impostazione, devi riavviare l'istanza dopo aver modificato i flag del database. Per saperne di più sull'impostazione dei flag di database in Cloud SQL, consulta Configurare i flag di database nella documentazione di Cloud SQL.

   1. Imposta il flag cloudsql.logical_decoding su on.
   2. Imposta il parametro wal_sender_timeout su 0. Questo valore disabilita il meccanismo di timeout utilizzato per terminare le connessioni di replica inattive.
   3. Configura il numero massimo di slot di replica con il parametro max_replication_slots. Questo parametro deve essere impostato almeno sul numero di database che stai migrando per job di migrazione, più alcune riserve per la sincronizzazione delle tabelle.

      Ad esempio, se esegui la migrazione di 5 database e sono stati creati 2 job di migrazione per l'istanza di origine, il numero di slot di replica deve essere almeno 5 * 2 = 10, più il numero di slot di replica già utilizzati.

   4. Configura il parametro max_wal_senders in modo che abbia almeno lo stesso valore di max_replication_slots, più il numero di mittenti già utilizzati nella tua istanza.

      Ad esempio, se il parametro max_replication_slots è impostato su 10 e stai già utilizzando due mittenti, il numero di processi del mittente WAL in esecuzione contemporaneamente sarà 10 + 2 = 12.

   5. Imposta max_worker_processes almeno sul numero di database che vuoi migrare, più il numero di max_worker_processes già utilizzati nella tua istanza.

Crea ed esegui una migrazione rapida

Per creare ed eseguire una migrazione rapida:

1. Nella console Google Cloud , vai alla pagina Inizia.

   Vai a Inizia

2. Nel menu Motore di origine, seleziona PostgreSQL.
3. Nel menu Motore di destinazione, seleziona AlloyDB per PostgreSQL.

   Viene visualizzata la sezione Introduzione alla migrazione rapida di PostgreSQL.

4. Nella sezione Introduzione alla migrazione rapida di PostgreSQL, fai clic su Avvia migrazione.

   Si apre la pagina Esegui la migrazione ad AlloyDB per PostgreSQL.

5. Nella sezione Configura migrazione, segui questi passaggi:
   1. Nel menu Regione di destinazione, seleziona la regione del cluster AlloyDB per PostgreSQL di destinazione.
   2. Nella casella Prefisso di migrazione, inserisci una stringa facile da ricordare che verrà aggiunta ai nomi di tutte le entità di migrazione create per la migrazione rapida: profili di connessione, configurazione della connettività privata, collegamento di rete e relativa subnet e job di migrazione.
   3. Dal menu Tipo di configurazione, seleziona una delle seguenti opzioni:
      1. Configurazione della connettività esistente: seleziona questa opzione se hai già un collegamento di rete e una configurazione di connettività privata che utilizza il metodo delle interfacce Private Service Connect. Questa opzione è ideale se hai utilizzato in precedenza le migrazioni rapide e vuoi riutilizzare le stesse risorse di rete.
      2. Nuova configurazione di connettività: seleziona questa opzione per creare un nuovo collegamento di rete e la subnet del collegamento di rete nella rete VPC del database di origine. La configurazione di connettività privata verrà creata nello stesso progetto del cluster di destinazione.
   Fai clic su Continua.
6. Nella sezione Collega origine, segui questi passaggi:
   1. Inserisci un nome host o l'indirizzo IP privato del tuo database di origine. L'indirizzo del database di origine deve essere raggiungibile dalla rete VPC di origine.
   2. Inserisci la porta utilizzata per accedere all'host. La porta PostgreSQL predefinita è 5432.
   3. Inserisci il nome utente e la password dell'account di migrazione dedicato nel database di origine.
   4. Dal menu Tipo di crittografia, seleziona una delle seguenti opzioni:
      • Nessuno: se il database di origine non richiede connessioni criptate con SSL/TLS.
      • Obbligatorio: se il database di origine richiede connessioni criptate con SSL/TLS. Questa opzione non richiede alcuna verifica del certificato.
   5. Nel menu Database da migrare, fai clic su Personalizza. Utilizza il riquadro laterale per selezionare solo i database di cui vuoi eseguire la migrazione ad AlloyDB per PostgreSQL.
   Fai clic su Continua.
7. Nella sezione Configura destinazione, puoi creare un nuovo cluster di destinazioni o selezionarne uno esistente.

   Nuovi cluster

   Se vuoi creare un nuovo cluster di destinazione:

   1. Dal menu Tipo di istanza di destinazione, seleziona Nuovo cluster.

      Database Migration Service utilizza la configurazione predefinita di AlloyDB per PostgreSQL per un nuovo cluster. Fai clic su Personalizza per modificare le funzionalità del cluster, come il tipo di macchina, la disponibilità zonale o le impostazioni di protezione dei dati. Per maggiori informazioni sulla configurazione del cluster, consulta Crea un cluster e la relativa istanza principale nella documentazione di AlloyDB per PostgreSQL.

   2. Nel campo Password, inserisci una password per l'amministratore predefinito postgresql. Database Migration Service si connette come questo utente per eseguire la migrazione dei dati.

   Cluster esistenti

   Puoi eseguire la migrazione dei database a un cluster già esistente. Assicurati che il cluster di destinazione sia abilitato per Private Service Connect e non applichi mTLS con i connettori AlloyDB. Segui questi passaggi:

   1. Nel menu Tipo di istanza di destinazione, seleziona Cluster esistente.
   2. Dal menu ID cluster esistente, seleziona l'identificatore del cluster.
8. Fai clic su Avvia migrazione.

   Database Migration Service ora crea il job di migrazione e avvia il processo di migrazione. Puoi monitorare l'avanzamento della migrazione, nonché l'integrità del cluster di destinazione in AlloyDB per PostgreSQL. Per saperne di più, consulta la sezione Visualizzare i dettagli dell'istanza nella documentazione di AlloyDB per PostgreSQL.

Finalizzare la migrazione

Quando decidi di passare alla nuova istanza di AlloyDB per PostgreSQL, finalizza la migrazione seguendo questi passaggi:

1. Interrompi tutte le operazioni di scrittura sul database di origine. Puoi passare alla modalità di sola lettura per mantenere la funzionalità operativa.
2. Promuovi il job di migrazione.
3. (Facoltativo) Verifica la completezza dei dati di migrazione.

Passaggi successivi

• Scopri di più su AlloyDB per PostgreSQL.