PolarDB clusters have three layers: the database proxy (PolarProxy), the database kernel (DB), and the distributed storage (Store). You can upgrade the proxy and the kernel separately or together. Use this page to check your current versions and perform minor version upgrades.
View version information
-
Log on to the PolarDB console. In the navigation pane on the left, click Clusters. Select the region where the cluster is located, and then click the ID of the target cluster.
-
In the navigation pane on the left, choose Settings and Management > Version Management.
-
On the Minor Version Upgrade page, view the current proxy and kernel versions in the Version Information section.
Upgrade the version
If the current proxy or kernel version is not the latest, upgrade it from the Minor Version Upgrade page.
Before you begin
-
Schedule the upgrade during off-peak hours. An upgrade typically takes no more than 30 minutes and temporarily restarts the proxy or kernel, which may cause brief connection interruptions.
-
Make sure your application has an automatic reconnection mechanism before you start.
-
Note that you cannot downgrade a version after upgrading.
If you have configured CloudMonitor to monitor your PolarDB cluster, you may receive cluster access exception notifications during the upgrade. These are expected and do not indicate a permanent issue.
Select an upgrade type
Select the upgrade type based on which layer you want to update and how much connection interruption your application can tolerate.
| Upgrade type | Connection impact | Notes |
|---|---|---|
| Upgrade PolarDB Database Proxy and Kernel | Primary endpoint and cluster endpoint interrupted for 30–90 seconds | The upgrade does not affect normal cluster operation beyond this interruption |
| Upgrade PolarDB Database Proxy Only | Cluster endpoint and custom endpoints interrupted for 30 seconds; primary endpoint not affected | Only upgrades read/write splitting features: consistency level (global consistency), transaction splitting, and whether the primary database accepts read requests |
| Upgrade Kernel Only | Up to 95% of connections preserved if PolarProxy version is 2.3.50 or later (Connection Preserving feature) | Check your PolarProxy version in the Version Information section before selecting this option |
If the current proxy or kernel version is already the latest, all three upgrade options are unavailable.
Perform the upgrade
-
Go to Settings and Management > Version Management for the target cluster. On the Minor Version Upgrade page, go to the Upgrade Version section and select an upgrade type.
-
Click Upgrade Now or Upgrade in Maintenance Window.
-
Upgrade Now: starts the upgrade immediately.
-
Upgrade in Maintenance Window: schedules the upgrade for the next maintenance window. To view task details or cancel the scheduled upgrade, go to the Scheduled Tasks page.
-
Console operations unavailable during an upgrade
During an upgrade, the following console operations are unavailable because they change the cluster state:
-
Upgrading or downgrading configurations
-
Adding or deleting nodes
-
Modifying parameters
-
Restarting nodes
Query features such as performance monitoring are not affected.