操作场景
云数据库 Redis® 提供了灵活的版本升级能力，帮助您将实例升级至更高版本，从而获得更丰富的功能特性和更优的性能表现。版本升级分为以下两种类型：
大版本升级：支持将实例从当前版本升级至更高的主版本。例如，您可以将 Redis 4.0 版本升级至 Redis 5.0 或 Redis 6.2 版本。
小版本升级：在当前大版本的基础上，升级至最新的小版本。小版本通常包含性能优化、问题修复等改进内容。
支持说明
云数据库 Redis® 提供 Redis 引擎和 Valkey 引擎两种存储引擎，两者均兼容 Redis 协议。版本升级的支持范围和限制如下：
存储引擎 | 支持的版本 | 升级规则 |
Redis 引擎 | 4.0、5.0、6.2、7.0 | 大版本升级： 支持低版本升级至高版本：将实例从当前版本升级至相邻的更高版本。 例如：Redis 4.0 → Redis 5.0，Redis 5.0 → Redis 6.2，Redis 6.2 → Redis 7.0。 支持跨版本升级：跳过中间版本，直接将实例升级至更高的目标版本。 例如：Redis 4.0 → Redis 6.2（跳过 5.0），Redis 4.0 → Redis 7.0（跳过 5.0 和 6.2），Redis 5.0 → Redis 7.0（跳过 6.2）。 不支持版本降级：版本升级为单向操作，一旦升级完成，无法回退至低版本。 例如：Redis 6.2无法降级至 Redis 5.0，Redis 7.0无法降级至 Redis 6.2 或更早版本。如需使用低版本，请新建对应版本的实例。 小版本升级： 系统自动检测可升级的小版本，不支持自定义目标版本。 |
Valkey 引擎 | 8.0 | 大版本升级： 当前仅支持8.0版本，暂无可升级的更高版本。 Redis 7.0及之前的版本无法升级至 Valkey 8.0。 小版本升级：系统自动检测可升级的小版本，不支持自定义目标版本。 |
升级过程及影响
注意：
大版本升级期间，实例将出现短时不可读写状态（持续约 1 分钟），且伴随客户端连接秒级中断。 为保障业务连续性，请务必在业务低峰期执行操作。
小版本升级期间，客户端连接可能出现秒级中断。为降低对业务的影响，建议在业务低峰期进行操作。
序号 | 阶段 | 大版本升级 | 小版本升级 |
1 | 资源申请 | 申请新大版本实例资源，包括 Proxy 和 Redis 节点（主节点、副本节点）资源。 | 申请新小版本 Redis 节点（主节点、副本节点）资源。 |
2 | 同步数据 | 同步全量和增量数据至新节点。 | 同步全量和增量数据至新节点。 |
3 | 等待切换 | 根据您选择的切换策略，立即切换或在维护时间窗内执行切换。 | 根据您选择的切换策略，立即切换或在维护时间窗内执行切换。 |
4 | 版本切换 | 到达切换条件后，系统将对 Proxy、副本节点和主节点执行版本变更与路由切换。此过程会刷新集群的路由信息并处理存量连接，导致实例短时无法读写（约1分钟内）及客户端连接闪断，切换完成后旧版本节点将自动下线并回收。 | 系统将触发主从切换，将新节点提升为主角色并隔离旧节点。在节点切换期间存在秒级连接影响，完成后系统会更新 Proxy 路由并回收旧版本资源。 |
5 | 升级完成 | 升级完成后，系统更新实例版本信息。实例变更为新版本并恢复对外服务。 | 升级完成后，系统更新实例版本信息。实例变更为新版本并恢复对外服务。 |
升级前准备
在执行版本升级操作之前，请确认以下条件已满足：
目标实例当前处于运行中状态，且没有其他任务正在执行（如扩容、备份、参数修改等）。
已明确本次升级的目标版本，并了解目标版本的新特性和兼容性要求。
业务应用已具备数据库连接的自动重连能力，能够应对升级切换过程中的短暂连接中断。
建议在升级前对实例进行一次手动备份，以便在必要时进行数据恢复。
升级版本
1. 登录 Redis 控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到需升级版本的实例。
4. 单击其实例 ID，进入实例详情页面。
5. 在实例详情页面的规格信息区域，单击兼容版本后面的版本升级。
6. 在弹出的版本升级对话框，根据下表确认待升级实例的信息，配置升级的目标版本，单击确定，根据界面提示支付费用。
参数名称 | 参数说明 |
实例 ID | 待升级实例的 ID。 |
实例名称 | 待升级实例的名称。 |
兼容版本 | 待升级实例当前兼容 Redis 的版本。 |
架构版本 | 待升级实例的架构信息，当前仅支持标准架构升级版本。 |
内存容量 | 待升级实例的容量规格。 |
升级版本 | 请在下拉列表中选择升级的目标版本。支持低版本向高版本升级，且支持跨版本升级。 |
新规格预览 | 升级后实例规格预览信息。 |
切换时间 | 立即切换：数据同步接近完成（需同步的数据 < 10MB），执行切换动作。 维护时间窗切换：在实例的维护时间窗内，执行切换动作，如果在当前维护时间窗无法满足切换条件，将在下一次维护时间窗进行切换尝试。维护时间可在实例详情页的维护时间窗处修改。 |
总费用 | 升级实例，不涉及计费变更。 |
7. 在左侧导航栏，选择任务管理，等待任务执行完成，在实例列表查看实例的版本已经为升级后的版本。
升级小版本
1. 登录 Redis 控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到需升级版本的实例。
4. 单击其实例 ID，进入实例详情页面。
5. 在实例详情页面的规格信息区域，单击兼容版本后面的小版本升级。
注意：
系统会自动检测小版本，如果小版本升级按钮无法选择，表示该实例已经是最新的小版本。
6. 在升级小版本的对话框，确认实例信息及其升级的目标版本，选择切换时间。
立即切换：数据同步接近完成（需同步的数据 < 10MB），执行切换动作。
维护时间窗切换：在实例的维护时间窗内，执行切换动作，如果在当前维护时间窗无法满足切换条件，将在下一次维护时间窗进行切换尝试。维护时间可在实例详情页的维护时间窗处修改。
7. 在左侧导航栏，选择任务管理，等待任务执行完成，在实例列表查看实例的版本已经为升级后的小版本。
相关 API
接口名称 | 接口功能 |
升级实例版本 | |
升级实例小版本 |
