# 手动切换副本集主备节点
#### 操作场景
副本集实例由主节点、备节点和隐藏节点组成。主节点和备节点对外提供访问地址，隐藏节点用于备份数据。当主节点故障时，系统会自动分配新的主节点保障高可用。同时，文档数据库服务提供主备切换功能，供用户在容灾演练等场景下自行切换主备节点。
#### 使用须知
- 实例状态为正常、恢复检查中、转包周期中、修改安全组中时，允许切换主备节点。
- 主备节点切换可能会造成1分钟的服务闪断，切换前请确认客户端具备重连机制。
- 新添加的备节点，需要重新配置高可用连接地址，且为保证实例性能，会有12个小时的冻结期，冻结期内的备节点不参与主备切换。
- 实例必须处于运行状态才可进行主备切换。
- 主备同步的延迟时间过长时，主备切换耗时可能很久。因此，当主备同步的延迟时间超过300s时，控制台将不允许下发主备切换。关于副本集主备同步的延迟时间，请参见[副本集中主备同步存在多长时间的延迟](https://support.huaweicloud.com/dds_faq/dds_faq_0006.html)。
 
#### 操作步骤
- [主备切换]
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001746964649.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001699165246.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，选择指定的副本集实例，单击实例名称。
  
  5. 在"基本信息"页面"节点信息"区域，单击"主备切换"。 
     图1主备切换   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001218760693.png "点击放大")
     
     
  
  6. 在弹出框中单击"是"，开始执行主备切换。
  
  7. 查看切换结果。 
     - 主备切换过程中，实例运行状态显示为"主备切换中"，切换完成后，实例状态显示为"正常"。
     
     - 在实例"基本信息"页面的"节点信息"区域，可查看切换后的主备节点。
     
     - 切换完成后，原先的主节点会变为备节点，如果需要重新连接副本集主节点，请参见[连接实例](https://support.huaweicloud.com/usermanual-dds/dds_03_0332.html)。
     
     
     
     
   
- [备节点强制升主]
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002061241061.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002025241842.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，选择指定的副本集实例，单击实例名称。
  
  5. 在"基本信息"页面"节点信息"区域，选择角色为Secondary的节点，单击操作列的"强制升主"。 
     图2强制升主   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001632019086.png "点击放大")
     
     
  
  6. 在弹出框中单击"是"，开始执行强制升主。 
     图3执行强制升主   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001631859170.png "点击放大")
     
     
  
  7. 查看强制升主结果。 
     - 在实例"基本信息"页面的"节点信息"区域，可查看操作后的主备节点。
     
     
     
     
   
#### 相关API
| API                                                                    | 说明                  |
|:---|:---|
| [切换实例的主备节点](https://support.huaweicloud.com/api-dds/dds_api_0050.html) | 切换副本集实例和集群实例下的主备节点。 |