Skip to content
Merged
Changes from 6 commits
Commits
Show all changes
82 commits
Select commit Hold shift + click to select a range
813850f
Add temp.md
qiancai Dec 16, 2025
7698269
Delete temp.md
qiancai Dec 16, 2025
fa62e02
Create release-8.5.5.md
qiancai Dec 16, 2025
42a91b0
add feature description for #56522 and #58685
qiancai Dec 17, 2025
c4e7ccf
add #17221
qiancai Dec 17, 2025
a5f361c
Add three features
qiancai Dec 23, 2025
d76ead9
add more features according to English PR
qiancai Dec 24, 2025
3b48aba
add improvements and bug fixes
qiancai Dec 24, 2025
d572aa3
add two new features
qiancai Dec 25, 2025
fe4c1c5
adjust the feature order and add two features
qiancai Dec 25, 2025
20bdfc8
add the issue information for a feature
qiancai Dec 25, 2025
da64adf
Update releases/release-8.5.5.md
qiancai Dec 25, 2025
99df7a0
Apply suggestions from code review
Oreoxmt Dec 25, 2025
0f06ef0
Add br config "--checkpoint-storage"
lilin90 Dec 25, 2025
6b6449a
update optimizer hint NO_INDEX_LOOKUP_PUSHDOWN
Oreoxmt Dec 25, 2025
a5e0644
Update releases/release-8.5.5.md
qiancai Dec 25, 2025
84ed814
remove duplicate blank lines
Oreoxmt Dec 25, 2025
736086e
Apply suggestions from code review
hfxsd Dec 26, 2025
2d07689
Apply suggestions from code review
qiancai Dec 29, 2025
2737779
add the feature description for storage engine identifiers
qiancai Dec 29, 2025
c92c538
Update releases/release-8.5.5.md
hfxsd Dec 29, 2025
0037cd6
Update releases/release-8.5.5.md
qiancai Dec 30, 2025
b0bc177
move ticdc #12253 from bug fixes to improvements
qiancai Dec 30, 2025
d478f37
add PD improvements and bug fixes
qiancai Dec 30, 2025
4e6ac0a
Compatibility changes: add tidb_index_lookup_pushdown_policy
Oreoxmt Dec 31, 2025
e7f2df6
add execution improvements and bug fixes
qiancai Jan 4, 2026
0ff7b67
revise #63366 and #62120 descriptions
qiancai Jan 4, 2026
c315404
update planner release note
hawkingrei Jan 4, 2026
5d66df9
remove useless file
hawkingrei Jan 4, 2026
7c19fa8
add the Chinese version for #9359 and #19006
qiancai Jan 5, 2026
fcb2a6d
Refine wording and update links
lilin90 Jan 5, 2026
8773db7
minor wording updates
qiancai Jan 5, 2026
8e790a6
Update releases/release-8.5.5.md
qiancai Jan 5, 2026
7561199
copy release note for some modules from the English PR
qiancai Jan 5, 2026
dbdf79c
add the tw tag for improvements and bug fixes
qiancai Jan 5, 2026
49891ad
add a bug fix for TiDB
qiancai Jan 5, 2026
ee12a2a
Add three BR config items and two behavior changes
lilin90 Jan 6, 2026
d8db5c5
add compatibility changes for 5 parameters
qiancai Jan 7, 2026
5297b5f
Apply suggestions from code review
qiancai Jan 7, 2026
55052c9
add links to system variables
qiancai Jan 7, 2026
6840262
remove unnecessary spaces
qiancai Jan 7, 2026
94554ed
update PD, TiKV, BR
Oreoxmt Jan 7, 2026
0b1f4d8
Update releases/release-8.5.5.md
hfxsd Jan 8, 2026
8d2a25d
Apply suggestions from code review
hfxsd Jan 8, 2026
86567f4
Apply suggestions from code review
hfxsd Jan 8, 2026
ffcf625
Update releases/release-8.5.5.md
hfxsd Jan 8, 2026
41f0faa
Apply suggestions from code review
hfxsd Jan 8, 2026
f4397a7
refine TiDB improvements and PD bug fixes
qiancai Jan 8, 2026
d9d0455
Apply suggestions from code review
qiancai Jan 9, 2026
1a65d2a
Apply suggestions from code review
qiancai Jan 9, 2026
ba996f7
Apply suggestions from code review
Oreoxmt Jan 9, 2026
f4d63bb
add store limit docs
bufferflies Jan 9, 2026
94bfbaf
Apply suggestions from code review
qiancai Jan 9, 2026
a9db75d
Discard changes to pd-control.md
qiancai Jan 10, 2026
34d9182
add readpool.cpu-threshold
qiancai Jan 10, 2026
1eb6214
Update wording
lilin90 Jan 12, 2026
f16c22f
Apply suggestions from code review
lilin90 Jan 12, 2026
62946b1
Update releases/release-8.5.5.md
qiancai Jan 12, 2026
1432b9d
Apply suggestions from code review
lilin90 Jan 12, 2026
53b7104
Apply suggestions from code review
Oreoxmt Jan 12, 2026
183bf1e
add more compatibility changes
qiancai Jan 12, 2026
4a16bad
Merge branch 'add-8.5.5-rn-22190' of github.com:qiancai/docs-cn into …
qiancai Jan 12, 2026
265d14d
Refine wording and format
lilin90 Jan 12, 2026
1ad4d3c
Apply suggestions from Frank945946
qiancai Jan 12, 2026
6616fbc
add tidb_analyze_column_options
qiancai Jan 12, 2026
8016b47
Apply suggestions from code review
qiancai Jan 13, 2026
729367b
Apply suggestions from code review
qiancai Jan 13, 2026
0102762
change the default value to false for 8.5.5
qiancai Jan 13, 2026
be6cbd6
Apply suggestions from code review
qiancai Jan 13, 2026
e67fb35
Update releases/release-8.5.5.md
hfxsd Jan 13, 2026
5cbfd5a
Update releases/release-8.5.5.md
qiancai Jan 13, 2026
dbb904d
remove inline tag comments
qiancai Jan 13, 2026
124e72a
add TOC related changes and remove the link for downloading v8.5.4 of…
qiancai Jan 13, 2026
3b9552f
fix build errors
qiancai Jan 13, 2026
c099caa
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
fe858b9
remove a duplicated #58985 for the same issue
qiancai Jan 14, 2026
120bb2d
fix a format issue
qiancai Jan 14, 2026
93c502e
Update releases/release-8.5.5.md
hfxsd Jan 14, 2026
1509068
fix format issues
qiancai Jan 14, 2026
5023f1a
fix format issues
qiancai Jan 14, 2026
eb29b75
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
0434410
update the release date
qiancai Jan 15, 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
182 changes: 182 additions & 0 deletions releases/release-8.5.5.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,182 @@
---
title: TiDB 8.5.5 Release Notes
summary: 了解 TiDB 8.5.5 版本的新功能、兼容性变更、改进提升,以及错误修复。
---

# TiDB 8.5.5 Release Notes

发版日期:2026 年 xx 月 xx 日

TiDB 版本:8.5.5

试用链接:[快速体验](https://docs.pingcap.com/zh/tidb/v8.5/quick-start-with-tidb) | [生产部署](https://docs.pingcap.com/zh/tidb/v8.5/production-deployment-using-tiup) | [下载离线包](https://pingkai.cn/download#tidb-community)

## 新功能

### 可扩展性

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### 性能

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

从 v9.0.0 开始,压缩日志备份功能提供了离线压缩能力,将非结构化的日志备份数据转换为结构化的 SST 文件,从而实现以下改进:

- SST 可以被快速导入集群,从而**提升恢复性能**。
- 压缩过程中消除重复记录,从而**减少空间消耗**。
- 在确保 RTO (Recovery Time Objective) 的前提下,你可以设置更长的全量备份间隔,从而**降低对业务的影响**。

更多信息,请参考[用户文档](/br/br-compact-log-backup.md)。
* 提供索引下推到TiKV到通过hint INDEX_LOOKUP_PUSHDOWN/NO_INDEX_LOOKUP_PUSHDOWN功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

功能描述2(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

更多信息,请参考[用户文档](链接)。
* 大幅提升特定有损 DDL 操作的执行效率,例如 `BIGINT → INT`、`CHAR(120) → VARCHAR(60)`。在未发生数据截断的前提下,执行耗时可从数小时缩短至分钟级、秒级甚至毫秒级,性能提升可达到数十倍至数十万倍。 [#63366](https://github.com/pingcap/tidb/issues/63366) [@wjhuang2016](https://github.com/wjhuang2016), [@tangenta](https://github.com/tangenta), [@fzzf678](https://github.com/fzzf678)**tw@qiancai** <!--2292-->

优化策略包括:
- 在严格 SQL 模式下,预先检查类型转换过程中是否存在数据截断风险;
- 若不存在数据截断风险,则仅更新元数据,尽量避免索引重建;
- 如需重建索引,则采用更高效的 Ingest 流程,大幅提升索引重建性能。

性能提升示例(基于 100 GiB 表的基准测试):

| 场景 | 操作类型 | 优化前 | 优化后 | 性能提升 |
|------|----------|--------|--------|----------|
| 无索引列 | `BIGINT → INT` | 2 小时 34 分 | 1 分 5 秒 | 142× |
| 有索引列 | `BIGINT → INT` | 6 小时 25 分 | 0.05 秒 | 460,000× |
| 有索引列 | `CHAR(120) → VARCHAR(60)` | 7 小时 16 分 | 12 分 56 秒 | 34× |

> 注:以上数据基于 DDL 执行过程中未发生数据截断的前提。以上优化对于有 TiFlash 副本的表,以及 sign <--> unsign 数据类型修改的场景不会生效。

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

* 优化了存在大量外键场景下的 DDL 性能,逻辑 DDL 性能最高可提升 25 倍 [#61126](https://github.com/pingcap/tidb/issues/61126) @[GMHDBJD](https://github.com/GMHDBJD) **tw@hfxsd** <!--1896-->

在 v8.5.5 版本之前,当一些用户单个集群的表数量达到 1000 万级别,且其中有几十万张表有外键的场景,创建表,给表加列这些逻辑 DDL 的性能 QPS 会降低到 4,使得一些多租户的 SaaS 场景下的运维操作变得非常低效。在 v8.5.5 对该场景做了优化。经测试,1000 万张表,其中 20 万张表有外键的场景下,创建表,加列这类逻辑 DDL 的性能 QPS 稳定保持在 100,性能有 25 倍的提升。

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

### 稳定性

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### 高可用

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### SQL 功能

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

* 支持在线修改分布式 ADD Index 任务的并发和吞吐 [#62120](https://github.com/pingcap/tidb/pull/62120) @[joechenrh](https://github.com/joechenrh) **tw@qiancai** <!--2326-->

在 v8.5.5 版本之前,当集群开启了分布式执行框架 [tidb_enable_dist_task](/system-variables/#tidb_enable_dist_task-从-v710-版本开始引入) ,在 ADD Index 任务执行期间,是无法修改该任务的 `THREAD`, `BATCH_SIZE`,`MAX_WRITE_SPEED` 参数。需要取消该 DDL 任务,重新设置参数后再提交,效率较低。支持该功能后,用户可以根据业务负载和对 ADD Index 的性能要求,在线灵活调整这些参数。

更多信息,请参考[ADMIN ALTER DDL JOBS](/sql-statement-admin-alter-ddl/#admin-alter-ddl-jobs)。

### 数据库管理

* TiKV 支持优雅关闭 (graceful shutdown) [#17221](https://github.com/tikv/tikv/issues/17221) @[hujiatao0](https://github.com/hujiatao0)

在关闭 TiKV 服务器时,TiKV 会尽量将其上的 leader 副本转移到其他 TiKV 节点,然后再关闭。该等待期默认为 20 秒,可通过 [`server.graceful-shutdown-timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#graceful-shutdown-timeout-从-v855-版本开始引入) 配置项进行调整。若达到该超时时间后仍有 leader 未完成转移,TiKV 将跳过剩余 leader 的转移,直接进入关闭流程。

更多信息,请参考[用户文档](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)

从 v9.0.0 开始,当日志备份任务正在运行时,在满足特定条件的情况下,仍然可以执行快照恢复,并且恢复的数据可以被进行中的日志备份正常记录。这样,日志备份可以持续进行,无需在恢复数据期间中断。

更多信息,请参考[用户文档](/br/br-pitr-manual.md#进行中的日志备份与快照恢复的兼容性)。

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### 可观测性

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### 安全

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

### 数据迁移

* 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234-->

功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用)

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

## 兼容性变更

### 行为变更

### MySQL 兼容性

### 系统变量

| 变量名 | 修改类型(包括新增/修改/删除) | 描述 |
|--------|------------------------------|------|
| | | |
| | | |
| | | |
| | | |

### 配置参数

| 配置文件或组件 | 配置项 | 修改类型 | 描述 |
| -------- | -------- | -------- | -------- |
| | | | |
| | | | |
| | | | |

### 系统表

### 其他

## 改进提升

## 错误修复
Loading