Skip to content

tidb: add the join order related variable tidb_opt_join_reorder_through_sel #22477

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
hfxsd wants to merge 2 commits into
base: master
Choose a base branch
from
Open

tidb: add the join order related variable tidb_opt_join_reorder_through_sel #22477

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2d84621
Update system-variables.md
hfxsd Feb 24, 2026
5f48abd
Update system-variables.md
hfxsd Feb 24, 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
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 @@ -4545,6 +4545,17 @@ mysql> desc select count(distinct a) from test.t;
- This variable is used to control the selection of the TiDB Join Reorder algorithm. When the number of nodes participating in Join Reorder is greater than this threshold, TiDB selects the greedy algorithm, and when it is less than this threshold, TiDB selects the dynamic programming algorithm.
- Currently, for OLTP queries, it is recommended to keep the default value. For OLAP queries, it is recommended to set the variable value to 10~15 to get better connection orders in OLAP scenarios.

### tidb_opt_join_reorder_through_sel <span class="version-mark">New in v8.5.6 and v9.0.0</span>

- Scope: SESSION | GLOBAL
- Persists to cluster: Yes
- Applies to hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value): Yes
- Type: Boolean
- Default value: `OFF`
- This variable improves join reorder optimization for certain multi-table join queries. If you set it to `ON` and safety conditions are met, the optimizer evaluates `Selection` conditions that appear between consecutive join operators together with join order candidates. During join tree reconstruction, the optimizer pushes these conditions to more appropriate positions whenever possible, allowing more tables to participate in join order optimization.
- Enabling this variable changes execution plans. If you observe performance regression or plan instability after enabling it, set the variable to `OFF`.
- For filters that are non-deterministic or have side effects (for example, `rand()`), the optimizer skips this transformation even when the variable is enabled. This behavior preserves the original expression evaluation semantics.

### tidb_opt_limit_push_down_threshold

- Scope: SESSION | GLOBAL
Expand Down