-
Notifications
You must be signed in to change notification settings - Fork 1.2k
add v8.5.5 release notes #21195
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.
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
Merged
+322
−1
Merged
add v8.5.5 release notes #21195
Changes from 6 commits
Commits
Show all changes
82 commits
Select commit
Hold shift + click to select a range
813850f
Add temp.md
qiancai 7698269
Delete temp.md
qiancai fa62e02
Create release-8.5.5.md
qiancai 42a91b0
add feature description for #56522 and #58685
qiancai c4e7ccf
add #17221
qiancai a5f361c
Add three features
qiancai d76ead9
add more features according to English PR
qiancai 3b48aba
add improvements and bug fixes
qiancai d572aa3
add two new features
qiancai fe4c1c5
adjust the feature order and add two features
qiancai 20bdfc8
add the issue information for a feature
qiancai da64adf
Update releases/release-8.5.5.md
qiancai 99df7a0
Apply suggestions from code review
Oreoxmt 0f06ef0
Add br config "--checkpoint-storage"
lilin90 6b6449a
update optimizer hint NO_INDEX_LOOKUP_PUSHDOWN
Oreoxmt a5e0644
Update releases/release-8.5.5.md
qiancai 84ed814
remove duplicate blank lines
Oreoxmt 736086e
Apply suggestions from code review
hfxsd 2d07689
Apply suggestions from code review
qiancai 2737779
add the feature description for storage engine identifiers
qiancai c92c538
Update releases/release-8.5.5.md
hfxsd 0037cd6
Update releases/release-8.5.5.md
qiancai b0bc177
move ticdc #12253 from bug fixes to improvements
qiancai d478f37
add PD improvements and bug fixes
qiancai 4e6ac0a
Compatibility changes: add tidb_index_lookup_pushdown_policy
Oreoxmt e7f2df6
add execution improvements and bug fixes
qiancai 0ff7b67
revise #63366 and #62120 descriptions
qiancai c315404
update planner release note
hawkingrei 5d66df9
remove useless file
hawkingrei 7c19fa8
add the Chinese version for #9359 and #19006
qiancai fcb2a6d
Refine wording and update links
lilin90 8773db7
minor wording updates
qiancai 8e790a6
Update releases/release-8.5.5.md
qiancai 7561199
copy release note for some modules from the English PR
qiancai dbdf79c
add the tw tag for improvements and bug fixes
qiancai 49891ad
add a bug fix for TiDB
qiancai ee12a2a
Add three BR config items and two behavior changes
lilin90 d8db5c5
add compatibility changes for 5 parameters
qiancai 5297b5f
Apply suggestions from code review
qiancai 55052c9
add links to system variables
qiancai 6840262
remove unnecessary spaces
qiancai 94554ed
update PD, TiKV, BR
Oreoxmt 0b1f4d8
Update releases/release-8.5.5.md
hfxsd 8d2a25d
Apply suggestions from code review
hfxsd 86567f4
Apply suggestions from code review
hfxsd ffcf625
Update releases/release-8.5.5.md
hfxsd 41f0faa
Apply suggestions from code review
hfxsd f4397a7
refine TiDB improvements and PD bug fixes
qiancai d9d0455
Apply suggestions from code review
qiancai 1a65d2a
Apply suggestions from code review
qiancai ba996f7
Apply suggestions from code review
Oreoxmt f4d63bb
add store limit docs
bufferflies 94bfbaf
Apply suggestions from code review
qiancai a9db75d
Discard changes to pd-control.md
qiancai 34d9182
add readpool.cpu-threshold
qiancai 1eb6214
Update wording
lilin90 f16c22f
Apply suggestions from code review
lilin90 62946b1
Update releases/release-8.5.5.md
qiancai 1432b9d
Apply suggestions from code review
lilin90 53b7104
Apply suggestions from code review
Oreoxmt 183bf1e
add more compatibility changes
qiancai 4a16bad
Merge branch 'add-8.5.5-rn-22190' of github.com:qiancai/docs-cn into …
qiancai 265d14d
Refine wording and format
lilin90 1ad4d3c
Apply suggestions from Frank945946
qiancai 6616fbc
add tidb_analyze_column_options
qiancai 8016b47
Apply suggestions from code review
qiancai 729367b
Apply suggestions from code review
qiancai 0102762
change the default value to false for 8.5.5
qiancai be6cbd6
Apply suggestions from code review
qiancai e67fb35
Update releases/release-8.5.5.md
hfxsd 5cbfd5a
Update releases/release-8.5.5.md
qiancai dbb904d
remove inline tag comments
qiancai 124e72a
add TOC related changes and remove the link for downloading v8.5.4 of…
qiancai 3b9552f
fix build errors
qiancai c099caa
Update releases/release-8.5.5.md
qiancai fe858b9
remove a duplicated #58985 for the same issue
qiancai 120bb2d
fix a format issue
qiancai 93c502e
Update releases/release-8.5.5.md
hfxsd 1509068
fix format issues
qiancai 5023f1a
fix format issues
qiancai eb29b75
Update releases/release-8.5.5.md
qiancai 0434410
update the release date
qiancai File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Some comments aren't visible on the classic Files Changed page.
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
qiancai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| * 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
qiancai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| * 功能标题 [#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--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
qiancai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| * 支持在线修改分布式 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)。 | ||
qiancai marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ### 数据库管理 | ||
|
|
||
| * TiKV 支持优雅关闭 (graceful shutdown) [#17221](https://github.com/tikv/tikv/issues/17221) @[hujiatao0](https://github.com/hujiatao0) | ||
qiancai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| 在关闭 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 的转移,直接进入关闭流程。 | ||
qiancai marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 更多信息,请参考[用户文档](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 开始,当日志备份任务正在运行时,在满足特定条件的情况下,仍然可以执行快照恢复,并且恢复的数据可以被进行中的日志备份正常记录。这样,日志备份可以持续进行,无需在恢复数据期间中断。 | ||
lilin90 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 更多信息,请参考[用户文档](/br/br-pitr-manual.md#进行中的日志备份与快照恢复的兼容性)。 | ||
|
|
||
| * 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
| ### 可观测性 | ||
|
|
||
| * 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
qiancai marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ### 安全 | ||
|
|
||
| * 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
| ### 数据迁移 | ||
|
|
||
| * 功能标题 [#issue号](链接) @[贡献者 GitHub ID](链接) **tw@xxx** <!--1234--> | ||
|
|
||
| 功能描述(需要包含这个功能是什么、在什么场景下对用户有什么价值、怎么用) | ||
|
|
||
| 更多信息,请参考[用户文档](链接)。 | ||
|
|
||
| ## 兼容性变更 | ||
|
|
||
lilin90 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| ### 行为变更 | ||
|
|
||
| ### MySQL 兼容性 | ||
|
|
||
| ### 系统变量 | ||
|
|
||
| | 变量名 | 修改类型(包括新增/修改/删除) | 描述 | | ||
qiancai marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| |--------|------------------------------|------| | ||
qiancai marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| | | | | | ||
hfxsd marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| | | | | | ||
Oreoxmt marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| | | | | | ||
| | | | | | ||
|
|
||
| ### 配置参数 | ||
|
|
||
| | 配置文件或组件 | 配置项 | 修改类型 | 描述 | | ||
| | -------- | -------- | -------- | -------- | | ||
| | | | | | | ||
| | | | | | | ||
| | | | | | | ||
|
|
||
| ### 系统表 | ||
|
|
||
| ### 其他 | ||
|
|
||
| ## 改进提升 | ||
|
|
||
| ## 错误修复 | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.