云数据库 Tair（兼容 Redis®）：升级大版本

升级影响

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

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

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

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

  说明

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

注意事项

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

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

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

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

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

操作步骤

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

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

   说明

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

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

   警告

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

4. 单击确定。

相关API

常见问题

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

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

  说明

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

• Q：升级提示失败？

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

• Q：Redis开源版2.8实例能升级到哪个版本？

  A：Redis开源版2.8实例仅支持升级到5.0版本。