一、版本说明
将副本节点提升为主节点(组)的原理是在集群中执行 cluster failover 命令,实现将主节点的角色切换到从节点。具体支持的版本信息如下所示。
| 存储引擎 | 支持的版本 | 支持的架构 |
| Redis 版 | 4.0及以上 | 标准架构、集群架构 |
| Valkey 版 | 8.0及以上 | 标准架构、集群架构 |
| Memcached 版 | 不支持 | |
二、注意事项
·提主过程中服务会有短暂访问抖动,抖动的时间在几秒到3分钟以内,切换过程中 BLPOP、BRPOP、BRPOPLPUSH、SUBSCRIBE 等阻塞命令会有一次或者多次失败。
·副本提主切换过程中,将会存在1分钟内的实例只读和业务闪断;执行过程可能会失败,通常重试即可执行成功。
注意:说明:
注意:多可用区部署的标准架构实例,切换主节点后,你的访问可能会跨可用区,导致访问延迟增加,QPS 降低。
三、前提条件
·数据库版本要求:Redis 4.0及其以上, ValKey 8.0。
·实例状态为运行中。
四、操作步骤
1. 登录 腾讯云分布式缓存数据库控制台。
2. 在右侧实例列表页面上方,选择地域。
3. 在实例列表中,找到需进行副本提主的多可用区实例。
4. 单击实例 ID,进入实例详情页面。
5. 在实例详情页面,单击节点管理页签,单击副本提主。
6. 在提升为主节点或主可用区的窗口,多可用区部署,配置新的主节点,以便将新主节点所在可用区标记为新主可用区,并设置切换时间。
·标准架构
·集群架构
| 界面参数 | 参数含义 | 配置方式 |
| 实例 ID | 当前待副本提主的实例 ID。 | 确认实例正确。 |
| 内存配置 | 当前实例内存配置规格。 | 确认实例的规格信息。 |
| 原主节点 ID | 多 AZ 标准架构显示当前主节点的 ID。 | 确认当前主节点的 ID 信息。 |
| 新主节点 ID | 多 AZ 标准架构显示该参数,配置需切换为主节点的副本节点。 | 请在下拉列表选择待提升为主节点的副本节点。 |
| 原主节点组 | 多 AZ 集群架构显示该参数,显示当前主节点组名称。 | 确认当前主节点组名称。 |
| 新主节点组 | 多 AZ 集群架构显示该参数,配置需切换为主节点组的备节点组。 | 请在下拉列表选择待提升为主节点组的备节点组。 |
| 切换时间 | 选择副本提主的切换时间段。 | 立即切换:将立即发起切换任务。维护时间窗切换:即在维护时间窗发起切换任务,维护时间窗相关介绍与配置,请参见 设置维护时间窗。 |
7. 配置完成,确认无误后,单击确定。
五、相关 API
| API 接口 | 接口含义 |
| ChangeReplicaToMaster | 该接口仅支持多 AZ 实例副本组提主和单 AZ 副本提主。 |