# 操作指导
#### 前提条件
- **软硬件要求** ：
  - 主备节点间网络互通，且防火墙已开放数据库端口和高可用通道端口。
  
  - 备节点磁盘空间充足，至少能容纳一份完整的数据副本。
   
- **依赖项** ：
  - 主备节点GaussDB软件版本必须完全一致。
  
  - 主节点状态正常。
   
- **权限要求**： 执行重建操作的操作系统用户须对主备节点的数据目录有读写权限，并且拥有数据库管理员权限。
 
#### 语法
```
gs_ctl build -D DATADIR -Z NODE-TYPE [-b MODE] [-M SERVERMODE]
```
#### 注意事项
- **高危操作** ：重建过程中，目标备节点上的旧数据将被**全部清除**。请确保操作对象正确，避免误操作。
- **性能影响** ：重建操作会大量消耗主节点的网络和存储资源，**务必在业务低峰期或维护窗口进行**。
- **监控**：重建过程耗时较长，建议在操作后持续监控集群状态、网络流量和主节点性能。
 
#### 操作步骤
以下演示当备节点（dn_6002）故障后，通过命令行手动触发重建的流程。
1. 登录目标节点。 
   以数据库用户（非root用户）登录到目标节点。
   若数据库进程部署在沙箱或容器中，需要进入对应的沙箱或容器。
   
   
2. 查询目标节点信息。 
   ```
   cm_ctl query -Cvid
   ```
   通过节点状态，确认目标节点是否存在异常（状态非Normal）。
   通过节点名称，确认目标节点的数据目录路径。例如：/var/lib/engine/data1/data/dn_6002（下述步骤以该路径作为演示）。
   
   
3. 执行重建命令。 
   1. 自动重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b auto -M standby
      ```
      
   
   2. 全量重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b full -M standby
      ```
      
   
   3. 增量重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b incremental -M standby
      ```
      
   
   4. 以备节点做服务端，进行自动重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b standby_auto -M standby
      ```
      
   
   5. 以备节点做服务端，进行全量重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b standby_full -M standby
      ```
      
   
   6. 以备节点做服务端，进行增量重建。
      ```
      gs_ctl build -D /var/lib/engine/data1/data/dn_6002 -Z datanode -b standby_incremental -M standby
      ```
      
   
   
   
   
4. 监控重建进度。 
   ```
   gs_ctl querybuild -D /var/lib/engine/data1/data/dn_6002
   ```
   
   
5. 验证重建结果。 
   当备节点状态显示为Normal后，连接到主节点执行查询，验证备节点是否在同步流复制状态。
   1. Quorum
      ```
      SELECT application_name, state, sync_state, sync_priority FROM pg_stat_replication;
      ```
      如果查询结果中能看到该备节点，且state为Streaming，则表明重建成功，同步正常。
      
   
   2. DCF
      ```
      SELECT channel, peer_role, peer_dcf_role, peer_state FROM gs_paxos_stat_replication;
      ```
      如果查询结果中能看到对应IP的备节点，且peer_state为Normal，则表明重建成功，同步正常。