From 33bb2c3370b99de844ce754f9e0cc2e12470fe11 Mon Sep 17 00:00:00 2001 From: AilinKid <314806019@qq.com> Date: Thu, 12 Mar 2026 16:24:14 +0800 Subject: [PATCH 1/4] system variables: document tidb_opt_index_join_build_v2 compat --- system-variable-reference.md | 6 ++++++ system-variables.md | 11 +++++++++++ 2 files changed, 17 insertions(+) diff --git a/system-variable-reference.md b/system-variable-reference.md index 7e93baefc10f..9e4b40f97574 100644 --- a/system-variable-reference.md +++ b/system-variable-reference.md @@ -2965,6 +2965,12 @@ summary: 查看 TiDB 所有的系统变量，以及引用这些变量的文档 - [系统变量](/system-variables.md#tidb_opt_hash_join_cost_factor-从-v853-和-v900-版本开始引入) - [TiDB 8.5.3 Release Notes](/releases/release-8.5.3.md) +### tidb_opt_index_join_build_v2 + +引用该变量的文档： + +- [系统变量](/system-variables.md#tidb_opt_index_join_build_v2) + ### tidb_opt_index_join_cost_factor 引用该变量的文档： diff --git a/system-variables.md b/system-variables.md index 07c20abe665f..fcddd75ab16c 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4352,6 +4352,17 @@ SHOW WARNINGS; - 范围：`[0, 2147483647]` - 默认值：`1` +### `tidb_opt_index_join_build_v2` + +- 作用域：SESSION | GLOBAL +- 是否持久化到集群：是 +- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 +- 类型：布尔型 +- 默认值：`ON` +- 该变量仅为兼容性保留。TiDB 始终使用 Index Join build v2 路径，不能通过该变量切换回 v1。 +- 将该变量设置为 `OFF` 时，TiDB 会返回错误，提示该能力始终开启。 +- 从旧版本升级后，即使 `mysql.global_variables` 中保留了该变量的历史值，TiDB 仍会按 `ON` 处理。 + ### `tidb_opt_index_join_cost_factor` 从 v8.5.3 和 v9.0.0 版本开始引入 > **警告：** From df57bfaeb38a3249b2d9f9fff52d728a1efd8722 Mon Sep 17 00:00:00 2001 From: AilinKid <314806019@qq.com> Date: Thu, 12 Mar 2026 17:13:16 +0800 Subject: [PATCH 2/4] system variables: add version mark for tidb_opt_index_join_build_v2 --- system-variable-reference.md | 2 +- system-variables.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/system-variable-reference.md b/system-variable-reference.md index 9e4b40f97574..dc27c5fca77b 100644 --- a/system-variable-reference.md +++ b/system-variable-reference.md @@ -2969,7 +2969,7 @@ summary: 查看 TiDB 所有的系统变量，以及引用这些变量的文档 引用该变量的文档： -- [系统变量](/system-variables.md#tidb_opt_index_join_build_v2) +- [系统变量](/system-variables.md#tidb_opt_index_join_build_v2-从-v900-beta-2-版本开始引入) ### tidb_opt_index_join_cost_factor diff --git a/system-variables.md b/system-variables.md index fcddd75ab16c..cc9928b5a6eb 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4352,7 +4352,7 @@ SHOW WARNINGS; - 范围：`[0, 2147483647]` - 默认值：`1` -### `tidb_opt_index_join_build_v2` +### `tidb_opt_index_join_build_v2` 从 v9.0.0 Beta 2 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 From c8f897efcfa7b1706ec18afe021e741b4dcd72b0 Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Mon, 16 Mar 2026 16:54:36 +0800 Subject: [PATCH 3/4] Update system-variables.md Co-authored-by: Grace Cai --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index cc9928b5a6eb..19d88b544564 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4352,7 +4352,7 @@ SHOW WARNINGS; - 范围：`[0, 2147483647]` - 默认值：`1` -### `tidb_opt_index_join_build_v2` 从 v9.0.0 Beta 2 版本开始引入 +### `tidb_opt_index_join_build_v2` 从 v9.0.0 版本开始引入 - 作用域：SESSION | GLOBAL - 是否持久化到集群：是 From e89abebbe83bf7930ae1085f983252aafa1ef733 Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Mon, 16 Mar 2026 16:54:45 +0800 Subject: [PATCH 4/4] Update system-variable-reference.md Co-authored-by: xixirangrang --- system-variable-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variable-reference.md b/system-variable-reference.md index dc27c5fca77b..f8cfa1545be4 100644 --- a/system-variable-reference.md +++ b/system-variable-reference.md @@ -2969,7 +2969,7 @@ summary: 查看 TiDB 所有的系统变量，以及引用这些变量的文档 引用该变量的文档： -- [系统变量](/system-variables.md#tidb_opt_index_join_build_v2-从-v900-beta-2-版本开始引入) +- [系统变量](/system-variables.md#tidb_opt_index_join_build_v2-从-v900-版本开始引入) ### tidb_opt_index_join_cost_factor