From d5f980d5ea52f2d6d968ce71139f6bfb2d4dfffa Mon Sep 17 00:00:00 2001 From: zyguan Date: Wed, 3 Dec 2025 03:45:45 +0000 Subject: [PATCH 1/5] add doc for async-batch-get Signed-off-by: zyguan --- tidb-configuration-file.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index 47963d5704bb..136f80e78d5c 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -642,6 +642,11 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 当 `force-init-stats` 为 `true` 时，TiDB 启动时会等到统计信息初始化完成后再对外提供服务。需要注意的是，在表和分区数量较多且 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 为 `false` 的情况下，`force-init-stats` 为 `true` 可能会导致 TiDB 从启动到开始对外提供服务的时间变长。 + 当 `force-init-stats` 为 `false` 时，TiDB 在统计信息初始化未完成时即可对外提供服务，但由于统计信息初始化未完成，优化器会用 pseudo 统计信息进行决策，可能会产生不合理的执行计划。 +### `enable-async-batch-get` 从 v8.5.5 版本开始引入 + ++ 用于控制 TiDB 是否使用 Async KV API 来执行 Batch Get 操作。 ++ 默认值：`true` + ## opentracing opentracing 的相关的设置。 From 10035e489e1b886e6b932da2327b35a76896a9bf Mon Sep 17 00:00:00 2001 From: zyguan Date: Wed, 3 Dec 2025 17:36:33 +0800 Subject: [PATCH 2/5] Update tidb-configuration-file.md 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 136f80e78d5c..fa5e1be5b90e 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -642,7 +642,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 当 `force-init-stats` 为 `true` 时，TiDB 启动时会等到统计信息初始化完成后再对外提供服务。需要注意的是，在表和分区数量较多且 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 为 `false` 的情况下，`force-init-stats` 为 `true` 可能会导致 TiDB 从启动到开始对外提供服务的时间变长。 + 当 `force-init-stats` 为 `false` 时，TiDB 在统计信息初始化未完成时即可对外提供服务，但由于统计信息初始化未完成，优化器会用 pseudo 统计信息进行决策，可能会产生不合理的执行计划。 -### `enable-async-batch-get` 从 v8.5.5 版本开始引入 +### `enable-async-batch-get` 从 v8.5.5 和 v9.0.0 版本开始引入 + 用于控制 TiDB 是否使用 Async KV API 来执行 Batch Get 操作。 + 默认值：`true` From 882a4668d1ae54fad33c127730d280f827fb06a5 Mon Sep 17 00:00:00 2001 From: zyguan Date: Wed, 3 Dec 2025 17:45:26 +0800 Subject: [PATCH 3/5] Update tidb-configuration-file.md 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 fa5e1be5b90e..7837240bf41b 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -644,7 +644,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ ### `enable-async-batch-get` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ 用于控制 TiDB 是否使用 Async KV API 来执行 Batch Get 操作。 ++ 用于控制 TiDB 是否在内部使用异步方式执行 Batch Get 操作。该开关仅影响实现方式，不改变 Batch Get 的行为或查询结果。一般情况下无需调整。 + 默认值：`true` ## opentracing From f5f5459e08778be459ee601e9b55bc2af9755ebf Mon Sep 17 00:00:00 2001 From: zyguan Date: Fri, 5 Dec 2025 14:37:10 +0800 Subject: [PATCH 4/5] Update tidb-configuration-file.md Co-authored-by: cfzjywxk --- 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 7837240bf41b..0a562db4168d 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -644,7 +644,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ ### `enable-async-batch-get` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ 用于控制 TiDB 是否在内部使用异步方式执行 Batch Get 操作。该开关仅影响实现方式，不改变 Batch Get 的行为或查询结果。一般情况下无需调整。 ++ 用于控制 TiDB 是否使用异步方式执行 Batch Get 算子，异步方式提供更优性能，通常无需调整。 + 默认值：`true` ## opentracing From 9d3708498ff378975c9f181b76fba141da626e1a Mon Sep 17 00:00:00 2001 From: zyguan Date: Fri, 5 Dec 2025 06:43:22 +0000 Subject: [PATCH 5/5] revise the description Signed-off-by: zyguan --- 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 0a562db4168d..d57bd6bfa61e 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -644,7 +644,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ ### `enable-async-batch-get` 从 v8.5.5 和 v9.0.0 版本开始引入 -+ 用于控制 TiDB 是否使用异步方式执行 Batch Get 算子，异步方式提供更优性能，通常无需调整。 ++ 用于控制 TiDB 是否使用异步方式执行 Batch Get 算子。使用异步方式能够降低 goroutine 开销，提供更优的性能。通常无需调整该配置项。 + 默认值：`true` ## opentracing