Aggiornare il cluster in Azure Cosmos DB for PostgreSQL

Importante

Azure Cosmos DB per PostgreSQL non è più supportato per i nuovi progetti. Non usare questo servizio per i nuovi progetti. Usare invece uno dei due servizi seguenti:

• Usare Azure Cosmos DB per NoSQL per una soluzione di database distribuita progettata per scenari su alta scala con un accordo sul livello di servizio (SLA) di disponibilità del 99.999%, scalabilità automatica istantanea e failover automatico in più regioni.

• Usare la funzionalità cluster elastici di Database di Azure for PostgreSQL per PostgreSQL partizionato usando l'estensione Citus open source.

Queste istruzioni descrivono come eseguire l'aggiornamento a una nuova versione principale di PostgreSQL in tutti i nodi del cluster.

Testare prima l’aggiornamento

L'aggiornamento di PostgreSQL causa più modifiche di quanto si possa immaginare: Azure Cosmos DB for PostgreSQL infatti, aggiornerà anche le estensioni del database, inclusa l'estensione Citus. Gli aggiornamenti richiedono tempi di inattività nel cluster di database.

Prima di aggiornare l'ambiente di produzione, è consigliabile testare l'applicazione con la nuova versione di PostgreSQL e Citus. Vedere anche il nostro elenco delle precauzioni per l’aggiornamento.

Un modo pratico per testare consiste nell'eseguire una copia del cluster usando il ripristino temporizzato. Aggiornare la copia e testarla. Dopo aver verificato che tutto funzioni correttamente, aggiornare il cluster originale.

Aggiornare un cluster nel portale di Azure

1. Nella sezione Panoramica di un cluster selezionare il pulsante Aggiorna.
2. Viene visualizzata una finestra di dialogo che mostra la versione corrente di PostgreSQL e Citus. Scegliere una nuova versione di PostgreSQL nell'elenco di versione di PostgreSQL da aggiornare.
3. Verificare che il valore nella versione di Citus da aggiornare sia quello previsto. Questo valore cambia in base alla versione di PostgreSQL selezionata.
4. Per continuare, selezionare il pulsante Aggiorna.

Note

Se è già in esecuzione la versione più recente di PostgreSQL, la selezione e il pulsante sono disattivati.

Attività successive all’aggiornamento

Dopo un aggiornamento della versione principale di PostgreSQL, eseguire l’operazione ANALYZE per aggiornare la tabella pg_statistic. pg_statistic è una tabella del catalogo di sistema in PostgreSQL che archivia i dati statistici relativi al contenuto delle colonne presenti nella tabella e alle espressioni degli indici. Le voci in pg_statistic vengono create dal comando ANALYZE e usate dallo strumento di pianificazione delle query.

Eseguire il comando ANALYZE senza alcun parametro in modo da generare statistiche per le tabelle del database nel cluster. Il nome predefinito del database è "citus". Se il nome del database personalizzato è stato usato al momento della creazione del cluster, è possibile trovarlo nella pagina Panoramica delle proprietà del cluster. L'uso del flag VERBOSE facoltativo consente di visualizzare lo stato di avanzamento.

ANALYZE VERBOSE;

Note

Le prestazioni del database potrebbero essere compromesse se non si esegue l'operazione ANALYZE dopo l'aggiornamento della versione principale di PostgreSQL nel cluster.

Passaggi successivi

• Informazioni sulle versioni di PostgreSQL supportate.
• Vedere quali estensioni sono incluse nel pacchetto di ciascuna versione di PostgreSQL in un cluster.
• Altre informazioni sugli aggiornamenti