Upgrade van de cluster in Azure Cosmos DB voor PostgreSQL

Belangrijk

Azure Cosmos DB for PostgreSQL wordt niet meer ondersteund voor nieuwe projecten. Gebruik deze service niet voor nieuwe projecten. Gebruik in plaats daarvan een van deze twee services:

• Gebruik Azure Cosmos DB voor NoSQL voor een gedistribueerde databaseoplossing die is ontworpen voor hoogwaardige schalen scenario's met een 99,999% service level agreement (SLA) voor beschikbaarheid, onmiddellijke autoschaalaanpassing en automatische failover over meerdere regio's.

• Gebruik de functie Elastische clusters van Azure Database For PostgreSQL voor sharded PostgreSQL met behulp van de opensource Citus-extensie.

In deze instructies wordt beschreven hoe u een upgrade uitvoert naar een nieuwe primaire versie van PostgreSQL op alle clusterknooppunten.

De upgrade eerst testen

Het upgraden van PostgreSQL veroorzaakt meer wijzigingen dan u zich misschien voorstelt, omdat Azure Cosmos DB for PostgreSQL ook de database-extensies upgradet, inclusief de Citus-extensie. Upgrades vereisen ook downtime in het databasecluster.

We raden u ten zeerste aan om uw toepassing te testen met de nieuwe PostgreSQL- en Citus-versie voordat u uw productieomgeving bijwerkt. Zie ook onze lijst met voorzorgsmaatregelen voor upgrades.

Een handige manier om te testen is door een kopie van uw cluster te maken met behulp van de point-in-time-herstelfunctie. Werk de kopie bij en test uw toepassing ertegen. Nadat u hebt gecontroleerd of alles goed werkt, werkt u het oorspronkelijke cluster bij.

Een cluster upgraden in Azure Portal

1. Selecteer in de sectie Overzicht van een cluster de knop Upgrade .
2. Er wordt een dialoogvenster weergegeven met de huidige versie van PostgreSQL en Citus. Kies een nieuwe PostgreSQL-versie in de lijst PostgreSQL-versie om te upgraden.
3. Controleer of de waarde in de Citus-versie die u wilt upgraden , is wat u verwacht. Deze waarde verandert op basis van de PostgreSQL-versie die u hebt geselecteerd.
4. Selecteer de knop Upgrade om door te gaan.

Notitie

Als u de nieuwste PostgreSQL-versie al uitvoert, worden de selectie en knop grijs weergegeven.

Taken na de upgrade

Voer na een belangrijke Upgrade van de PostgreSQL-versie de ANALYZE bewerking uit om de pg_statistic tabel te vernieuwen. pg_statistic is een systeemcatalogustabel in PostgreSQL waarin statistische gegevens worden opgeslagen over de inhoud van tabelkolommen en indexexpressies. Vermeldingen in pg_statistic worden gemaakt met de opdracht ANALYZE en worden gebruikt door de queryplanner.

Voer de ANALYZE opdracht uit zonder parameters om statistieken te genereren voor de tabellen in de database in uw cluster. De standaarddatabasenaam is 'citus'. Als de naam van de aangepaste database is gebruikt tijdens het maken van het cluster, kunt u deze vinden op de pagina Overzicht van de eigenschappen van uw cluster. Met de optionele VERBOSE vlag kunt u de voortgang bekijken.

ANALYZE VERBOSE;

Notitie

De databaseprestaties kunnen worden beïnvloed als u de bewerking niet uitvoert ANALYZE na de primaire Upgrade van de PostgreSQL-versie op uw cluster.

Volgende stappen

• Meer informatie over ondersteunde PostgreSQL-versies.
• Bekijk welke extensies zijn verpakt met elke PostgreSQL-versie in een cluster.
• Meer informatie over upgrades