v8.5.5 br: support pitr filter and concurrent restore (#20919) (#21200)

* This is an automated cherry-pick of #20919

Signed-off-by: ti-chi-bot <[email protected]>

* br: resolve conflict and modify v9.0.0 to v8.5.5

---------

Signed-off-by: ti-chi-bot <[email protected]>
Co-authored-by: Jianjun Liao <[email protected]>
Co-authored-by: lilin90 <[email protected]>

Author: 3 people

br/br-pitr-manual.md

@@ -541,10 +541,15 @@ tiup br restore point --pd="${PD_IP}:2379" \
 
 > **注意：**
 >
-> - 使用过滤器恢复前，请确保目标集群中不存在与过滤器匹配的数据库或表，否则恢复将失败并报错。 
+> - 使用过滤器恢复前，请确保目标集群中不存在与过滤器匹配的数据库或表，否则恢复将失败并报错。
 > - 过滤器选项适用于快照备份和日志备份的恢复阶段。
 > - 可以指定多个 `--filter` 选项来包含或排除不同的模式。
 > - PITR 过滤暂不支持系统表。如果需要恢复特定的系统表，请使用 `br restore full` 命令并配合过滤器，注意该命令仅恢复快照备份数据（而非日志备份数据）。
+> - 恢复任务中的正则表达式匹配的是 `restored-ts` 时刻的表名，有以下三种情况：
+>     - 表 A (table id = 1) 在 `restored-ts` 时刻及之前，表名始终匹配 `--filter` 正则表达式，则 PITR 会恢复这张表。
+>     - 表 B (table id = 2) 在 `restored-ts` 前的某个时刻，表名不匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻匹配，则 PITR 会恢复这张表。
+>     - 表 C (table id = 3) 在 `restored-ts` 前的某个时刻，表名匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻**不**匹配，则 PITR **不会**恢复这张表。
+> - 你可以使用库表过滤功能在线恢复部分数据。在线恢复过程中，不要创建与恢复对象同名的库表，否则恢复任务会因冲突而失败。在该恢复过程中，由 PITR 创建的表都不可读写，直至恢复完成后，这些表才可正常读写。
 
 ### 并发恢复操作
 
@@ -572,7 +577,8 @@ tiup br restore point --pd="${PD_IP}:2379" \
 
 > **注意：**
 >
-> 每个并发恢复操作必须作用于不同的数据库或不重叠的表集合。尝试并发恢复重叠数据集将导致错误。
+> - 每个并发恢复操作必须作用于不同的数据库或不重叠的表集合。尝试并发恢复重叠数据集将导致错误。
+> - 多个恢复任务会占用大量系统资源。仅在 CPU 和 I/O 资源充足时，才建议并行执行恢复任务。
 
 ### 进行中的日志备份与快照恢复的兼容性