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 utilizzarlo 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 importandoli in una nuova istanza che esegue la versione successiva di PostgreSQL. Questo processo comporta tempi di inattività; devi impostare l'istanza corrente in modalità di sola lettura prima di avviare l'esportazione.

Il resto della pagina descrive 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. Testa l'upgrade con un test dry run.

    Esegui una prova del processo 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 qualsiasi impatto sul rendimento dell'esportazione sul carico di lavoro di produzione.

    Oltre a verificare che l'upgrade venga completato correttamente, esegui test per comprendere i tempi di inattività previsti dell'upgrade, conferma il flusso di lavoro dell'upgrade e assicurati che l'applicazione si comporti come previsto sul database di cui è stato eseguito l'upgrade. Se non hai attivato gli aumenti automatici dello spazio di archiviazione, prendi nota dello spazio di archiviazione su disco utilizzato dall'istanza di prova aggiornata 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 comporta 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 più recente del database, segui questi passaggi:

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

    Assicurati che l'istanza di destinazione abbia:

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

    Per saperne di più, vedi Creazione di un'istanza.

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

  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 connetti prima di aver creato altri database. Dopo aver creato un altro database, passa a quest'ultimo 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 apportate 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 avrai la certezza che la nuova istanza funziona correttamente, elimina quella precedente.

Passaggi successivi