文档

升级大版本

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

随着Tair的版本迭代,新版本Tair通常具备更高性能、更安全稳定、更多功能等特性,同时新版本Tair可以获得更好的技术支持。若您希望使用新版云数据库 Tair(兼容 Redis),无需额外创建实例,您可以在控制台或通过API升级Tair实例的大版本。

升级影响

  • 在申请资源、升级备库或同步数据阶段,对实例服务无影响。

  • 在实例切换或主备切换阶段,实例将存在60秒以内的只读状态(等待数据完全同步),同时会发生秒级的连接闪断,请在业务低峰期进行升级。

    升级完成后,源实例的实例ID、连接地址、数据、白名单配置以及已创建的账号密码配置等均不会改变,请您确保应用程序具备重连机制。

  • 如果您的Redis实例为4.0版本,且业务中使用了布隆过滤器相关API(例如BF.ADD),升级大版本后将不再支持。

    说明

    由于早期的存量4.0版本实例中,布隆过滤器相关API处于未正式开放的状态,后续的大版本和新购的4.0版本实例中已取消支持,继续使用存在未知风险(例如执行缓存分析失败),建议您将其变配至Tair内存型以支持完善的布隆过滤器。

注意事项

  • 仅支持升级至相同部署模式,例如经典版Redis 5.0不支持升级至云原生版Redis 6.0等。

  • 若实例已创建DTS任务,会导致升级失败,请暂停DTS任务后重试。

  • 经典版实例,架构类型为集群架构,且申请了直连模式地址,升级时会报错The direct custins tranfer does not support upgrade major version。请释放直连模式地址后重试。

  • 若实例未释放经典网络,会导致升级失败,请释放经典网络后重试(释放经典网络后无法再申请,推荐使用更快、更安全的VPC网络)。

  • 升级大版本可能会导致实例内存使用量略有变化(约为-10%至10%),具体变化取决于不同Redis版本存储元数据的差异。建议在升级大版本之前,确保实例内存使用量低于80%,以避免升级后实例内存达到较高水平。

操作步骤

  1. 访问Redis实例列表,在上方选择地域,然后单击目标实例ID。

  2. 配置信息区域框中,选择版本右侧升级 > 大版本升级

    说明

    如果没有大版本升级按钮,表示该实例不支持升级版本。

  3. 在右侧弹出的面板中,选择升级的目标版本和执行时间。

    警告

    实例版本升级或主备切换时,实例将产生60秒以内的只读状态和秒级的连接闪断。推荐您选择可维护时间内执行,系统会在实例的可维护时间段内执行实例切换操作,可最大限度地降低影响。关于如何修改实例的可维护时间,请参见设置可维护时间段

  4. 单击确定

相关API

API

说明

ModifyInstanceMajorVersion

升级Redis实例的大版本。

常见问题

  • Q:为什么选择了执行时间为可维护时间内执行,实例的状态还是变成了大版本升级中?

    A:系统在执行相应的升级前置工作,例如申请资源、同步数据等,不会执行实例切换或主备切换,不会影响实例提供服务。

    说明

    只有在执行实例切换或主备切换时,才会产生60秒以内的只读状态和秒级的连接闪断。

  • Q:升级提示失败?

    A:如果您的实例为历史规格(即已下线规格),您需要先完成变更配置操作(可选择内存容量相同的规格),再执行升级大版本的操作。

  • Q:Tair 2.8实例能升级到哪个版本?

    A:Tair 2.8实例仅支持升级到Tair 5.0版本。