tidb_opt_partial_ordered_index_for_topn 参数不存在？

Leonard · 2026 年7 月 9 日 02:27

一个好的问题描述有利于社区小伙伴更快帮你定位到问题，高效解决你的问题

【TiDB 使用环境】生产环境 /测试环境
【TiDB 版本】
【部署方式】云上部署（什么云）/机器部署
【操作系统/CPU 架构/芯片详情】
【机器部署详情】CPU大小/内存大小/磁盘大小
【集群数据量】
【集群节点数】
【问题复现路径】做过哪些操作出现的问题
【遇到的问题：问题现象及影响】

8.5.6版本找不到这个参数啊

【资源配置】进入到 TiDB Dashboard -集群信息 (Cluster Info) -主机(Hosts) 截图此页面
【复制黏贴 ERROR 报错的日志】
【其他附件：截图/日志/监控】

Leonard · 2026 年7 月 9 日 02:42

https://github.com/pingcap/tidb/blob/v8.5.6/pkg/sessionctx/variable/tidb_vars.go

这里也没找到改变量

yiduoyunQ · 2026 年7 月 9 日 03:03

像是 v8.5.6 release 漏了。。。

wbslxw · 2026 年7 月 9 日 03:13

好像是没有

TiDBer_AHjy0eKV · 2026 年7 月 9 日 22:21

TiDB 在大版本迭代（尤其是 7.x 到 8.x）中，对部分配置项进行了重构或废弃

kang · 2026 年7 月 10 日 00:30

这个参数是在TiDB v6.5.0引入的，8.5.6版本已经改名为tidb_opt_enable_partial_ordered_index了。

TiDBer_bawpguhQ · 2026 年7 月 10 日 01:50

找不到这个参数，一般是版本差异导致的：系统变量是随版本引入的，如果 tidb_opt_partial_ordered_index_for_topn 是在某个版本才新增，而你的 8.5.6 分支上还没有该变量，就会查不到。建议先确认几点：1）用 SHOW VARIABLES LIKE ‘tidb_opt%’; 看当前版本实际支持哪些优化器变量，确认拼写和实际存在的名称是否一致；2）核对官方对应版本的系统变量文档，确认该参数是在哪个版本引入、是否被改名或废弃（有些优化器开关在小版本间会调整）；3）如果确实是本版本没有，说明对应的优化行为要么默认已启用、要么由别的参数控制，不需要手动设置。若你是想解决某个 TopN + 有序索引的执行计划问题，可以贴一下具体 SQL 和 EXPLAIN，从执行计划入手往往比纠结单个开关更有效。

Circle · 2026 年7 月 10 日 02:47

github.com/pingcap/tidb

session: Add a new session variable to control the prefix index optimization for ORDER BY ... LIMIT queries (#65314)

release-8.5 ← ti-chi-bot:cherry-pick-65314-to-release-8.5

已打开 07:27AM - 29 May 26 UTC

ti-chi-bot

+188 -1

This is a manual backport of #65314 to `release-8.5`. The original automated ch…erry-pick conflicted with the release branch test layout. This version keeps the `release-8.5` layout and backports only the new system variable, SET_VAR hint support, and related tests. ### What problem does this PR solve? Issue Number: fix #63280 Problem Summary: ### What changed and how does it work? 1. Added a new session variable `tidb_opt_partial_ordered_index_for_topn` to control prefix index optimization for `ORDER BY ... LIMIT` queries. 2. This is a global | session variable. 3. It can also be modified by `/*+ set_var() */` hint inside a query. ### Check List Tests - [x] Unit test - `make bazel_prepare` - `tools/bin/failpoint-ctl enable pkg/planner/core pkg/sessionctx/variable` - `go test -tags=intest,deadlock ./pkg/planner/core -run TestSetVarPartialOrderedIndexForTopN -count=1` - `go test -tags=intest,deadlock ./pkg/sessionctx/variable -run 'TestTiDBOptPartialOrderedIndexForTopN|TestTiDBOptPartialOrderedIndexForTopNSessionAndGlobal' -count=1` - `tools/bin/failpoint-ctl disable pkg/planner/core pkg/sessionctx/variable` - `make lint` - [ ] Integration test - [ ] Manual test (add detailed scripts or steps below) - [ ] No need to test > - [ ] I checked and no code files have been changed. > Side effects - [ ] Performance regression: Consumes more CPU - [ ] Performance regression: Consumes more Memory - [ ] Breaking backward compatibility Documentation Since this is a feature that is not yet fully developed, documentation will not be included for this PR. Documentation for this variable will be added later once the feature is completed. - [ ] Affects user behaviors - [ ] Contains syntax changes - [ ] Contains variable changes - [ ] Contains experimental features - [ ] Changes MySQL compatibility ### Release note Please refer to [Release Notes Language Style Guide](https://pingcap.github.io/tidb-dev-guide/contribute-to-tidb/release-notes-style-guide.html) to write a quality release note. ```release-note Since this is a feature that is not yet fully developed, release notes will not be included for this PR. Release notes for this variable will be added later once the feature is completed. ``` ## Summary by CodeRabbit * **New Features** * Added `tidb_opt_partial_ordered_index_for_topn` system variable to control partial ordered index optimization for TOPN queries (accepts ON/OFF/0/1, supports session and global scope). * **Tests** * Added comprehensive tests covering variable validation, default values, and scope behavior.

从 pr 看该参数实际是 v8.5.7 才引入的，已反馈官方文档。

TiDBer_C1PxgFWC · 2026 年7 月 24 日 01:41

好像是没有

独善其身 · 2026 年7 月 25 日 01:23

正式合入版本应该是 TiDB 8.5.7 / 9.0.0 GitHub。文档最开始写错标注为 8.5.6，后面官方统一修正了版本号，所以你在 8.5.6 里查不到该参数是完全正常的。