TDSQL-C MySQL 版会不定期更新数据库代理的版本，新的版本可能涉及功能更新、性能优化或问题修复，您可以查看数据库代理版本更新动态，并结合实际业务评估是否需要升级。本文为您介绍通过控制台手动升级数据库代理版本的操作及说明。
前提条件
已 开通数据库代理。
当前实例的数据库代理版本不是最新版。
升级方案
您可以根据业务实际情况，选择升级切换时间以实现更平滑的升级。
维护时间内：可以选择在实例维护时间内升级，设置实例维护时间请参见 修改实例维护时间。
升级完成时：支持在升级完成时立即切换至所选择的数据库代理版本。
滚动升级：拉起新的数据库代理版本节点，拉起后，新连接将通过新数据库代理版本节点访问数据库，旧数据库代理版本节点将不再接受新的连接请求，可设置切换等待时间，当到达切换时间后，旧的数据库代理版本节点才会被回收，同时切断旧数据库代理版本节点上的存量旧连接。
注意事项
升级数据库代理版本会出现秒级别的闪断。请您尽量在业务低峰期执行升级操作，并确保您的应用具备自动重连机制。
升级数据库代理版本是默认所有代理节点同时升级，若部分代理节点状态异常，则无法升级。
仅支持升级数据库代理版本，不支持降级。
升级过程中可执行任务说明
在升级数据库代理版本过程中，当状态/任务为内核小版本升级中时，您可以对数据库代理执行的操作为：修改数据库代理的网络、修改数据库代理内网地址、修改数据库代理地址的备注。您不可以对数据库代理执行的操作为：调整配置、关闭数据库代理、升级内核小版本、重新负载均衡、修改网络、修改 IP，如需执行，请立即完成升级任务后再执行。
升级数据库代理版本
1. 登录 TDSQL-C MySQL 版控制台，在上方选择地域，然后单击目标集群 ID，进入集群管理页。
2. 在集群管理页，选择数据库代理页。
3. 在数据库代理页的概览 > 基本信息 > 代理版本后，单击升级内核小版本。
4. 在弹出的对话框，选择需升级的目标版本，选择升级切换时间，确认无误后，单击确定。
参数 | 操作说明 |
当前版本 | 显示实例当前的数据库代理版本。 |
目标版本 | |
切换时间 | 选择升级的切换时间，支持选择维护时间内、升级完成时、滚动升级三种。 维护时间内：选择维护时间内，会在下一个维护时间内完成升级切换。 升级完成时：选择升级完成时，会在版本升级完成时立即进行切换。 滚动升级：选择滚动升级，需要设置切换等待时间，默认为10秒，取值范围：10 - 3600秒，到达切换等待时间后，系统回收旧版本节点。 |
升级涉及的相关节点 | 在此项下面，会展示本次升级涉及的数据库代理节点信息。 |
取消执行
在升级数据库代理版本过程中，如果切换时间选择为滚动升级但还未到达切换等待的时间，此时支持根据实际情况取消本次任务的执行，取消执行后，本次数据库代理版本不会升级。
1. 在数据库代理页的概览 > 基本信息 > 状态/任务后单击取消执行。
2. 在弹窗中，单击确定。
立即执行
说明：
操作立即执行后，会立即回收旧数据库代理版本节点，旧数据库代理版本节点上的存量连接会立即断开。
在升级数据库代理版本过程中，如果切换时间选择为维护时间内但还未到达维护时间，或者切换时间选择为滚动升级但还未到达切换等待的时间，此时如果您需要立即执行升级，切换数据库代理版本，可通过以下操作执行。
1. 在数据库代理页的概览 > 基本信息 > 状态/任务后单击立即执行。
2. 在弹窗中，单击确定。
相关 API
API | 描述 |
接口（UpgradeCDBProxyVersion）用于升级数据库代理版本。 |
