Skip to content

system variables: document tidb_opt_index_join_build_v2 compat#21434

Open
AilinKid wants to merge 4 commits intopingcap:masterfrom
AilinKid:docs-index-join-build-v2-compat
Open

system variables: document tidb_opt_index_join_build_v2 compat#21434
AilinKid wants to merge 4 commits intopingcap:masterfrom
AilinKid:docs-index-join-build-v2-compat

Conversation

@AilinKid
Copy link
Contributor

What is changed, added or deleted? (Required)

Document the compatibility behavior of tidb_opt_index_join_build_v2.

  • Add the system variable entry in system-variables.md.
  • Clarify that TiDB always uses index join build v2 now.
  • Clarify that setting this variable to OFF returns an error and cannot switch back to v1.
  • Clarify that historical values left in mysql.global_variables after upgrade are still treated as ON.
  • Add the corresponding entry to system-variable-reference.md.

Which TiDB version(s) do your changes apply to? (Required)

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)
  • v6.1 (TiDB 6.1 versions)
  • v5.4 (TiDB 5.4 versions)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

@ti-chi-bot
Copy link

ti-chi-bot bot commented Mar 12, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign qiancai for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot bot added missing-translation-status This PR does not have translation status info. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Mar 12, 2026
AilinKid and others added 2 commits March 16, 2026 16:54
Co-authored-by: Grace Cai <qqzczy@126.com>
Co-authored-by: xixirangrang <hfxsd@hotmail.com>
@qiancai qiancai added v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3. translation/doing This PR’s assignee is translating this PR. labels Mar 19, 2026
@ti-chi-bot ti-chi-bot bot removed the missing-translation-status This PR does not have translation status info. label Mar 19, 2026
@qiancai qiancai self-assigned this Mar 19, 2026
@qiancai
Copy link
Collaborator

qiancai commented Mar 19, 2026

@AilinKid Please invite a tech reviewer to review this PR. Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/S Denotes a PR that changes 10-29 lines, ignoring generated files. translation/doing This PR’s assignee is translating this PR. v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants