TDSQL-C MySQL 版 升级内核小版本

注意：说明：

注意：如需了解各个数据库内核小版本的功能详情，请参见 内核版本更新动态。

一、操作场景

当系统发布新的数据库内核小版本时，或者你当前集群的数据库内核小版本过旧，需要升级到新的数据库内核小版本时，你可以通过控制台进行手动升级。

注意：说明：

注意：当发生触发集群迁移的操作（如数据库版本升级等）时，系统不会主动将你的集群升级至最新内核小版本，如需升级，你可手动升级。

注意：警告：

注意：如果后台程序出现 bug，或者当系统发现安全隐患时，系统将通过站内信、短信等方式推送升级通知，TDSQL-C MySQL 版会在指定时间进行系统升级和修复，但此自动升级仅为系统辅助升级手段，并不保证所有实例均能立即升级至最新内核小版本。你可以在集群管理页查看内核小版本状态，并及时手动升级内核小版本，以避免历史内核小版本可能存在的潜在风险。如在紧急服务升级/版本升级通知告知你6个月后，因你的原因仍未完成升级，因此产生的业务中断、数据丢失等损失和后果均由你承担。详情请参见 TDSQL-C MySQL 版服务等级协议。

二、升级规则

为保证数据复制一致性，待升级数据库内核小版本的集群下的关联实例（读写实例、只读实例）会一起进行内核小版本升级。

三、升级方式说明

当前内核小版本升级功能已优化升级，升级方式由历史的仅支持“秒级升级”，更新为支持“秒级升级”与“跨 slave 升级”两种升级方式，你可在升级配置弹窗中根据业务诉求自主选择。两种方式的差异如下：

当升级路径涉及关键变更时（系统自动判断），为了保障可回滚性，你只能选择跨 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. 在弹窗下根据需要进行设置，勾选“已阅读并同意数据库版本升级说明”，单击确定。

5. 如需了解升级任务进度，你可前往 任务列表 进行查询。

6. 当实例运行状态更新为“运行中”时，即升级完成。

七、立即回滚

若内核小版本升级后，你的业务存在兼容性或性能问题，需要回退至低内核小版本时，你可参考如下操作进行回退。仅跨 slave 升级方式在回滚窗口期内支持以下操作。

1. 登录 TDSQL-C MySQL 版控制台。

2. 在左侧导航栏单击任务列表。

3. 在任务列表上方选择目标集群所在地域，并在列表找到目标集群，单击其操作列的立即回滚。

注意：说明：

注意：你也可以通过路径：目标集群管理页 > 详情/升级 > 历史升级记录 > 立即回滚，进入目标集群的版本回滚弹窗。

4. 在弹窗中，输入：ROLLBACK，单击确认回滚。

八、立即释放 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 操作后，集群的受限功能将自动恢复可用。

你可参考以下表格，了解上述场景下未受限的功能项；实际可执行的功能操作请以控制台界面显示为准。

十一、相关 API