一、支持说明
标准架构升级至集群架构的版本支持情况如下:
| 升级规则 | 说明 |
| 支持同版本架构升级 | Redis 4.0及以上版本。ValKey 8.0及以上版本。 |
| 不支持跨版本架构升级 | 升级架构时不能同时升级版本。例如:不支持 Redis 4.0 标准架构 → Redis 5.0 集群架构。如需同时升级版本和架构,请先完成版本升级,再进行架构升级。 |
| 不支持 Redis 2.8 升级架构 | Redis 2.8版本不支持升级至集群架构。如需使用集群架构,请新建 Redis 4.0 及以上版本的集群架构实例。 |
| 不支持架构降级 | 架构升级为单向操作,集群架构无法降级至标准架构。 |
| 不支持跨可用区升级 | 暂不支持在升级架构的同时变更可用区。 |
二、计费说明
标准架构升级至集群架构后,将按照集群架构计费,费用会增加。具体费用,请参见 产品定价。
三、升级原理
从 Redis 4.0 版本开始,标准架构升级为集群架构(单分片)的本质是将实例的运行模式从无 Slot(槽位)限制升级为有 Slot 限制,整个过程不涉及数据搬迁。
| 项目 | 说明 |
| 升级耗时 | 通常在3分钟内完成。 |
| 连接影响 | 升级过程中存量连接会断开(闪断),业务需具备自动重连机制。 |
四、前提条件(兼容性检查)
由于标准架构与集群架构在命令支持上存在差异,为避免升级后导致业务故障,请在升级之前完成兼容性检查:
·命令兼容性差异:集群架构采用分布式数据存储,与标准架构的最大差异在于单个命令是否支持多 Key 访问。具体信息,请参见 命令兼容性。
·兼容性检查方案:升级前请务必参照 标准架构迁移集群架构检查 完成兼容性验证,确保业务代码能够在集群架构下正常运行。
五、操作步骤
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方,选择地域。
3. 在实例列表中,找到需升级版本的实例。
4. 单击实例 ID,进入实例详情页面。
5. 在实例详情页面的规格信息区域,单击架构版本后面的架构升级。
6. 在弹出的对话框,根据下表的参数解释配置升级参数。
| 参数名称 | 参数说明 |
| 实例 ID | 确认待升级架构的实例 ID。 |
| 实例名称 | 确认待升级架构实例名称 。 |
| 兼容版本 | 确认待升级实例当前兼容 Redis 的版本。 |
| 架构版本 | 确认待升级实例的架构信息。 |
| 内存容量 | 确认待升级实例的内存容量规格。 |
| 架构版本 | 请在下拉列表中选择升级的目标架构版本。当前仅支持标准架构升级集群架构,不支持从集群架构降级至标准架构。 |
| 新规格预览 | 升级后实例规格预览信息。 |
| 切换时间 | 立即切换:立即执行切换动作。维护时间窗切换:在实例的维护时间窗内,执行切换动作,维护时间可在实例详情页的维护时间窗处修改。建议选择在业务低峰时进行操作。 |
| 总费用 | 升级架构之后的费用。按量计费:实例升级架构之后每小时的计费单价。单击计费详情,可查看计费项目、计费公式,确认费用。包年包月:实例升级架构后到期之前的总费用。 |
7. 升级到集群架构版本存在命令兼容性风险,单击兼容性说明文档,确认兼容风险后,勾选升级到集群架构版本存在命令兼容性风险 (兼容性说明文档), 我已确认兼容性风险, 继续升级,单击确定,继续升级。
8. 在商品订单页面,确认购买的订单信息及所需支付的费用,将鼠标放在上,可了解支付费用的详细计算数据。确认无误,单击提交订单,支付完成后,返回实例列表,待实例状态变为运行中,在实例列表或实例详情中查看实例的架构版本已经为升级后的集群架构。
六、相关 API
| 接口名称 | 接口功能 |
| UpgradeInstanceVersion | 升级实例架构版本 |