TDSQL-C MySQL 版升级数据库代理内核小版本

一、前提条件

·已开通数据库代理。

·当前实例的数据库代理版本不是最新版。

二、升级方案

你可以根据业务实际情况，选择升级切换时间以实现更平滑的升级。

·维护时间内：可以选择在实例维护时间内升级，设置实例维护时间请参见修改实例维护时间。

·升级完成时：支持在升级完成时立即切换至所选择的数据库代理版本。

·滚动升级：拉起新的数据库代理版本节点，拉起后，新连接将通过新数据库代理版本节点访问数据库，旧数据库代理版本节点将不再接受新的连接请求，可设置切换等待时间，当到达切换时间后，旧的数据库代理版本节点才会被回收，同时切断旧数据库代理版本节点上的存量旧连接。

三、注意事项

·升级数据库代理版本会出现秒级别的闪断。请你尽量在业务低峰期执行升级操作，并确保你的应用具备自动重连机制。

·升级数据库代理版本是默认所有代理节点同时升级，若部分代理节点状态异常，则无法升级。

·仅支持升级数据库代理版本，不支持降级。

四、升级过程中可执行任务说明

在升级数据库代理版本过程中，当状态/任务为内核小版本升级中时，你可以对数据库代理执行的操作为：修改数据库代理的网络、修改数据库代理内网地址、修改数据库代理地址的备注。你不可以对数据库代理执行的操作为：调整配置、关闭数据库代理、升级内核小版本、重新负载均衡、修改网络、修改 IP，如需执行，请等待升级任务完成后再执行。

五、升级数据库代理版本

1. 登录 TDSQL-C MySQL 版控制台，在上方选择地域，然后单击目标集群 ID，进入集群管理页。

2. 在集群管理页，选择数据库代理页。

3. 在数据库代理页的概览 > 基本信息 > 代理版本后，单击升级内核小版本。

4. 在弹出的对话框，选择需升级的目标版本，选择升级切换时间，确认无误后，单击确定。

参数	操作说明
当前版本	显示实例当前的数据库代理版本。
目标版本	在此项选择要升级的目标数据库代理版本。有关各版本的更新说明，请参见数据库代理版本更新动态。
切换时间	选择升级的切换时间，支持选择维护时间内、升级完成时、滚动升级三种。维护时间内：选择维护时间内，会在下一个维护时间内完成升级切换。升级完成时：选择升级完成时，会在版本升级完成时立即进行切换。滚动升级：选择滚动升级，需要设置切换等待时间，默认为10秒，取值范围：10 – 3600秒，到达切换等待时间后，系统回收旧版本节点。说明：选择滚动升级后，旧版本节点的存量连接不会被立即终止，所有新连接都自动路由到新版本节点，旧版本节点存量连接在等待超时后强制断开，业务基本无感知。具体流程如下：1. 系统拉起新的数据库代理版本节点。2. 旧版本节点存量连接保持。3. 升级任务暂停并保持等待（等待时间为你设置的“切换等待时间”）。4. 到达“切换等待时间”后，系统发送断开旧版本节点连接信号，随后断开旧版本节点连接，并清理旧版本节点配置。
升级涉及的相关节点	在此项下面，会展示本次升级涉及的数据库代理节点信息。

六、取消执行

在升级数据库代理版本过程中，如果切换时间选择为滚动升级但还未到达切换等待的时间，此时支持根据实际情况取消本次任务的执行，取消执行后，本次数据库代理版本不会升级。

1. 在数据库代理页的概览 > 基本信息 > 状态/任务后单击取消执行。

2. 在弹窗中，单击确定。

七、立即执行

注意：说明：

注意：操作立即执行后，会立即回收旧数据库代理版本节点，旧数据库代理版本节点上的存量连接会立即断开。

在升级数据库代理版本过程中，如果切换时间选择为维护时间内但还未到达维护时间，或者切换时间选择为滚动升级但还未到达切换等待的时间，此时如果你需要立即执行升级，切换数据库代理版本，可通过以下操作执行。

1. 在数据库代理页的概览 > 基本信息 > 状态/任务后单击立即执行。