Skip to content
Merged
Changes from 3 commits
Commits
Show all changes
76 commits
Select commit Hold shift + click to select a range
ba91d7f
Create release-8.5.5.md
qiancai Dec 16, 2025
45da8e9
add feature description for #56522 and #58685
qiancai Dec 17, 2025
1f2860a
Added descriptions for additional changes included in the release
benmeadowcroft Dec 17, 2025
b19b87e
Apply suggestions from code review
benmeadowcroft Dec 18, 2025
af5952e
add two info
qiancai Dec 18, 2025
f78c3ba
Update releases/release-8.5.5.md
qiancai Dec 24, 2025
c7d9300
add improvements and bug fixes
qiancai Dec 24, 2025
609017f
add more features and adjust the feature order
qiancai Dec 25, 2025
408f019
Update releases/release-8.5.5.md
qiancai Dec 25, 2025
493e5bb
Apply suggestions from code review
qiancai Dec 25, 2025
ea2f6c4
update INDEX_LOOKUP_PUSHDOWN
Oreoxmt Dec 25, 2025
c71d5e0
Apply suggestions from code review
hfxsd Dec 26, 2025
e8314fe
add the feature description for storage engine identifiers
qiancai Dec 29, 2025
0d5f07c
Update releases/release-8.5.5.md
hfxsd Dec 29, 2025
c39dd48
add cdc bug fixes
qiancai Dec 30, 2025
ca80447
add improvements and bug fixes for SQL data
qiancai Dec 30, 2025
8230567
move ticdc #12253 from bug fixes to improvements
qiancai Dec 30, 2025
5fd1c44
add BR bug fixes
qiancai Dec 30, 2025
56ddb22
Compatibility changes: add tidb_index_lookup_pushdown_policy
Oreoxmt Dec 31, 2025
2b66057
add improvements and bug fixes for coprocessor/TiKV /engine/raft
qiancai Dec 31, 2025
7a82c46
Apply suggestions from code review
qiancai Jan 5, 2026
cc39d05
translate #63366
qiancai Jan 5, 2026
79dc832
translate two features
qiancai Jan 5, 2026
88ef8b1
Update releases/release-8.5.5.md
qiancai Jan 5, 2026
3c342fb
Refine wording
lilin90 Jan 5, 2026
cc56942
Update releases/release-8.5.5.md
qiancai Jan 5, 2026
842030e
Apply suggestions from code review
qiancai Jan 5, 2026
0dda867
add release notes from the zh PR
qiancai Jan 5, 2026
52eb72a
add tw info for improvements and bug fixes
qiancai Jan 5, 2026
13a4378
add a bug fix for TiDB
qiancai Jan 5, 2026
b47208e
Apply suggestions from code review
benmeadowcroft Jan 6, 2026
bdb4236
add parameter changes
qiancai Jan 7, 2026
d17f085
add links to variables
qiancai Jan 7, 2026
d9f1ac3
update PD, TiKV, BR
Oreoxmt Jan 7, 2026
1c3ddd3
Update releases/release-8.5.5.md
hfxsd Jan 8, 2026
18936b8
Apply suggestions from code review
hfxsd Jan 8, 2026
a451d7f
Apply suggestions from code review
hfxsd Jan 8, 2026
bcd1c1b
Apply suggestions from code review
hfxsd Jan 8, 2026
d33be46
update the compatibility info
qiancai Jan 8, 2026
3a92864
translate TiDB improvements and PD bug fixes
qiancai Jan 8, 2026
d86c38b
translate TiCDC improvements and bug fixes
qiancai Jan 9, 2026
28402ab
Apply suggestions from code review
qiancai Jan 9, 2026
e2dbfbc
add the default value of tidb_analyze_column_options
qiancai Jan 9, 2026
a4af988
Apply suggestions from code review
Oreoxmt Jan 9, 2026
7f1703a
add readpool.cpu-threshold
qiancai Jan 10, 2026
c324340
Apply suggestions from code review
lilin90 Jan 12, 2026
d06d930
Update wording
lilin90 Jan 12, 2026
3ee63a6
Update releases/release-8.5.5.md
qiancai Jan 12, 2026
1283cf0
Refine wording
lilin90 Jan 12, 2026
607cfe5
Apply suggestions from code review
Oreoxmt Jan 12, 2026
90ccd4f
Refine wording and format
lilin90 Jan 12, 2026
6749bcd
update tidb_analyze_column_options
qiancai Jan 12, 2026
53f45f4
Compatibility changes: sync changes from zh
qiancai Jan 12, 2026
b7372ea
Apply suggestions from code review
qiancai Jan 13, 2026
ceace33
change the default value of enable-async-batch-get to false for 8.5.5
qiancai Jan 13, 2026
1134696
Apply suggestions from code review
qiancai Jan 13, 2026
6d19cbe
Apply suggestions from code review
qiancai Jan 13, 2026
c91097f
remove inline tag comments
qiancai Jan 13, 2026
470a5cc
add TOC related changes
qiancai Jan 13, 2026
492d87e
fix build errors
qiancai Jan 13, 2026
29432f2
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
5838292
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
0a302ff
fix issue numbers
qiancai Jan 14, 2026
6250123
remove a duplicated #58985 for the same issue
qiancai Jan 14, 2026
cddc3a7
fix a format issue
qiancai Jan 14, 2026
cd24c20
Update releases/release-8.5.5.md
hfxsd Jan 14, 2026
4c50ace
fix a format issue
qiancai Jan 14, 2026
0cbbe61
fix format issues
qiancai Jan 14, 2026
2ad281c
fix format issues
qiancai Jan 14, 2026
d12c497
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
b9af5ea
Merge branch 'add-8.5.5-rn' of github.com:qiancai/docs into add-8.5.5-rn
qiancai Jan 14, 2026
ae22780
Apply suggestions from code review
qiancai Jan 14, 2026
de23e6a
Update releases/release-8.5.5.md
qiancai Jan 14, 2026
a31ffa9
Update releases/release-8.5.5.md
qiancai Jan 15, 2026
c1a1e36
update the release date
qiancai Jan 15, 2026
952b6f1
Merge branch 'add-8.5.5-rn' of github.com:qiancai/docs into add-8.5.5-rn
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
154 changes: 154 additions & 0 deletions releases/release-8.5.5.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
---
title: TiDB 8.5.5 Release Notes
summary: Learn about the features, compatibility changes, improvements, and bug fixes in TiDB 8.5.5.
---

# TiDB 8.5.5 Release Notes

Release date: xx xx, 2026

TiDB version: 8.5.5

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)

## Features

### Scalability

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Performance

* Point-in-time recovery (PITR) supports recovery from compacted log backups for faster restores [#56522](https://github.com/pingcap/tidb/issues/56522) @[YuJuncen](https://github.com/YuJuncen)

Starting from v8.5.5, the log backup compaction feature provides offline compaction capabilities, converting unstructured log backup data into structured SST files. This results in the following improvements:

- **Improved recovery performance** - SST files can be more quickly imported into the cluster.
- **Reduced storage space consumption** - redundant data is removed during compaction.
- **Reduced impact on applications** - RPOs can be amintained with less frequent full snapshot-based backups.

For more information, see [documentation](/br/br-compact-log-backup.md).

* Accelerated recovery of system tables from backups [#58757](https://github.com/pingcap/tidb/issues/58757) @[Leavrth](https://github.com/Leavrth) **tw@xxx** <!--1234-->

When restoring system tables from a backup, BR now introduces a new `--fast-load-sys-tables` parameter to use physical restoration instead of logical restoration. This option completely overwrites/replaces the existing tables, instead of restoring into them, for faster restoration for large scale deployments.

For more information, see [Documentation](/br/br-snapshot-guide.md#restore-tables-in-the-mysql-schema).

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Reliability

* Improved store scheduling in presence of network jitter [#9359](https://github.com/tikv/pd/issues/9359) @[okJiang](https://github.com/okJiang) **tw@xxx** <!--1234-->

Provides a network status feedback mechanism to PD to avoid scheduling the leaders back to a problematic node (experiencing network jitter) after the leaders had been transferred off the node by TiKVs detection of the network jitter.

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Availability

* Introduce Client Circuit Breaker Pettern for PD [#8678](https://github.com/tikv/pd/issues/8678) @[Tema](https://github.com/Tema) **tw@xxx** <!--1234-->

To protect the PD leader from overloading due to retry storms or similar feedback loops, a circuit breaker pattern is introduced to limit incoming traffic (when a threshold of errors is reached) to enable the system to stabilize. The `tidb_cb_pd_metadata_error_rate_threshold_ratio` system variable is used to control the application of the circuit breaker.

For more information, see [Documentation](/system-variables.md#tidb_cb_pd_metadata_error_rate_threshold_ratio-new-in-v900).

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### SQL

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### DB operations

* Improve the compatibility between ongoing log backup and snapshot restore [#58685](https://github.com/pingcap/tidb/issues/58685) @[BornChanger](https://github.com/BornChanger)

Starting from v8.5.5, log backups can continue to run when performing a snapshot restore (when prerequisite conditions are met). This enables ongoing log backups to proceed without having to stop them during the restore procedure. The newly restored data will also be recorded in the ongoing log backup.

For more information, see [documentation](/br/br-pitr-manual.md#compatibility-between-ongoing-log-backup-and-snapshot-restore).

* Table level restores from Log Backups [#57613](https://github.com/pingcap/tidb/issues/57613) @[Tristan1900](https://github.com/Tristan1900)

Starting from v8.5.5, individual table level point in time recoveries can now be performed from log backups using filters. Being able to restore individual tables, instead of the full cluster, to a specific point in time enables much more flexible, and less impactful, recovery options.

Check warning on line 92 in releases/release-8.5.5.md

View workflow job for this annotation

GitHub Actions / vale

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

For more information, see [documentation](/br/br-pitr-manual.md#restore-data-using-filters).

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Observability

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Security

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

### Data migration

* Placeholder for feature summary [#Issue-number](issue-link) @[Contributor-GitHub-ID](id-link) **tw@xxx** <!--1234-->

Provide a concise overview of what the feature is, the value it offers to users, and include a brief sentence on how to use it effectively. If there are any particularly important aspects of this feature, be sure to mention them as well.

For more information, see [Documentation](link).

## Compatibility changes

### Behavior changes

### MySQL compatibility

### System variables

| Variable name | Change type | Description |
|--------|------------------------------|------|
| | | |
| | | |
| | | |

### Configuration parameters

| Configuration file or component | Configuration parameter | Change type | Description |
| -------- | -------- | -------- | -------- |
| | | | |
| | | | |
| | | | |

### System tables

### Other changes

## Improvements

## Bug fixes
Loading