租户端 数据库 云数据库 Redis®（Redis®） 操作指南

副本升主

最近更新时间: 2026-03-13 09:03:00

操作场景

副本升主（Replica Promotion） 指在检测到主节点存在潜在风险或触发告警时，通过手动操作将数据同步完备的从节点提升为新主节点的过程。该操作可在主节点发生实际故障前实现热切换，保障数据服务零中断，是预防性维护的核心运维能力。

实现说明

云数据库 Redis® 实例将副本节点提升为主节点（组）的原理是在集群中执行 cluster failover 命令，实现将主节点的角色切换到从节点。

说明：

多可用区部署的标准架构实例，切换主节点后，您的访问可能会跨可用区，导致访问延迟增加，QPS 降低。

注意事项

  • 提主过程中服务会有短暂访问抖动，抖动的时间在几秒到3分钟以内，切换过程中 BLPOP、BRPOP、BRPOPLPUSH、SUBSCRIBE 等阻塞命令会有一次或者多次失败。
  • 副本提主切换过程中，将会存在1分钟内的实例只读和业务闪断；执行过程可能会失败，通常重试即可执行成功。

前提条件

  • 数据库版本要求：4.0及其以上。
  • 实例状态运行中。

操作步骤

  1. 登录租户端控制台，在左上角，单击**，在【全部云产品】**的菜单中，选择【云数据库 Redis® 】。

  2. 在右侧实例列表页面上方，选择地域。

  3. 在实例列表中，找到需进行副本提主的多可用区实例。

  4. 单击实例 ID，进入实例详情页面。

  5. 在实例详情页面，单击节点管理页签，单击页面右上方的副本提主。

  6. 在提升为主节点或主可用区的窗口，阅读提主说明，实例多 AZ 部署，需要选择新主节点，以便将新主节点所在可用区标记为新主可用区，如下图以标准架构多AZ为例。

    界面参数 参数含义 配置方式
    实例 ID 当前的实例 ID。 确认实例正确。
    内存配置 当前实例内存配置规格。 确认实例的规格信息。
    原主节点 ID 实例多可用区标准架构部署，显示当前主节点的 ID。 确认当前主节点的 ID 信息。
    新主节点 ID 实例多可用区标准架构部署，显示该参数，配置需切换为主节点的副本节点，该节点所在可用区被标记为主可用区。 请在下拉列表选择待提升为主节点的副本节点。
    原主节点组 实例多可用区集群架构部署，显示当前主节点组名称。 确认当前主节点组名称。
    新主节点组 实例多可用区集群架构部署，配置需切换为主节点组的从节点组 ID。该节点组所在可用区被标记为主可用区。 请在下拉列表选择待提升为主节点组的从节点组。

  7. 配置完成，确认无误后，单击确定。