TiKV v7.2.0集群提升副本数后未复制已有数据问题咨询

当你将PD的replication.max-replicas从1修改为2并重启集群后，已有数据未自动复制到新副本、仅新数据生效，可通过以下步骤触发集群完成已有数据的副本补全与重平衡：

1. 确认配置已生效 #

首先验证PD的max-replicas配置是否成功更新：

tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 config show replication.max-replicas

输出应为2，若不是，需重新确认配置修改与集群滚动重启是否完成。

2. 启用关键调度器 #

TiKV的副本补全与区域平衡依赖PD的核心调度器，若这些调度器未启用，PD不会主动处理已有region的副本不足问题：

• 启用副本调度器（负责补全region副本数）：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 scheduler enable replication-scheduler
  

• 启用区域平衡调度器（负责均衡集群数据分布）：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 scheduler enable balance-region-scheduler
  

可通过以下命令确认调度器状态：

tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 scheduler show

确保上述两个调度器处于Running状态。

3. 触发副本补全与重平衡 #

启用调度器后，PD会自动后台扫描所有region，为副本数不足的region添加新副本，并逐步平衡集群数据分布。若需加速进度（需注意避免集群IO/网络过载），可调整调度限速参数：

• 提高副本调度并发数（默认4）：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 config set schedule.replica-schedule-limit 8
  

• 提高区域平衡并发数（默认4）：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 config set schedule.balance-region-schedule-limit 8
  

4. 监控调度进度 #

可通过以下方式查看调度状态：

• 查看当前运行的调度任务：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 operator list
  

• 检查集群region副本状态：

  tiup ctl:v7.2.0 pd -u http://<PD节点IP>:2379 region check miss-replica
  

也可通过TiDB Dashboard的调度页面直观监控进度。

原因说明 #

修改max-replicas后，PD不会立即强制全量复制已有数据，而是依赖replication-scheduler自动扫描并补全副本数。若该调度器未启用，或集群重启后调度器未自动启动，就会出现已有数据不复制的情况。启用调度器后，PD会按调度限速逐步处理，避免对集群业务造成冲击。

内容的提问来源于stack exchange，提问作者Mike B