All Products
Search
Document Center

PolarDB:Minor version update

Last Updated:Oct 09, 2023

The architecture of a PolarDB cluster consists of the following layers: PolarProxy, the database engine, and the distributed storage. You can upgrade PolarProxy or the database engine individually or perform a combined upgrade.

Usage notes

  • In most cases, an upgrade requires less than 30 minutes to complete. PolarProxy or the database engine is restarted during the upgrade. This may interrupt services. We recommend that you perform the upgrade during off-peak hours. Make sure that your application can automatically reconnect to your database.

  • During the Upgrade PolarDB Database Proxy and Kernel process, transient connections occur for the primary endpoint and the cluster endpoint and last for 30 to 90 seconds. Make sure that your application can automatically reconnect to your database.

  • During the Upgrade PolarDB Database Proxy Only process, transient connections occur for the cluster endpoint and the custom endpoint and last for 30 seconds. Make sure that your application can automatically reconnect to your database.

  • During the Upgrade Kernel Only process, PolarDB clusters whose PolarProxy version is 2.4.7 or later can use the connection preservation technique to prevent 95% of the database connections from being interrupted.

  • During the upgrade, you cannot use several features that are related to cluster changes in the PolarDB console. For example, you cannot upgrade or downgrade configurations, add or remove nodes, modify parameters, or restart nodes. During this period, features related to data queries, such as performance monitoring, are still available.

  • You cannot downgrade PolarProxy or the database engine.

View the version information

  1. Log on to the PolarDB console.
  2. In the upper-left corner of the console, select the region in which the cluster that you want to manage is deployed.
  3. Find the cluster and click the cluster ID.
  4. In the left-side navigation pane, choose Settings and Management > Version Management.

  5. In the Version Information section of the Minor Version Upgrade page, view the version information of PolarProxy and the database engine.

Upgrade the cluster version

If the version of PolarProxy or the database engine of the cluster is not the latest version, you can upgrade the version based on your business requirements.

  1. On the details page of the cluster that you want to manage, choose Settings and Management > Version Management. In the Upgrade Version section of the Minor Version Upgrade page, select Upgrade PolarDB Database Proxy and Kernel, Upgrade Kernel Only, or Upgrade PolarDB Database Proxy Only based on your business requirements.

    升级内核小版本
    Note
    • If the version of PolarProxy or the database engine of the cluster is the latest version, the Upgrade PolarDB Database Proxy and Kernel, Upgrade Kernel Only, and Upgrade PolarDB Database Proxy Only options are unavailable.

    • If you select Upgrade PolarDB Database Proxy Only, only the features related to read/write splitting are upgraded, such as the consistency level, transaction splitting, and the feature for offloading reads from the primary node. The default consistency level is global consistency.

  2. Click Upgrade Now or Upgrade in Maintenance Window.

    If you select Upgrade in Maintenance Window, you can view the details of the task or cancel the task on the Scheduled Tasks page. For more information, see View or cancel a scheduled task.

    Important
    • During the Upgrade PolarDB Database Proxy and Kernel process, transient connections occur for the primary endpoint and the cluster endpoint and last for 30 to 90 seconds. Make sure that your application can automatically reconnect to your database.

    • During the Upgrade PolarDB Database Proxy Only process, transient connections occur for the cluster endpoint and the custom endpoint and last for 30 seconds. Make sure that your application can automatically reconnect to your database.

    • During the Upgrade Kernel Only process, PolarDB clusters whose PolarProxy version is 2.4.7 or later can use the connection preservation technique to prevent 95% of the database connections from being interrupted.

  3. In the message that appears, click OK.

Related API operations

Operation

Description

DescribeDBClusterVersion

Queries the details of the database engine version of a cluster.

UpgradeDBClusterVersion

Upgrades a cluster to the latest version.