Esegui l'upgrade della versione principale del database eseguendo la migrazione dei dati

Questa pagina descrive come eseguire la migrazione dei dati a un'istanza che esegue una versione successiva di PostgreSQL. Prima di procedere con questo metodo, valuta la possibilità di eseguire l'upgrade della versione principale del database sul posto.

Esistono due modi per eseguire l'upgrade della versione principale del database dell'istanza Cloud SQL per PostgreSQL eseguendo la migrazione dei dati.

  • Opzione 1. Utilizza Database Migration Service (DMS). DMS supporta la migrazione da un'istanza Cloud SQL per PostgreSQL. Puoi anche usarlo per eseguire l'upgrade della versione del database.
  • Opzione 2. Sposta i dati da una versione di PostgreSQL a un'altra esportando i dati dall'istanza corrente e importando i dati in una nuova istanza che esegue la versione successiva di PostgreSQL. Questa procedura comporta un tempo di riposo. Devi impostare l'istanza corrente in modalità di sola lettura prima di avviare l'esportazione.

Il resto di questa pagina illustra la seconda opzione.

Pianificare un upgrade della versione principale

  1. Scegli una versione principale di destinazione.

    Consulta l'elenco delle versioni supportate da Cloud SQL.

  2. Valuta le funzionalità offerte in ogni versione di PostgreSQL e risolvi le incompatibilità.

    Le nuove versioni principali introducono modifiche incompatibili che potrebbero richiedere di modificare il codice dell'applicazione, lo schema o le impostazioni del database prima di poter eseguire l'upgrade dell'istanza del database. Esamina le note di rilascio della versione principale di destinazione per determinare le incompatibilità da risolvere. Se salti le versioni principali, risolvi le incompatibilità elencate per ogni versione che salti.

  3. Prova l'upgrade con una simulazione.

    Esegui una simulazione della procedura di upgrade end-to-end con un'istanza di test prima di eseguire l'upgrade del database di produzione. Ti consigliamo di testare l'upgrade utilizzando un clone anziché il database di produzione per evitare che l'esportazione influisca sulle prestazioni del tuo carico di lavoro di produzione.

    Oltre a verificare il completamento dell'upgrade, esegui test per comprendere il tempo di riposo previsto dell'upgrade, confermare il flusso di lavoro dell'upgrade e assicurarti che l'applicazione si comporti come previsto nel database di cui è stato eseguito l'upgrade. Se non hai attivato gli aumenti automatici dello spazio di archiviazione, prendi nota dello spazio di archiviazione del disco utilizzato dall'istanza di prova secca di cui è stato eseguito l'upgrade per determinare se devi aumentare la capacità di archiviazione per l'istanza di produzione prima dell'upgrade.

  4. Decidi quando eseguire l'upgrade.

Migrazione dei dati

La migrazione prevede l'utilizzo del comando pg_dump per esportare i dati dall'istanza di origine e del comando pg_restore per importare i dati nell'istanza di destinazione.

Per eseguire la migrazione dei dati a un'istanza Cloud SQL che esegue una versione del database più recente, segui questi passaggi:

  1. Crea l'istanza di destinazione con la versione PostgreSQL desiderata.

    Assicurati che l'istanza di destinazione abbia:

    • Spazio di archiviazione sufficiente per contenere tutti i dati dell'istanza corrente.
    • Le stesse emittenti autorizzate dell'istanza corrente. Scopri di più.
    • Gli stessi account utente, con gli stessi privilegi e le stesse password PostgreSQL.

    Per ulteriori informazioni, vedi Creare un'istanza.

  2. Verifica di poter connetterti alla nuova istanza con gli strumenti PostgreSQL locali e, se necessario, aggiornali.

  3. Esporta i dati dell'istanza corrente in un file di dump PostgreSQL seguendo le istruzioni riportate in Esportazione dei dati da importare in Cloud SQL.

    Non esportare il database di sistema postgres. Il database postgres è il database predefinito a cui ti colleghi prima di creare altri database. Dopo aver creato un altro database, passaci per creare tabelle e inserire dati. Non utilizzare il database postgres per i dati della tua applicazione.

  4. Crea un bucket Cloud Storage se necessario e carica il file di dump SQL nel bucket.

  5. Importa i dati nell'istanza di destinazione seguendo le istruzioni riportate in Importazione di database PostgreSQL da Cloud Storage.

  6. Facoltativo. Dopo aver completato la procedura di upgrade, configura la replica tra le istanze di origine e di destinazione utilizzando pglogical per aggiornare la destinazione con tutte le modifiche che si sono verificate dall'avvio del dump iniziale. Una volta sincronizzate le due istanze, puoi promuovere l'istanza di destinazione.

    Per informazioni sull'utilizzo di pglogical per implementare la replica continua, consulta Configurare l'origine.

  7. Aggiorna le applicazioni per connetterti alla nuova istanza.

  8. Quando hai la certezza che la nuova istanza funzioni correttamente, elimina quella precedente.

Passaggi successivi