Skip to content

docs: add checkpoint restore warning #21711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
YuJuncen wants to merge 3 commits into
base: master
Choose a base branch
from
+12 −0
Open

docs: add checkpoint restore warning #21711

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
61edb2c
docs: add checkpoint restore warning
YuJuncen Jun 11, 2026
b814a37
Apply suggestion from @qiancai
YuJuncen Jun 24, 2026
9dfcc6d
Apply suggestion from @YuJuncen
YuJuncen Jun 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions br/br-checkpoint-restore.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,18 @@ br 工具暂停 GC 的原理是通过执行 `SET config tikv gc.ratio-threshold

在恢复失败后，请避免向集群写入或删除数据、删除或创建表。由于备份数据中可能包含重命名表的 DDL 操作，断点恢复无法确认被删除的表或已存在的表是否是外部操作引起的，这会影响下次重试恢复的准确性。

> **警告：**
>
> 从 v8.5.5 开始，如果你删除了正在恢复的表，之后再从 checkpoint 重试恢复，可能会遇到以下问题（详见 [#68709](https://github.com/pingcap/tidb/issues/68709))：
>
> - 恢复因 checksum 校验失败而终止。
> - 数据在恢复完成后一段时间丢失。
>
> 如果确定要放弃当前的恢复结果，在 `DROP` 掉已经恢复的 table 之外，还需要：
>
> - 对于 `restore point`，请执行 [`br abort`](/br/br-pitr-manual.md#中止恢复操作)。
> - 对于 `restore full`，请手动删除下游集群中的 checkpoint 数据表（形如 `__TiDB_BR_Temporary_Snapshot_Restore_Checkpoint_<restoreID>`，你可以在 `mysql.tidb_restore_registry` 找到 restore 的 ID）。

### 不建议跨大版本重新恢复

不建议进行跨大版本的断点恢复操作。对于使用 v8.5.0 之前长期支持 (Long-Term Support, LTS) 版本 br 恢复失败的集群，无法通过 v8.5.0 或更新的 LTS 版本 br 继续恢复，反之亦然。
Expand Down
Loading