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

Questa pagina descrive come eseguire la migrazione dei dati in 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 in loco.

Esistono due modi per eseguire l'upgrade della versione principale del database della tua 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 utilizzarlo anche per eseguire l'upgrade della versione del database.
  • Opzione 2. Sposta i dati da una versione di PostgreSQL a un'altra exporting i dati dall'istanza corrente e exporting in una nuova istanza che esegue la versione successiva di PostgreSQL. Questo processo prevede tempi di inattività; imposti l'istanza corrente in modalità di sola lettura prima di avviare l'esportazione.

Il resto della 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. Considera le funzionalità offerte in ogni versione di PostgreSQL e risolvi le incompatibilità.

    Le nuove versioni principali introducono modifiche incompatibili che potrebbero richiedere la modifica del codice dell'applicazione, dello schema o delle impostazioni del database prima di poter eseguire l'upgrade dell'istanza di 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 saltata.

  3. Testa l'upgrade con una prova.

    Esegui una prova del processo di upgrade end-to-end con un'istanza di test prima di eseguire l'upgrade del database di produzione. Potresti testare l'upgrade utilizzando un clone anziché il tuo database di produzione per evitare qualsiasi impatto sulle prestazioni dell'esportazione sul carico di lavoro di produzione.

    Oltre a verificare che l'upgrade venga completato correttamente, esegui test per comprendere il tempo di inattività previsto dell'upgrade, conferma il flusso di lavoro dell'upgrade e assicurati che l'applicazione funzioni come previsto nel database aggiornato. Se non hai abilitato gli incrementi automatici dello spazio di archiviazione, prendi nota dello spazio di archiviazione su disco utilizzato dall'istanza di prova aggiornata per determinare se è necessario aumentare la capacità di archiviazione per l'istanza di produzione prima di eseguire l'upgrade.

  4. Decidi quando eseguire l'upgrade.

Eseguire la 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 in un'istanza Cloud SQL che esegue una versione più recente del database, 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 reti autorizzate dell'istanza attuale. Scopri di più.
    • Gli stessi account utente, con gli stessi privilegi e password di PostgreSQL.

    Per ulteriori informazioni, vedi Creazione di un'istanza.

  2. Conferma 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 per l'importazione 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 al database per creare tabelle e inserire dati. Non utilizzare il database postgres per i dati dell'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 in Importazione di database PostgreSQL da Cloud Storage.

  6. Facoltativo. Dopo aver completato il processo 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 hai la certezza che la nuova istanza funzioni correttamente, elimina quella precedente.

Passaggi successivi