Skip to content

tidb-lightning: add checking PITR and active changefeed task #20647

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.

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

Merged
merged 2 commits into from
Jul 14, 2025
Merged
Changes from all commits
Commits
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
3 changes: 2 additions & 1 deletion tidb-lightning/tidb-lightning-prechecks.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,5 @@ summary: 本文档介绍了 TiDB Lightning 前置检查功能,确保 TiDB Ligh
| 数据文件是否有大 CSV 文件 | >= 5.3.0 | 当备份文件中出现大于 10 GiB 的 CSV 文件且无法进行自动切分 (StrictFormat=false) 的时候,会导致导入性能下降。该检查的目的是提醒用户确保数据格式的情况下,开启自动切分 CSV 功能。 |
| 是否可以从断点恢复 | >= 5.3.0 | 该检查是确保断点恢复过程中,不会出现对源文件和数据库中 schema 进行修改,导致导入错误数据的情况。|
| 是否可以导入数据到已存在的数据表中 | >= 5.3.0 | 当导入到已创建好的数据表中时,该检查尽可能的检查此次导入的源文件是否和已存在的数据表匹配。检查列数是否匹配,如果源文件存在列名,则检查列名是否匹配。当源文件存在缺省列,则检查缺省列在数据表中是否存在 Default Value,如果存在,则检查通过。|
| 导入的目标表是否为空 | >= 5.3.1 | 如果导入的目标表不为空,则 TiDB Lightning 会自动报错退出;如果开启了并行导入模式 (parallel-import = true),则会跳过此检查项。 |
| 导入的目标表是否为空 | >= 5.3.1 | 如果导入的目标表不为空,则 TiDB Lightning 会自动报错退出;如果开启了并行导入模式 (parallel-import = true),则会跳过此检查项。 |
| 检查集群是否开启了 PITR 或有 Changefeed 任务 | >= 6.5.0 | TiDB Lightning 物理导入模式不兼容 PITR 和 Changefeed,如果集群开启了 PITR,或者有运行中的 Changefeed,则 TiDB Lightning 会自动报错退出;如果你确定要导入的表不需要使用 PITR 或者 Changefeed 进行同步,则可跳过此检查项来使用 TiDB Lightning 物理导入模式导入数据。 |