[WIP]: add v8.5.5 release notes #21195

qiancai · 2025-12-16T08:12:29Z

What is changed, added or deleted? (Required)

As in the title, this PR adds the release note doc for v8.5.5.

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

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

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

This PR is translated from: [WIP]: add v8.5.5 release notes docs#22190
Other reference 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 · 2025-12-17T06:13:02Z

[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 ask for approval from qiancai. 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:

OWNERS

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

releases/release-8.5.5.md

Co-authored-by: zhaoshangzi <zhaoshangzi@icloud.com> Co-authored-by: Frank945946 <108602632+Frank945946@users.noreply.github.com>

joechenrh

LGTM, for the ADD INDEX part.

ti-chi-bot · 2025-12-23T09:47:11Z

@joechenrh: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

LGTM

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

qiancai · 2025-12-24T06:47:59Z

releases/release-8.5.5.md

+
+    更多信息，请参考[用户文档](链接)。
+
+* 按时间点恢复 (Point-in-time recovery, PITR) 支持从压缩后的日志备份中恢复，以加快恢复速度 [#56522](https://github.com/pingcap/tidb/issues/56522) @[YuJuncen](https://github.com/YuJuncen) **tw@lilin90** <!--2001-->


这条的中文目前是从 v9.0.0 复制过来的之前的描述，麻烦请按照 https://github.com/pingcap/docs/pull/22190/files 里最新的英文进行调整 @lilin90

qiancai · 2025-12-24T06:48:14Z

releases/release-8.5.5.md

+
+    更多信息，请参考[用户文档](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#graceful-shutdown-timeout-从-v855-版本开始引入)。
+
+* 提升进行中的日志备份与快照恢复的兼容性 [#58685](https://github.com/pingcap/tidb/issues/58685) @[BornChanger](https://github.com/BornChanger) **tw@lilin90** <!--2000-->


这条的中文目前是从 v9.0.0 复制过来的之前的描述，麻烦请按照 https://github.com/pingcap/docs/pull/22190/files 里最新的英文进行调整 @lilin90

Co-authored-by: zhaoshangzi <zhaoshangzi@icloud.com>

releases/release-8.5.5.md

lcwangchao · 2025-12-25T02:43:24Z

releases/release-8.5.5.md

+
+* 提示索引下推到TiKV提升查询性能 [#62575](https://github.com/pingcap/tidb/issues/62575) @[lcwangchao](https://github.com/lcwangchao) **tw@qiancai** <!--1899-->
+
+    通过hint INDEX_LOOKUP_PUSHDOWN(t1_name, idx1_name [, idx2_name ...]) 提示优化器将指定索引查询下推到TiKV，减少远程调用的次数，经过测试数据对比显示性能可提升约20%左右，最优可提升到40%。本特性一般建议结合表 affinity 属性使用，即表属性 AFFINITY="table" 或者 分区表属性 AFFINITY="partition" 。


实际数据可能根据环境和负载不同有很大区别，这个数据目前是混合负载的结果，不光包含 pushdown

@zhaoshangzi PTAL

通过hint INDEX_LOOKUP_PUSHDOWN(t1_name, idx1_name [, idx2_name ...]) 提示优化器将指定索引查询下推到TiKV，减少远程调用的次数，性能在理论上有提升，但具体提升比例需要结合业务场景实际测试。本特性一般建议结合表 affinity 属性使用，即表属性 AFFINITY="table" 或者分区表属性 AFFINITY="partition" 。

lhy1024 · 2025-12-25T03:02:09Z

releases/release-8.5.5.md

+
+* 表级和分区级亲和性属性 AFFINITY [#9764](https://github.com/tikv/pd/issues/9764) @[lhy1024](https://github.com/lhy1024) **tw@qiancai** <!--2317-->
+
+    为表或者分区表新增亲和性属性，设置亲和性属性后，PD会将表或分区的Region归为相同的一个亲和性分组中，这些Region的Leader、Voter 会被优先调度到指定TiKV Store上。有AFFNITY属性的表和分区在查询时，由于索引、表数据的Region都在一个TiKV Store上，因此优化器可结合 hint INDEX_LOOKUP_PUSHDOWN 指定将对应索引查询下推，减少跨节点分散查询带来的延迟，根据测试数据对比性能可约提升20%。


这个数据可能会有偏差，根据负载不同

为表或者分区表新增亲和性属性，设置亲和性属性后，PD会将表或分区的Region归为相同的一个亲和性分组中，这些Region的Leader、Voter 会被优先调度到指定TiKV Store上。有AFFNITY属性的表和分区在查询时，由于索引、表数据的Region都在一个TiKV Store上，因此优化器可结合 hint INDEX_LOOKUP_PUSHDOWN 指定将对应索引查询下推，减少跨节点分散查询带来的延迟，提升性能

releases/release-8.5.5.md

zhaoshangzi · 2025-12-25T03:30:37Z

releases/release-8.5.5.md

+
+* 提示索引下推到TiKV提升查询性能 [#62575](https://github.com/pingcap/tidb/issues/62575) @[lcwangchao](https://github.com/lcwangchao) **tw@qiancai** <!--1899-->
+
+    通过hint INDEX_LOOKUP_PUSHDOWN(t1_name, idx1_name [, idx2_name ...]) 提示优化器将指定索引查询下推到TiKV，减少远程调用的次数，经过测试数据对比显示性能可提升约20%左右，最优可提升到40%。本特性一般建议结合表 affinity 属性使用，即表属性 AFFINITY="table" 或者 分区表属性 AFFINITY="partition" 。


通过hint INDEX_LOOKUP_PUSHDOWN(t1_name, idx1_name [, idx2_name ...]) 提示优化器将指定索引查询下推到TiKV，减少远程调用的次数，性能在理论上有提升，但具体提升比例需要结合业务场景实际测试。本特性一般建议结合表 affinity 属性使用，即表属性 AFFINITY="table" 或者分区表属性 AFFINITY="partition" 。

zhaoshangzi · 2025-12-25T03:31:06Z

releases/release-8.5.5.md

+
+* 表级和分区级亲和性属性 AFFINITY [#9764](https://github.com/tikv/pd/issues/9764) @[lhy1024](https://github.com/lhy1024) **tw@qiancai** <!--2317-->
+
+    为表或者分区表新增亲和性属性，设置亲和性属性后，PD会将表或分区的Region归为相同的一个亲和性分组中，这些Region的Leader、Voter 会被优先调度到指定TiKV Store上。有AFFNITY属性的表和分区在查询时，由于索引、表数据的Region都在一个TiKV Store上，因此优化器可结合 hint INDEX_LOOKUP_PUSHDOWN 指定将对应索引查询下推，减少跨节点分散查询带来的延迟，根据测试数据对比性能可约提升20%。


为表或者分区表新增亲和性属性，设置亲和性属性后，PD会将表或分区的Region归为相同的一个亲和性分组中，这些Region的Leader、Voter 会被优先调度到指定TiKV Store上。有AFFNITY属性的表和分区在查询时，由于索引、表数据的Region都在一个TiKV Store上，因此优化器可结合 hint INDEX_LOOKUP_PUSHDOWN 指定将对应索引查询下推，减少跨节点分散查询带来的延迟，提升性能

ti-chi-bot · 2025-12-25T04:05:02Z

@zhaoshangzi: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

ti-chi-bot · 2025-12-25T04:05:18Z

@zhaoshangzi: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

JaySon-Huang · 2025-12-25T04:18:02Z

releases/release-8.5.5.md

+
+ TiFlash
+
+    - note [#issue](https://github.com/pingcap/tiflash/issues/${issue-id}) @[贡献者 GitHub ID](https://github.com/${github-id})


Suggested change

- note [#issue](https://github.com/pingcap/tiflash/issues/${issue-id}) @[贡献者 GitHub ID](https://github.com/${github-id})

- 修复在 BR restore 的过程中，TiFlash 可能 panic 的问题 [#10606](https://github.com/pingcap/tiflash/issues/10606) @[CalvinNeo](https://github.com/CalvinNeo)

- 修复在 BR restore 的过程中，TiFlash 不能充分利用超过 16 核 CPU 进行数据恢复的问题 [#10605](https://github.com/pingcap/tiflash/issues/10605) @[JaySon-Huang](https://github.com/JaySon-Huang)

releases/release-8.5.5.md

ti-chi-bot · 2025-12-25T06:55:29Z

@qiancai: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-verify	`84ed814`	link	true	`/test pull-verify`

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Add temp.md

813850f

qiancai added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. translation/from-docs This PR is translated from a PR in pingcap/docs. labels Dec 16, 2025

Delete temp.md

7698269

ti-chi-bot bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Dec 16, 2025

Create release-8.5.5.md

fa62e02

ti-chi-bot bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Dec 16, 2025

qiancai self-assigned this Dec 16, 2025

add feature description for #56522 and #58685

42a91b0

add pingcap#17221

c4e7ccf

Frank945946 reviewed Dec 22, 2025

View reviewed changes

releases/release-8.5.5.md Show resolved Hide resolved

releases/release-8.5.5.md Show resolved Hide resolved

zhaoshangzi reviewed Dec 23, 2025

View reviewed changes

releases/release-8.5.5.md Show resolved Hide resolved

Add three features

a5f361c

Co-authored-by: zhaoshangzi <zhaoshangzi@icloud.com> Co-authored-by: Frank945946 <108602632+Frank945946@users.noreply.github.com>

joechenrh approved these changes Dec 23, 2025

View reviewed changes

add more features according to English PR

d76ead9

qiancai commented Dec 24, 2025

View reviewed changes

add improvements and bug fixes

3b48aba

ti-chi-bot bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Dec 24, 2025

qiancai and others added 2 commits December 25, 2025 09:55

add two new features

d572aa3

Co-authored-by: zhaoshangzi <zhaoshangzi@icloud.com>

adjust the feature order and add two features

fe4c1c5

qiancai commented Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

qiancai commented Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

add the issue information for a feature

20bdfc8

lcwangchao reviewed Dec 25, 2025

View reviewed changes

lhy1024 reviewed Dec 25, 2025

View reviewed changes

qiancai commented Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

Update releases/release-8.5.5.md

da64adf

zhaoshangzi approved these changes Dec 25, 2025

View reviewed changes

JaySon-Huang reviewed Dec 25, 2025

View reviewed changes

lilin90 reviewed Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Show resolved Hide resolved

Oreoxmt reviewed Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

Oreoxmt and others added 2 commits December 25, 2025 14:09

Apply suggestions from code review

99df7a0

Add br config "--checkpoint-storage"

0f06ef0

Oreoxmt reviewed Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

releases/release-8.5.5.md Outdated Show resolved Hide resolved

qiancai commented Dec 25, 2025

View reviewed changes

releases/release-8.5.5.md Outdated Show resolved Hide resolved

Oreoxmt and others added 3 commits December 25, 2025 14:51

update optimizer hint NO_INDEX_LOOKUP_PUSHDOWN

6b6449a

Update releases/release-8.5.5.md

a5e0644

remove duplicate blank lines

84ed814


		更多信息，请参考[用户文档](链接)。

		* 按时间点恢复 (Point-in-time recovery, PITR) 支持从压缩后的日志备份中恢复，以加快恢复速度 [#56522](https://github.com/pingcap/tidb/issues/56522) @[YuJuncen](https://github.com/YuJuncen) tw@lilin90 <!--2001-->


		更多信息，请参考[用户文档](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#graceful-shutdown-timeout-从-v855-版本开始引入)。

		* 提升进行中的日志备份与快照恢复的兼容性 [#58685](https://github.com/pingcap/tidb/issues/58685) @[BornChanger](https://github.com/BornChanger) tw@lilin90 <!--2000-->


		* 提示索引下推到TiKV提升查询性能 [#62575](https://github.com/pingcap/tidb/issues/62575) @[lcwangchao](https://github.com/lcwangchao) tw@qiancai <!--1899-->

		通过hint INDEX_LOOKUP_PUSHDOWN(t1_name, idx1_name [, idx2_name ...]) 提示优化器将指定索引查询下推到TiKV，减少远程调用的次数，经过测试数据对比显示性能可提升约20%左右，最优可提升到40%。本特性一般建议结合表 affinity 属性使用，即表属性 AFFINITY="table" 或者分区表属性 AFFINITY="partition" 。


		* 表级和分区级亲和性属性 AFFINITY [#9764](https://github.com/tikv/pd/issues/9764) @[lhy1024](https://github.com/lhy1024) tw@qiancai <!--2317-->

		为表或者分区表新增亲和性属性，设置亲和性属性后，PD会将表或分区的Region归为相同的一个亲和性分组中，这些Region的Leader、Voter 会被优先调度到指定TiKV Store上。有AFFNITY属性的表和分区在查询时，由于索引、表数据的Region都在一个TiKV Store上，因此优化器可结合 hint INDEX_LOOKUP_PUSHDOWN 指定将对应索引查询下推，减少跨节点分散查询带来的延迟，根据测试数据对比性能可约提升20%。


		+ TiFlash

		- note [#issue](https://github.com/pingcap/tiflash/issues/${issue-id}) @[贡献者 GitHub ID](https://github.com/${github-id})

	- note [#issue](https://github.com/pingcap/tiflash/issues/${issue-id}) @[贡献者 GitHub ID](https://github.com/${github-id})
	- 修复在 BR restore 的过程中，TiFlash 可能 panic 的问题 [#10606](https://github.com/pingcap/tiflash/issues/10606) @[CalvinNeo](https://github.com/CalvinNeo)
	- 修复在 BR restore 的过程中，TiFlash 不能充分利用超过 16 核 CPU 进行数据恢复的问题 [#10605](https://github.com/pingcap/tiflash/issues/10605) @[JaySon-Huang](https://github.com/JaySon-Huang)

[WIP]: add v8.5.5 release notes #21195

Are you sure you want to change the base?

[WIP]: add v8.5.5 release notes #21195

Conversation

qiancai commented Dec 16, 2025

What is changed, added or deleted? (Required)

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

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

Do your changes match any of the following descriptions?

Uh oh!

ti-chi-bot bot commented Dec 17, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

joechenrh left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot bot commented Dec 23, 2025

Uh oh!

qiancai Dec 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

qiancai Dec 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

lcwangchao Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

qiancai Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

zhaoshangzi Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

lhy1024 Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

zhaoshangzi Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

zhaoshangzi Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

zhaoshangzi Dec 25, 2025

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot bot commented Dec 25, 2025

Uh oh!

ti-chi-bot bot commented Dec 25, 2025

Uh oh!

JaySon-Huang Dec 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ti-chi-bot bot commented Dec 25, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

joechenrh left a comment •

edited

Loading

qiancai Dec 24, 2025 •

edited

Loading

qiancai Dec 24, 2025 •

edited

Loading

JaySon-Huang Dec 25, 2025 •

edited

Loading