From 5b9a4923c3d24a0e8eac80867cc8a8bc7f954665 Mon Sep 17 00:00:00 2001 From: Frank945946 <108602632+Frank945946@users.noreply.github.com> Date: Mon, 14 Jul 2025 10:39:14 +0800 Subject: [PATCH 1/2] Update tidb-lightning-prechecks.md --- tidb-lightning/tidb-lightning-prechecks.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tidb-lightning/tidb-lightning-prechecks.md b/tidb-lightning/tidb-lightning-prechecks.md index 6348059852e1..5110b2ce43a7 100644 --- a/tidb-lightning/tidb-lightning-prechecks.md +++ b/tidb-lightning/tidb-lightning-prechecks.md @@ -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),则会跳过此检查项。 | \ No newline at end of file +| 导入的目标表是否为空 | >= 5.3.1 | 如果导入的目标表不为空,则 TiDB Lightning 会自动报错退出;如果开启了并行导入模式 (parallel-import = true),则会跳过此检查项。 | +| 检查集群是否开启了 PITR 或有 Changefeed 任务 | >= 6.5.0 | Lightning 物理导入模式不兼容 PITR 和 Changefeed,如果集群开启了 PITR,或者有运行中的 Changefeed,则 TiDB Lightning 会自动报错退出;如果明确 Lightning 导入的表不需要 PITR 或者 Changefeed 进行同步,则可跳过此检查项来使用 Lightning 物理导入模式导入数据。 | From 2a74433284d1799e7e47b1ed34b0b1662af84c9b Mon Sep 17 00:00:00 2001 From: Frank945946 <108602632+Frank945946@users.noreply.github.com> Date: Mon, 14 Jul 2025 16:13:28 +0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Lilian Lee --- tidb-lightning/tidb-lightning-prechecks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-lightning/tidb-lightning-prechecks.md b/tidb-lightning/tidb-lightning-prechecks.md index 5110b2ce43a7..f34235941c57 100644 --- a/tidb-lightning/tidb-lightning-prechecks.md +++ b/tidb-lightning/tidb-lightning-prechecks.md @@ -19,4 +19,4 @@ summary: 本文档介绍了 TiDB Lightning 前置检查功能,确保 TiDB Ligh | 是否可以从断点恢复 | >= 5.3.0 | 该检查是确保断点恢复过程中,不会出现对源文件和数据库中 schema 进行修改,导致导入错误数据的情况。| | 是否可以导入数据到已存在的数据表中 | >= 5.3.0 | 当导入到已创建好的数据表中时,该检查尽可能的检查此次导入的源文件是否和已存在的数据表匹配。检查列数是否匹配,如果源文件存在列名,则检查列名是否匹配。当源文件存在缺省列,则检查缺省列在数据表中是否存在 Default Value,如果存在,则检查通过。| | 导入的目标表是否为空 | >= 5.3.1 | 如果导入的目标表不为空,则 TiDB Lightning 会自动报错退出;如果开启了并行导入模式 (parallel-import = true),则会跳过此检查项。 | -| 检查集群是否开启了 PITR 或有 Changefeed 任务 | >= 6.5.0 | Lightning 物理导入模式不兼容 PITR 和 Changefeed,如果集群开启了 PITR,或者有运行中的 Changefeed,则 TiDB Lightning 会自动报错退出;如果明确 Lightning 导入的表不需要 PITR 或者 Changefeed 进行同步,则可跳过此检查项来使用 Lightning 物理导入模式导入数据。 | +| 检查集群是否开启了 PITR 或有 Changefeed 任务 | >= 6.5.0 | TiDB Lightning 物理导入模式不兼容 PITR 和 Changefeed,如果集群开启了 PITR,或者有运行中的 Changefeed,则 TiDB Lightning 会自动报错退出;如果你确定要导入的表不需要使用 PITR 或者 Changefeed 进行同步,则可跳过此检查项来使用 TiDB Lightning 物理导入模式导入数据。 |