tencent cloud

DocumentaçãoTDSQL-C for MySQL

Upgrading Kernel Minor Version

Download
Modo Foco
Tamanho da Fonte
Última atualização: 2026-07-03 15:13:11
Traduzido por IA
TDSQL-C for MySQL will release new database kernel minor versions on an ongoing basis. Upgrading to these minor versions can bring improvements to your database instances, including performance enhancements, security upgrades, new feature support, compatibility improvements, and bug fixes. This document describes the procedures and instructions for upgrading the database kernel minor version via the console.
Note:
For details about the features of each database kernel minor version, see Kernel Version Updates.

Scenarios

You can manually upgrade the database kernel minor version via the console when a new version is released or when the current version for your cluster is outdated and needs to be upgraded.
Note:
When operations that trigger cluster migration occur, such as scaling cluster specifications, scaling disk capacity, or upgrading the database edition, the system does not automatically upgrade your cluster to the latest kernel minor version. If an upgrade is required, you can perform a manual upgrade.
Warning:
If a bug occurs in the backend program or if the system identifies a security vulnerability, the system will send upgrade notifications via internal messages, SMS, and other means. TDSQL-C for MySQL will perform system upgrades and fixes at a scheduled time. However, this automatic upgrade is only a system-assisted method and does not guarantee that all instances can be immediately upgraded to the latest kernel minor version. You can check the kernel minor version status on the cluster management page and manually upgrade the kernel minor version in a timely manner to avoid potential risks that may exist in older kernel minor versions. If you have not completed the upgrade within 6 months after being notified of an urgent service upgrade/version upgrade due to your own reasons, you will be responsible for any resulting losses and consequences, such as service interruptions or data loss. For details, see the TDSQL-C for MySQL Service Level Agreement.

Upgrade Rules

To ensure data replication consistency, the associated instances (read-write instances and read-only instances) under the cluster whose database kernel minor version is to be upgraded will be upgraded together.
During a database kernel minor version upgrade, additional compute nodes are spun up for the upgrade. This process does not involve data migration and enables a near-instantaneous upgrade.

Note

A momentary disconnection lasting seconds may occur during the database kernel minor version upgrade switchover. It is recommended to perform the switchover during a maintenance window or off-peak hours to minimize impact on your business.
If the number of tables in a single instance exceeds 1 million, the upgrade may fail and database monitoring may also be affected. Please properly manage the number of tables and keep the number of tables per instance below 1 million.
The kernel cannot be downgraded after a minor version upgrade.

Minor Version Number Description

TDSQL-C for MySQL now fully supports a four-digit database kernel minor version number. The version number has been updated from three digits to four, which helps prevent forced upgrades and ensures stable instance operation during version updates. Additionally, within a major version (such as a three-digit major version like 3.1.15), the system can release multiple minor versions with new capabilities, enabling you to better experience the product's new features.
The description of each digit in the four-digit minor version number is shown in the figure below.

TDSQL-C for MySQL provides two options for kernel minor version upgrades. You can select one as needed.
Stable version: version that is stable and has undergone long-time testing, with an update frequency of 3 to 4 months. Currently, all versions with the major version 3.1.16 are stable versions, such as 3.1.16.001, 3.1.16.002, and 3.1.16.003.
New-feature version: version with new features, which is the currently general kernel minor version.
Note: It is recommended that you select the "new-feature version" and maintain periodic upgrades for upgrading the kernel minor version.

Upgrading the Kernel Minor Version

1. Log in to the TDSQL-C for MySQL console.
2. On the cluster list page, perform operations based on the view mode you are using to enter the database kernel minor version upgrade window.
Tab View
List View
1. Click the target cluster in the cluster list on the left to enter the cluster management page.
2. On the cluster management page, click Details/Upgrade after the database version.

1. In the cluster list, locate the target cluster. Click the cluster ID or Manage in the Operation column to go to the cluster details page.
2. On the cluster details page, click Details/Upgrade after Configuration Info > Database Version.

3. In the pop-up sidebar, click Upgrade Cluster Now.
4. In the pop-up window, select the switchover time and the target kernel minor version to upgrade, select "I have read and agree to the database version upgrade instructions", and click OK.

Switch Time
During maintenance time: After the upgrade is completed, the switchover is performed during the instance's maintenance time. To modify the maintenance window, see Set Instance Maintenance Time.
Upon upgrade completion: The switchover is triggered immediately after the upgrade is completed.
Kernel Minor Version
New-Feature Version: This version includes new features and is the general kernel minor version currently used in the production network. Under New-Feature Version, select the required version.
Stable version: version that is stable and has undergone long-time testing, with an update frequency of 3 to 4 months. Under Stable version, select the required version.
5. To check the progress of the upgrade task, you can go to the Task List.
6. When the instance's running status is updated to "Running", the upgrade is completed.

Related APIs

API
Description
This API (UpgradeClusterVersion) is used to update the kernel minor version.

Ajuda e Suporte

Esta página foi útil?

comentários