TDSQL-C MySQL 版会陆续发布新的数据库内核小版本，通过升级数据库内核小版本，可以使得您的数据库实例获得性能提升、安全性增强、新功能支持、兼容性改进和错误修复等升级。本文为您介绍通过控制台升级数据库内核小版本的操作和说明。
说明：
操作场景
当系统发布新的数据库内核小版本时，或者您当前集群的数据库内核小版本过旧，需要升级到新的数据库内核小版本时，您可以通过控制台进行手动升级。
说明：
当发生触发集群迁移的操作（如数据库版本升级等）时，系统不会主动将您的集群升级至最新内核小版本，如需升级，您可手动升级。
警告：
如果后台程序出现 bug，或者当系统发现安全隐患时，系统将通过站内信、短信等方式推送升级通知，TDSQL-C MySQL 版会在指定时间进行系统升级和修复，但此自动升级仅为系统辅助升级手段，并不保证所有实例均能立即升级至最新内核小版本。您可以在集群管理页查看内核小版本状态，并及时手动升级内核小版本，以避免历史内核小版本可能存在的潜在风险。如在紧急服务升级/版本升级通知告知您6个月后，因您的原因仍未完成升级，因此产生的业务中断、数据丢失等损失和后果均由您承担。详情请参见 TDSQL-C MySQL 版服务等级协议。
升级规则
为保证数据复制一致性，待升级数据库内核小版本的集群下的关联实例（读写实例、只读实例）会一起进行内核小版本升级。
升级方式说明
当前内核小版本升级功能已优化升级，升级方式由历史的仅支持“秒级升级”，更新为支持“秒级升级”与“跨 slave 升级”两种升级方式，您可在升级配置弹窗中根据业务诉求自主选择。两种方式的差异如下：
对比项 | 秒级升级 | 跨 slave 升级 |
闪断时长 | 秒级 | ms 切换闪断，闪断小于30秒 |
是否保留历史节点 | 否，无历史节点保留 | 是，升级后默认保留低版本节点作为回滚窗口期的备用节点 |
是否支持回滚 | 不支持 | 支持，在回滚窗口期内可一键回滚 |
运维操作限制 | 无 |
当升级路径涉及关键变更时（系统自动判断），为了保障可回滚性，您只能选择跨 slave 升级。具体可选升级方式，请您以实际升级小版本时的页面提示为准。
注意事项
数据库内核小版本升级切换阶段有秒级闪断（跨 slave 升级为 ms 切换闪断小于30秒），建议选择在维护时间内或业务低峰期切换，减少对业务的影响。
单个实例的表数量超过100万后，可能会造成升级失败，同时也会影响数据库监控，请合理规范表的数量，控制单个实例表数量不超过100万。
内核小版本升级后是否支持降级与升级方式相关：秒级升级方式不可回滚，跨 slave 升级方式支持回滚。
跨 slave 升级在回滚窗口期内会保留低版本的备节点，期间集群仅部分功能可使用；请提前评估窗口期内的运维安排，或在确认无需回滚后及时释放低版本的备节点以恢复全部功能使用。
若您在回滚窗口期内再次发起升级（第二次升级），则升级入口将无法进入，需要先释放第一次升级时的低版本备节点或等待窗口期结束后再发起二次升级；回滚成功后的集群等同于普通集群，可重新走升级流程。
处于暂停状态的 Serverless 集群无法操作内核小版本升级，请先恢复集群至运行态再发起升级。
四位小版本号说明
TDSQL-C MySQL 版的数据库内核小版本全新支持了四位小版本号。版本号由原来的三位更新为四位，可避免发生被动升级，保障更新版本时实例的稳定运行，同时在大版本内（例如3.1.15这种三位大版本）系统可推出多个附带新能力的小版本，帮助您更好地体验产品新能力。
四位小版本号中，每一位的描述，如下图所示。
TDSQL-C MySQL 版提供两条内核小版本升级线路，您可按需选择：
稳定版：长线验证后的稳定版本，更新频率为3 - 4个月，当前大版本号为3.1.16的均为稳定版，如3.1.16.001、3.1.16.002、3.1.16.003。
新功能版：携带新的功能特性，是现网通用内核小版本。
温馨提示：建议您在升级内核小版本时，优先选择“新功能版”并保持定期升级。
升级内核小版本
1. 登录 TDSQL-C MySQL 版控制台。
2. 在集群列表页，根据您实际使用的视图模式进行操作，进入数据库内核小版本升级窗口。
1. 在左侧集群列表，单击目标集群，进入集群管理页。
2. 在集群管理页，数据库版本后，单击详情/升级。
1. 在集群列表，找到目标集群，单击集群 ID 或操作列的管理，进入集群详情页。
2. 在集群详情页的配置信息 > 数据库版本后，单击详情/升级。
3. 在弹出的侧边栏，单击读写/只读实例升级。
4. 在弹窗下根据需要进行设置，勾选“已阅读并同意数据库版本升级说明”，单击确定。
参数 | 说明 |
升级方式 | 选择小版本升级方式，支持： 秒级升级：闪断短、速度快；不保留历史节点，无回滚能力。 跨 slave 升级：30秒内的闪断。升级后保留低版本，回滚窗口期内支持一键回滚。 |
回滚窗口期 | 当升级方式选择为“跨 slave 升级”时才支持设置回滚窗口期。 单位：小时，默认值：24，设置范围：1 - 24。 |
切换时间 | 维护时间内：升级完成后，会在实例的维护时间内进行切换。修改维护窗口期可参考 设置实例维护时间。 升级完成时：升级完成后立即触发切换。 |
内核小版本 | 新功能版：携带新的功能特性，是现网通用内核小版本。在新功能版下方选择需要的版本。 稳定版：长线验证后的稳定版本，更新频率为3 - 4个月。在稳定版下方选择需要的版本。 |
5. 如需了解升级任务进度，您可前往 任务列表 进行查询。
6. 当实例运行状态更新为“运行中”时，即升级完成。
回滚与释放 slave（跨 slave 升级）
立即回滚
若内核小版本升级后，您的业务存在兼容性或性能问题，需要回退至低内核小版本时，您可参考如下操作进行回退。仅跨 slave 升级方式在回滚窗口期内支持以下操作。
注意：
执行回滚操作将再次进行 ms 切换，存在闪断。
回滚成功后，新版本的计算节点将被立即销毁。销毁后，若需重新升级到目标新版本，需重新发起完整升级流程。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏单击任务列表。
3. 在任务列表上方选择目标集群所在地域，并在列表找到目标集群，单击其操作列的立即回滚。
说明：
您也可以通过路径：目标集群管理页 > 详情/升级 > 历史升级记录 > 立即回滚，进入目标集群的版本回滚弹窗。
4. 在弹窗中，输入：ROLLBACK，单击确认回滚。
立即释放 slave
若内核小版本升级后，您的业务对新的内核小版本适配度高，无需回退至低内核小版本时，您可参考如下操作提前结束回滚窗口期，立即释放 slave，以获得全部功能的使用。仅跨 slave 升级方式在回滚窗口期内支持以下操作。
注意：
执行以下操作后，低版本 slave 将被销毁，您将无法再回滚到升级前的低版本。
执行以下操作后，回滚窗口期立即结束。
执行以下操作后，集群恢复正常运维操作（参数修改、代理调整、账号管理等封禁立即解除）。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在左侧导航栏单击任务列表。
3. 在任务列表上方选择目标集群所在地域，并在列表找到目标集群，单击其操作列的立即释放 slave。
说明：
您也可以通过路径：目标集群管理页 > 详情/升级 > 历史升级记录 > 立即释放 slave，进入目标集群的版本释放弹窗。
4. 在弹窗中，输入：RELEASE，单击确认释放。
查询历史升级记录
通过如下操作，您可以查询对应集群关于内核小版本的历史升级记录。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在集群列表页，根据您实际使用的视图模式进行操作，进入数据库内核小版本升级窗口。
1. 在左侧集群列表，单击目标集群，进入集群管理页。
2. 在集群管理页，数据库版本后，单击详情/升级。
1. 在集群列表，找到目标集群，单击集群 ID 或操作列的管理，进入集群详情页。
2. 在集群详情页的配置信息 > 数据库版本后，单击详情/升级。
3. 在弹出的侧边栏，单击历史升级记录。
4. 在历史升级记录页签，您可以查询：升级时间、升级方式、版本变更、状态等信息。
回滚窗口期功能受限说明
当升级方式选择为跨 slave 升级，且集群当前处于回滚窗口期时，为保障集群稳定性与数据安全，系统将暂时限制部分功能操作。待回滚窗口期结束后，或您主动执行了立即回滚、立即释放 slave 操作后，集群的受限功能将自动恢复可用。
您可参考以下表格，了解上述场景下未受限的功能项；实际可执行的功能操作请以控制台界面显示为准。
功能 | 功能项（未受限） |
计费 | 存储手动扩容 |
| 存储超用 |
| 设置自动续费 |
弹性与扩展 | 规格变更 |
| 取消规格变更任务 |
基础功能 | 新建集群 |
| 重启 |
账号管理 | 创建账号 |
| 密码修改 |
| 权限修改 |
| 修改主机 |
| 修改连接数 |
| 修改备注 |
| 克隆账号 |
| 删除账号 |
数据库管理 | 创建数据库 |
| 修改数据库 |
| 删除数据库 |
| 批量删除数据库 |
| 数据导入 |
数据安全 | 下载 CA 证书 |
数据库审计 | 开通/关闭审计服务 |
| 修改审计规则 |
| 修改审计服务 |
| 配置日志投递 |
| 查看审计日志 |
| 创建规则模板 |
| 编辑规则模板 |
| 删除规则模板 |
参数设置 | 另存为模板 |
| 最近修改记录 |
| 创建参数模板 |
| 修改参数模板 |
| 删除参数模板 |
| 导出参数模板 |
| 查看参数模板历史记录 |
安全组 | 配置安全组 |
| 调整安全组优先级 |
操作日志 | 查询慢日志明细 |
| 查询错误日志明细 |
| 日志下载 |
备份回档 | 手动备份 |
| 回档至新集群 |
| 回档至原集群 |
相关 API
API | 描述 |
本接口（UpgradeClusterVersion）用于更新内核小版本。 |
