From c6f0b8102fb6b00e1de64f16ebbbd8dade09e77d Mon Sep 17 00:00:00 2001 From: Aolin Date: Fri, 18 Jul 2025 11:20:26 +0800 Subject: [PATCH 1/2] disable switch to import mode for global sort, and add tikv-worker-url config --- sql-statements/sql-statement-import-into.md | 2 +- tidb-configuration-file.md | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/sql-statements/sql-statement-import-into.md b/sql-statements/sql-statement-import-into.md index 1a3586ae3920..123db003aee1 100644 --- a/sql-statements/sql-statement-import-into.md +++ b/sql-statements/sql-statement-import-into.md @@ -145,7 +145,7 @@ SET 表达式左侧只能引用 `ColumnNameOrUserVarList` 中没有的列名。 | `SKIP_ROWS=` | CSV | 指定需要跳过的行数，默认为 `0`。可通过该参数跳过 CSV 中的 header，如果是通过通配符来指定所需导入的源文件，该参数会对 fileLocation 中通配符匹配的所有源文件生效。 | | `SPLIT_FILE` | CSV | 将单个 CSV 文件拆分为多个 256 MiB 左右的小文件块进行并行处理，以提高导入效率。该参数仅对**非**压缩的 CSV 文件生效，且该参数和 TiDB Lightning 的 [`strict-format`](/tidb-lightning/tidb-lightning-data-source.md#启用严格格式) 有相同的使用限制。注意，你需要为该选项显式指定 `LINES_TERMINATED_BY`。| | `DISK_QUOTA=''` | 所有文件格式 | 指定数据排序期间可使用的磁盘空间阈值。默认值为 TiDB [临时目录](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)所在磁盘空间的 80%。如果无法获取磁盘总大小，默认值为 50 GiB。当显式指定 `DISK_QUOTA` 时，该值同样不能超过 TiDB [临时目录](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)所在磁盘空间的 80%。 | -| `DISABLE_TIKV_IMPORT_MODE` | 所有文件格式 | 指定是否禁止导入期间将 TiKV 切换到导入模式。默认不禁止。如果当前集群存在正在运行的读写业务，为避免导入过程对这部分业务造成影响，可开启该参数。 | +| `DISABLE_TIKV_IMPORT_MODE` | 所有文件格式 | 指定是否禁止导入期间将 TiKV 切换到导入模式。默认不禁止。如果当前集群存在正在运行的读写业务，为避免导入过程对这部分业务造成影响，可开启该参数。从 v9.0.0 版本开始，使用全局排序功能导入数据时，TiKV 默认不会切换到导入模式。 | | `THREAD=` | 所有文件格式、`SELECT` 语句的查询结果 | 指定导入的并发度。对于 `IMPORT INTO ... FROM FILE`，`THREAD` 默认值为 TiDB 节点的 CPU 核数的 50%，最小值为 `1`，最大值为 CPU 核数；对于 `IMPORT INTO ... FROM SELECT`，`THREAD` 默认值为 `2`，最小值为 `1`，最大值为 TiDB 节点的 CPU 核数的 2 倍。如需导入数据到一个空集群，建议可以适当调大该值，以提升导入性能。如果目标集群已经用于生产环境，请根据业务要求按需调整该参数值。 | | `MAX_WRITE_SPEED=''` | 所有文件格式 | 控制写入到单个 TiKV 的速度，默认无速度限制。例如设置为 `1MiB`，则限制写入速度为 1 MiB/s。| | `CHECKSUM_TABLE=''` | 所有文件格式 | 配置是否在导入完成后对目标表是否执行 CHECKSUM 检查来验证导入的完整性。可选的配置项为 `"required"`（默认）、`"optional"` 和 `"off"`。`"required"` 表示在导入完成后执行 CHECKSUM 检查，如果 CHECKSUM 检查失败，则会报错退出。`"optional"` 表示在导入完成后执行 CHECKSUM 检查，如果报错，会输出一条警告日志并忽略报错。`"off"` 表示导入结束后不执行 CHECKSUM 检查。 | diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index ba47de88367e..d33f07896b2d 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -77,6 +77,14 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 默认值：-1 + 当 `tmp-storage-path` 的剩余可用容量低于 `tmp-storage-quota` 所定义的值时，TiDB server 启动时将会报出错误并退出。 +### `tikv-worker-url` 从 v9.0.0 版本开始引入 + +> **警告：** +> +> 此配置项目前未被使用，可能会在未事先通知的情况下发生变化或删除。 + ++ 指定 `tikv-worker` 的 URL。 + ### `lease` + DDL 租约超时时间。 From c42fdc545b2048271b9b854a0065eb2104fddbbb Mon Sep 17 00:00:00 2001 From: Aolin Date: Sun, 28 Sep 2025 14:41:44 +0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Grace Cai --- tidb-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index d33f07896b2d..8e7e899d6c0a 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -81,7 +81,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ > **警告：** > -> 此配置项目前未被使用，可能会在未事先通知的情况下发生变化或删除。 +> 当前版本中该配置项控制的功能尚未完全生效，可能会在未事先通知的情况下发生变化或删除。 + 指定 `tikv-worker` 的 URL。