Skip to content

system variables: document tidb_opt_index_join_build_v2 compat #21434

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AilinKid wants to merge 4 commits into
base: master
Choose a base branch
from
+17 −0
Open

system variables: document tidb_opt_index_join_build_v2 compat #21434

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
33bb2c3
system variables: document tidb_opt_index_join_build_v2 compat
AilinKid Mar 12, 2026
df57bfa
system variables: add version mark for tidb_opt_index_join_build_v2
AilinKid Mar 12, 2026
c8f897e
Update system-variables.md
AilinKid Mar 16, 2026
e89abeb
Update system-variable-reference.md
AilinKid Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions system-variable-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-从-v900-版本开始引入)

### tidb_opt_index_join_cost_factor

引用该变量的文档：
Expand Down
11 changes: 11 additions & 0 deletions system-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4352,6 +4352,17 @@ SHOW WARNINGS;
- 范围：`[0, 2147483647]`
- 默认值：`1`

### `tidb_opt_index_join_build_v2` <span class="version-mark">从 v9.0.0 版本开始引入</span>

- 作用域：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` <span class="version-mark">从 v8.5.3 和 v9.0.0 版本开始引入</span>

> **警告：**
Expand Down
Loading