Skip to content
Open
Changes from 8 commits
Commits
Show all changes
50 commits
Select commit Hold shift + click to select a range
2d7bd8a
Create release-8.5.4.md
qiancai Oct 15, 2025
e3f6565
dup: zh -> en
qiancai Oct 15, 2025
e3d9d45
Update release-8.5.4.md
qiancai Oct 15, 2025
37bcef0
Update release-8.5.4.md
qiancai Oct 15, 2025
5281ea7
Update release-8.5.4.md
qiancai Oct 15, 2025
6ce2fd6
Update releases/release-8.5.4.md
qiancai Oct 15, 2025
7c914d2
add bug fixes for br
qiancai Oct 20, 2025
faf0b0a
Apply suggestions from code review
qiancai Oct 20, 2025
e2cb004
pd part
bufferflies Oct 20, 2025
bb54f01
add cdc bug fixes
qiancai Oct 21, 2025
2aa77a7
adjust notes location
qiancai Oct 24, 2025
8a76d43
sync from zh
qiancai Oct 27, 2025
4808654
Apply suggestions from code review
hfxsd Oct 28, 2025
b0727db
Update releases/release-8.5.4.md
hfxsd Oct 29, 2025
7873820
update PD and TiCDC
Oreoxmt Oct 29, 2025
39414ed
update Compatibility changes and TiDB
Oreoxmt Oct 29, 2025
3d21156
Update releases/release-8.5.4.md
hfxsd Oct 29, 2025
a4bd1d0
Apply suggestions from code review
hfxsd Oct 29, 2025
ce19359
Apply suggestions from code review
hfxsd Oct 30, 2025
63e70e9
remove duplicated #9013
qiancai Oct 31, 2025
042a159
Apply suggestions from code review
qiancai Oct 31, 2025
9558fe2
Update releases/release-8.5.4.md
qiancai Oct 31, 2025
050d720
Update releases/release-8.5.4.md
qiancai Oct 31, 2025
9edc943
refine the description of #9343
qiancai Nov 3, 2025
384c99c
add tidb_enable_binding_usage
qiancai Nov 3, 2025
e8b671a
Apply suggestions from code review
hfxsd Nov 3, 2025
24a1ff4
Update releases/release-8.5.4.md
qiancai Nov 3, 2025
78a4dad
add graceful_wait_shutdown_timeout
qiancai Nov 3, 2025
938b854
Apply suggestions from code review
qiancai Nov 3, 2025
c47dcd2
Apply suggestions from code review
Oreoxmt Nov 3, 2025
90331b1
move 62917 from improvements to bug fixes
Oreoxmt Nov 3, 2025
6c03c20
update links
Oreoxmt Nov 3, 2025
9dad458
Apply suggestions from code review
Oreoxmt Nov 3, 2025
25a2312
Apply suggestions from code review
Oreoxmt Nov 3, 2025
73178ee
reorder items in compatibility changes
qiancai Nov 4, 2025
0e47870
update BR bug fix descriptions according to zh changes
qiancai Nov 4, 2025
01367cb
Update release-8.5.4.md
qiancai Nov 4, 2025
70f326a
add #61826
qiancai Nov 4, 2025
91709c0
Apply suggestions from code review
Oreoxmt Nov 4, 2025
832ec7d
add the issue for `DISTRIBUTE TABLE`
qiancai Nov 4, 2025
2932176
zh dup -> en dup
qiancai Nov 4, 2025
9b761d2
Apply suggestions from code review
hfxsd Nov 5, 2025
15e8fa4
Apply suggestions from code review
hfxsd Nov 5, 2025
9259414
Update format
lilin90 Nov 5, 2025
79f3291
add TiCDC new architecture
qiancai Nov 6, 2025
d740165
Update releases/release-8.5.4.md
qiancai Nov 6, 2025
bbd0406
add a blank line
qiancai Nov 6, 2025
1c7c611
Update releases/release-8.5.4.md
hfxsd Nov 6, 2025
f76079b
remove tidb_enable_binding_usage
qiancai Nov 6, 2025
1683ee5
Update releases/release-8.5.4.md
qiancai Nov 6, 2025
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
140 changes: 140 additions & 0 deletions releases/release-8.5.4.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
---
title: TiDB 8.5.4 Release Notes
summary: Learn about the compatibility changes, improvements, and bug fixes in TiDB 8.5.4.
---

# TiDB 8.5.4 Release Notes

Release date: xx xx, 2025

TiDB version: 8.5.4

Quick access: [Quick start](https://docs.pingcap.com/tidb/v8.5/quick-start-with-tidb) | [Production deployment](https://docs.pingcap.com/tidb/v8.5/production-deployment-using-tiup)

## Compatibility changes

- note [#issue](https://github.com/pingcap/${repo-name}/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-7.5.7.md > Compatibility changes - TiKV deprecates the following configuration items and replaces them with the new [`gc.auto-compaction`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) configuration group, which controls automatic compaction behavior [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar)

Check failure on line 17 in releases/release-8.5.4.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [PingCAP.Units] Put a nonbreaking space between the number and the unit in '01d'. Raw Output: {"message": "[PingCAP.Units] Put a nonbreaking space between the number and the unit in '01d'.", "location": {"path": "releases/release-8.5.4.md", "range": {"start": {"line": 17, "column": 357}}}, "severity": "ERROR"}

- Deprecated configuration items: [`region-compact-check-interval`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-new-in-v710), and [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-new-in-v710).
- New configuration items: [`gc.auto-compaction.check-interval`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#check-interval-new-in-v757), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#tombstone-num-threshold-new-in-v757), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-new-in-v757), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-new-in-v757), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-new-in-v757), and [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/tidb/v8.5/tikv-configuration-file#bottommost-level-force-new-in-v757).

## Improvements

+ TiDB

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v8.5.3 already includes the following issue for pingcap/tidb#62232. Now in v8.5.4, there is another PR pingcap/tidb#63485 for the same issue. Should we use the same release note in v8.5.4?

- Add flow control interfaces for Region splitting and data ingestion during data import [#61553](https://github.com/pingcap/tidb/issues/61553) @[tangenta](https://github.com/tangenta)

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-9.0.0.md(beta.1) > # SQL * Support creating global indexes on non-unique columns of partitioned tables [#58650](https://github.com/pingcap/tidb/issues/58650) @[Defined2014](https://github.com/Defined2014) @[mjonss](https://github.com/mjonss)
- (dup): release-9.0.0.md(beta.1) > Improvements> TiDB - Support applying the `semi_join_rewrite` hint to Semi Joins in `IN` subqueries [#58829](https://github.com/pingcap/tidb/issues/58829) @[qw4990](https://github.com/qw4990)

+ TiKV

- note [#issue](https://github.com/tikv/tikv/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/tikv/tikv/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-7.5.7.md > Improvements> TiKV - Optimize the tail latency of async snapshot and write operations in environments with a large number of SST files [#18743](https://github.com/tikv/tikv/issues/18743) @[Connor1996](https://github.com/Connor1996)

Check warning on line 35 in releases/release-8.5.4.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion. Raw Output: {"message": "[PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion.", "location": {"path": "releases/release-8.5.4.md", "range": {"start": {"line": 35, "column": 140}}}, "severity": "INFO"}

+ PD

- note [#issue](https://github.com/tikv/pd/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/tikv/pd/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-7.5.7.md > Improvements> PD - Reduce unnecessary error logs [#9370](https://github.com/tikv/pd/issues/9370) @[bufferflies](https://github.com/bufferflies)

+ TiFlash

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

+ Tools

+ Backup & Restore (BR)

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiCDC

- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiDB Data Migration (DM)

- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiDB Lightning

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ Dumpling

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiUP

- note [#issue](https://github.com/pingcap/tiup/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiup/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

## Bug fixes

+ TiDB

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-7.5.7.md > Bug fixes> TiDB - Fix the issue that row count estimates across months or years can be significantly overestimated [#50080](https://github.com/pingcap/tidb/issues/50080) @[terry1purcell](https://github.com/terry1purcell)

+ TiKV

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v8.5.3 already includes the following issue for pingcap/tidb#62232. Now in v8.5.4, there is another PR tikv/tikv#18581 for the same issue. Should we use the same release note in v8.5.4?

- Optimize the handling of `CompactedEvent` in Raftstore by moving it to the `split-check` worker, reducing blocking on the main Raftstore thread [#18532](https://github.com/tikv/tikv/issues/18532) @[LykxSassinator](https://github.com/LykxSassinator)

- note [#issue](https://github.com/tikv/tikv/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/tikv/tikv/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ PD

- note [#issue](https://github.com/tikv/pd/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/tikv/pd/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- (dup): release-9.0.0.md(beta.1) > Bug fixes> PD - Fix the issue that the PD client retry policy is not properly initialized [#9013](https://github.com/tikv/pd/issues/9013) @[rleungx](https://github.com/rleungx)

+ TiFlash

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

+ Tools

+ Backup & Restore (BR)

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- Fix the issue where Zstd compression did not take effect in log backup, resulting in uncompressed output. [#18836](https://github.com/tikv/tikv/issues/18836) @[3pointer](https://github.com/3pointer)
- Fixed a bug that may cause flush operation slow in azure blob storage. [#18410](https://github.com/tikv/tikv/issues/18410) @[YuJuncen](https://github.com/YuJuncen)
- Fixed a bug that may cause `log truncate` panic when failed to delete file. [#63358](https://github.com/pingcap/tidb/issues/63358) @[YuJuncen](https://github.com/YuJuncen)
- Fixed a bug that may cause `stats_meta` be zero when checksumming disabled. [#60978](https://github.com/pingcap/tidb/issues/60978) @[Leavrth](https://github.com/Leavrth)
- Reduced chance of BR restore failure from S3-compatible storage when the S3 server limits bandwidth through traffic shaping. [#18846](https://github.com/tikv/tikv/issues/18846) @[kennytm](https://github.com/kennytm)
- Fix the issue that the log backup observer loses observation of a region. [#18243](https://github.com/tikv/tikv/issues/18243) @[Leavrth](https://github.com/Leavrth)
- Fixed a a bug that may cause `restore point` fail when there are some special sized table schemas. [#63663](https://github.com/pingcap/tidb/issues/63663) @[RidRisR](https://github.com/RidRisR)
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v8.5.3 already includes the following issue for tikv/tikv#18615. Now in v8.5.4, there is another PR tikv/tikv#18783 for the same issue. Should we use the same release note in v8.5.4?

Fix the issue that log backup uploads to Azure Blob Storage are slow when transferring large volumes of data #18410 @YuJuncen


+ TiCDC

- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiDB Data Migration (DM)

- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiflow/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiDB Lightning

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ Dumpling

- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tidb/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})

+ TiUP

- note [#issue](https://github.com/pingcap/tiup/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
- note [#issue](https://github.com/pingcap/tiup/issues/${issue-id}) @[Contributor GitHub ID](https://github.com/${github-id})
Loading