br: add a waring about multi br importing (pingcap#6890)

shawn0915 · Aug 25, 2021 · e6a57be · e6a57be
1 parent aae7e38
commit e6a57be
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 0 deletions.
diff --git a/br/backup-and-restore-faq.md b/br/backup-and-restore-faq.md
@@ -170,3 +170,11 @@ BR 不会备份统计信息（v4.0.9 除外）。所以在恢复存档后需要
 BR v4.0.9 备份统计信息使 BR 消耗过多内存，为保证备份过程正常，从 v4.0.10 开始默认关闭备份统计信息的功能。
 
 如果不对表执行 `ANALYZE`，TiDB 会因统计信息不准确而选不中最优化的执行计划。如果查询性能不是重点关注项，可以忽略 `ANALYZE`。
+
+## 是否可以同时使用多个 BR 命令对单个集群进行恢复？
+
+**强烈不建议**在单个集群中同时使用多个 BR 命令进行恢复，原因如下：
+
++ BR 在恢复数据时，会修改 PD 的一些全局配置。如果同时使用多个 BR 命令进行恢复，这些配置可能会被错误地覆写，导致集群状态异常。
++ 因为 BR 在恢复数据的时候会占用大量集群资源，事实上并行恢复能获得的速度提升也非常有限。
++ 多个 BR 并行恢复的场景没有经过测试，无法保证成功。
diff --git a/br/use-br-command-line-tool.md b/br/use-br-command-line-tool.md
@@ -261,6 +261,8 @@ br backup raw --pd $PD_ADDR \
 > * 在数据恢复的时候，每个 Peer 分布的位置是随机的，事先并不知道哪个节点将读取哪个文件。
 >
 > 使用共享存储可以避免这些情况。例如，在本地路径上安装 NFS，或使用 S3。利用这些网络存储，各个节点都可以自动读取每个 SST 文件，此时上述注意事项不再适用。
+> 
+> 同时，请注意同一时间对同一个集群只能运行一个恢复任务，否则可能会出现非预期的行为，详见 [FAQ](/br/backup-and-restore-faq.md#是否可以同时使用多个-br-命令对单个集群进行恢复)。
 
 ### 恢复全部备份数据