From d6212f9870f1c63dbbc866f7fc2488a3b97a23fc Mon Sep 17 00:00:00 2001 From: Zhigao TONG Date: Tue, 1 Sep 2026 12:37:11 +0800 Subject: [PATCH 1/3] Document tidb_query_cop_store_limit variable Added documentation for the `tidb_query_cop_store_limit` system variable, including its scope, persistence, type, default value, range, and behavior. --- system-variables.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/system-variables.md b/system-variables.md index 01ab57207cee..d71b9bdb1ac9 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5048,6 +5048,19 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL; - 这个变量用来设置 `Projection` 算子的并发度。 - 默认值 `-1` 表示使用 `tidb_executor_concurrency` 的值。 +### `tidb_query_cop_store_limit` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是 +- 类型：整数型 +- 默认值：`15` +- 范围：`[0, 256]` +- 这个变量用于限制单条查询语句发送到每个 TiKV Store 的并发 Coprocessor 请求尝试数。该限制对同一语句创建的多个 DistSQL 请求生效，并且每次重试都会重新按照实际目标 TiKV Store 进行限制。 +- 当该变量设置为 `0` 时，不启用查询级别的 TiKV Store 并发限制；当设置为大于 `0` 的值时，单条查询语句对每个 TiKV Store 最多允许相应数量的 Coprocessor 请求尝试同时执行。 +- 该变量只对 TiKV Coprocessor 请求生效，不影响 TiFlash 请求。它与 [`tidb_distsql_scan_concurrency`](#tidb_distsql_scan_concurrency) 不同，后者控制单个 DistSQL 请求的扫描并发度。 +- 将该变量设置为较小的值可能降低 TiKV Store 的瞬时压力，但也可能增加查询延迟。 + ### `tidb_query_log_max_len` - 作用域：GLOBAL From 7f3d98f62299f698bce684efe214fe66cccf27ba Mon Sep 17 00:00:00 2001 From: Zhigao TONG Date: Tue, 1 Sep 2026 13:07:26 +0800 Subject: [PATCH 2/3] Update system-variables.md --- system-variables.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/system-variables.md b/system-variables.md index d71b9bdb1ac9..10ea09a8eb29 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5048,7 +5048,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL; - 这个变量用来设置 `Projection` 算子的并发度。 - 默认值 `-1` 表示使用 `tidb_executor_concurrency` 的值。 -### `tidb_query_cop_store_limit` +### `tidb_query_cop_store_limit` 从 v9.0.0 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 @@ -5058,7 +5058,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL; - 范围：`[0, 256]` - 这个变量用于限制单条查询语句发送到每个 TiKV Store 的并发 Coprocessor 请求尝试数。该限制对同一语句创建的多个 DistSQL 请求生效，并且每次重试都会重新按照实际目标 TiKV Store 进行限制。 - 当该变量设置为 `0` 时，不启用查询级别的 TiKV Store 并发限制；当设置为大于 `0` 的值时，单条查询语句对每个 TiKV Store 最多允许相应数量的 Coprocessor 请求尝试同时执行。 -- 该变量只对 TiKV Coprocessor 请求生效，不影响 TiFlash 请求。它与 [`tidb_distsql_scan_concurrency`](#tidb_distsql_scan_concurrency) 不同，后者控制单个 DistSQL 请求的扫描并发度。 +- 该变量不会覆盖 [`tidb_distsql_scan_concurrency`](#tidb_distsql_scan_concurrency) 的设置。`tidb_distsql_scan_concurrency` 控制单个 DistSQL 请求的扫描 Worker 并发度，而本变量控制单条查询语句对每个 TiKV Store 的 Coprocessor 请求尝试并发度。单条查询语句包含多个 DistSQL 请求时，本变量仍对这些请求共享生效。 - 将该变量设置为较小的值可能降低 TiKV Store 的瞬时压力，但也可能增加查询延迟。 ### `tidb_query_log_max_len` From 0edfc7698ca55bd9e249ce9e537ffdf3a7cad98d Mon Sep 17 00:00:00 2001 From: Zhigao TONG Date: Tue, 1 Sep 2026 13:27:11 +0800 Subject: [PATCH 3/3] Update system-variables.md --- system-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/system-variables.md b/system-variables.md index 10ea09a8eb29..7136c5502452 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5056,10 +5056,10 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL; - 类型：整数型 - 默认值：`15` - 范围：`[0, 256]` -- 这个变量用于限制单条查询语句发送到每个 TiKV Store 的并发 Coprocessor 请求尝试数。该限制对同一语句创建的多个 DistSQL 请求生效，并且每次重试都会重新按照实际目标 TiKV Store 进行限制。 -- 当该变量设置为 `0` 时，不启用查询级别的 TiKV Store 并发限制；当设置为大于 `0` 的值时，单条查询语句对每个 TiKV Store 最多允许相应数量的 Coprocessor 请求尝试同时执行。 -- 该变量不会覆盖 [`tidb_distsql_scan_concurrency`](#tidb_distsql_scan_concurrency) 的设置。`tidb_distsql_scan_concurrency` 控制单个 DistSQL 请求的扫描 Worker 并发度，而本变量控制单条查询语句对每个 TiKV Store 的 Coprocessor 请求尝试并发度。单条查询语句包含多个 DistSQL 请求时，本变量仍对这些请求共享生效。 -- 将该变量设置为较小的值可能降低 TiKV Store 的瞬时压力，但也可能增加查询延迟。 +- 这个变量用于限制单条查询语句对每个 TiKV Store 的并发 Coprocessor 请求尝试数。 +- 当该变量设置为 `0` 时，禁用查询级别的按 Store 限流；设置为大于 `0` 的值 `N` 时，单条查询语句对每个 TiKV Store 最多允许 `N` 个 Coprocessor 请求尝试同时执行。 +- 该变量不会覆盖 [`tidb_distsql_scan_concurrency`](#tidb_distsql_scan_concurrency)。后者控制单个 DistSQL 请求的扫描并发度，本变量控制单条查询语句在每个 TiKV Store 上的物理请求并发度。单条查询语句包含多个 DistSQL 请求时，本变量仍对这些请求共享生效。 +- 将该变量设置为较小的值可以降低 TiKV Store 的瞬时压力，但可能增加查询延迟。 ### `tidb_query_log_max_len`