From 425344cd146f44f9d313182e45154aca10782767 Mon Sep 17 00:00:00 2001 From: Jianjun Liao Date: Mon, 15 Sep 2025 13:32:52 +0800 Subject: [PATCH 1/7] draft Signed-off-by: Jianjun Liao --- br/br-pitr-manual.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 1c07d52f7e67..fc8067f07979 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -548,6 +548,11 @@ tiup br restore point --pd="${PD_IP}:2379" \ > - 过滤器选项适用于快照备份和日志备份的恢复阶段。 > - 可以指定多个 `--filter` 选项来包含或排除不同的模式。 > - PITR 过滤暂不支持系统表。如果需要恢复特定的系统表，请使用 `br restore full` 命令并配合过滤器，注意该命令仅恢复快照备份数据（而非日志备份数据）。 +> - 恢复任务匹配正则表达式匹配的是 `restored-ts` 时刻的表的名字，因此有以下三种情况： +> - - 1. 表 A (table id = 1) 在 `restored-ts` 时刻及以前的表名始终匹配 `--filter` 正则表达式，则 PITR 会恢复这张表。 +> - - 2. 表 B (table id = 2) 在 `restored-ts` 前的某个时刻的表名不匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻的表名匹配，则 PITR 会恢复这张表。 +> - - 3. 表 C (table id = 3) 在 `restored-ts` 前的某个时刻的表名匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻的表名不匹配，则 PITR 不会恢复这张表。 +> - 你可以通过使用库表过滤功能来在线恢复部分数据。在线恢复过程中，注意不要创建与恢复表库表名相同的表，避免因冲突而失败。在该恢复过程中由 PITR 创建的表都是不可读写的，避免在恢复过程中出现数据不一致。在恢复结束时，这些表会在 TiDB Domain 内存缓存中更新，并且被允许进行读写操作。 ### 并发恢复操作 From 0c72579a7e462b9ad7e14ff7e0869bd55b266ff5 Mon Sep 17 00:00:00 2001 From: Jianjun Liao Date: Mon, 15 Sep 2025 13:36:08 +0800 Subject: [PATCH 2/7] commit some suggestions Signed-off-by: Jianjun Liao --- br/br-pitr-manual.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index fc8067f07979..08b5ed870e91 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -580,7 +580,8 @@ tiup br restore point --pd="${PD_IP}:2379" \ > **注意：** > -> 每个并发恢复操作必须作用于不同的数据库或不重叠的表集合。尝试并发恢复重叠数据集将导致错误。 +> - 每个并发恢复操作必须作用于不同的数据库或不重叠的表集合。尝试并发恢复重叠数据集将导致错误。 +> - 多个恢复任务会大量占用资源，在系统 cpu，io 资源充分的时候，可以考虑跑并行恢复任务。 ### 进行中的日志备份与快照恢复的兼容性 From d510d8cfa0619122f87b891fc2d13b8d287dcaec Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 25 Sep 2025 10:56:56 +0800 Subject: [PATCH 3/7] Update note list format to pass ci --- br/br-pitr-manual.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 08b5ed870e91..ce959728237e 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -549,9 +549,9 @@ tiup br restore point --pd="${PD_IP}:2379" \ > - 可以指定多个 `--filter` 选项来包含或排除不同的模式。 > - PITR 过滤暂不支持系统表。如果需要恢复特定的系统表，请使用 `br restore full` 命令并配合过滤器，注意该命令仅恢复快照备份数据（而非日志备份数据）。 > - 恢复任务匹配正则表达式匹配的是 `restored-ts` 时刻的表的名字，因此有以下三种情况： -> - - 1. 表 A (table id = 1) 在 `restored-ts` 时刻及以前的表名始终匹配 `--filter` 正则表达式，则 PITR 会恢复这张表。 -> - - 2. 表 B (table id = 2) 在 `restored-ts` 前的某个时刻的表名不匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻的表名匹配，则 PITR 会恢复这张表。 -> - - 3. 表 C (table id = 3) 在 `restored-ts` 前的某个时刻的表名匹配 `--filter` 正则表达式，但在 `restored-ts` 时刻的表名不匹配，则 PITR 不会恢复这张表。 +> - 表 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 创建的表都是不可读写的，避免在恢复过程中出现数据不一致。在恢复结束时，这些表会在 TiDB Domain 内存缓存中更新，并且被允许进行读写操作。 ### 并发恢复操作 From ea89f76e65ddafa8f23ea5a4dedcbdf136fbaaef Mon Sep 17 00:00:00 2001 From: BornChanger <97348524+BornChanger@users.noreply.github.com> Date: Fri, 26 Sep 2025 13:25:05 +0800 Subject: [PATCH 4/7] Update br/br-pitr-manual.md Co-authored-by: Lilian Lee --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index ce959728237e..d1e9da1e81c8 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -581,7 +581,7 @@ tiup br restore point --pd="${PD_IP}:2379" \ > **注意：** > > - 每个并发恢复操作必须作用于不同的数据库或不重叠的表集合。尝试并发恢复重叠数据集将导致错误。 -> - 多个恢复任务会大量占用资源，在系统 cpu，io 资源充分的时候，可以考虑跑并行恢复任务。 +> - 多个恢复任务会占用大量系统资源。仅在 CPU 和 I/O 资源充足时，才建议并行执行恢复任务。 ### 进行中的日志备份与快照恢复的兼容性 From 9105c7368be4629f6f9e3a6b328df31682d953dd Mon Sep 17 00:00:00 2001 From: BornChanger <97348524+BornChanger@users.noreply.github.com> Date: Fri, 26 Sep 2025 13:25:18 +0800 Subject: [PATCH 5/7] Update br/br-pitr-manual.md Co-authored-by: Lilian Lee --- br/br-pitr-manual.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index d1e9da1e81c8..aaf69ca6d9c6 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -549,9 +549,9 @@ 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 不会恢复这张表。 +> - 表 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 创建的表都是不可读写的，避免在恢复过程中出现数据不一致。在恢复结束时，这些表会在 TiDB Domain 内存缓存中更新，并且被允许进行读写操作。 ### 并发恢复操作 From 225aa522a47548616d639780a7b586c3bef55768 Mon Sep 17 00:00:00 2001 From: BornChanger <97348524+BornChanger@users.noreply.github.com> Date: Fri, 26 Sep 2025 13:25:25 +0800 Subject: [PATCH 6/7] Update br/br-pitr-manual.md Co-authored-by: Lilian Lee --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index aaf69ca6d9c6..d2cff923c608 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -548,7 +548,7 @@ tiup br restore point --pd="${PD_IP}:2379" \ > - 过滤器选项适用于快照备份和日志备份的恢复阶段。 > - 可以指定多个 `--filter` 选项来包含或排除不同的模式。 > - PITR 过滤暂不支持系统表。如果需要恢复特定的系统表，请使用 `br restore full` 命令并配合过滤器，注意该命令仅恢复快照备份数据（而非日志备份数据）。 -> - 恢复任务匹配正则表达式匹配的是 `restored-ts` 时刻的表的名字，因此有以下三种情况： +> - 恢复任务中的正则表达式匹配的是 `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 **不会**恢复这张表。 From 500abe8e7eba6a2ddbc5025ae5129dcb491892c6 Mon Sep 17 00:00:00 2001 From: BornChanger <97348524+BornChanger@users.noreply.github.com> Date: Fri, 26 Sep 2025 23:27:13 +0800 Subject: [PATCH 7/7] Update br/br-pitr-manual.md Co-authored-by: Lilian Lee --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index d2cff923c608..b905935c168b 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -552,7 +552,7 @@ tiup br restore point --pd="${PD_IP}:2379" \ > - 表 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 创建的表都是不可读写的，避免在恢复过程中出现数据不一致。在恢复结束时，这些表会在 TiDB Domain 内存缓存中更新，并且被允许进行读写操作。 +> - 你可以使用库表过滤功能在线恢复部分数据。在线恢复过程中，不要创建与恢复对象同名的库表，否则恢复任务会因冲突而失败。在该恢复过程中，由 PITR 创建的表都不可读写，直至恢复完成后，这些表才会被允许正常读写。 ### 并发恢复操作