Skip to content

Clarify TiKV large-row limit in transaction restraints (#21830) #21834

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.

Sign up for GitHub

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
ti-chi-bot merged 3 commits into from
Jul 23, 2026
+1 −0
Merged

Clarify TiKV large-row limit in transaction restraints (#21830) #21834

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
11df5d9
docs: clarify TiKV limit for large rows
doc-claw-bot Jul 22, 2026
f8e0bb2
Update develop/dev-guide-transaction-restraints.md
qiancai Jul 23, 2026
3cefe8b
Update develop/dev-guide-transaction-restraints.md
qiancai Jul 23, 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
1 change: 1 addition & 0 deletions develop/dev-guide-transaction-restraints.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -716,6 +716,7 @@ mysql> SELECT * FROM T2;

- TiDB v4.0.10 及更高的 v4.0.x 版本、v5.0.0 及更高的版本可通过 tidb-server 配置项 [`performance.txn-entry-size-limit`](/tidb-configuration-file.md#txn-entry-size-limit-从-v4010-和-v500-版本开始引入) 调整，低于 TiDB v4.0.10 的版本支持的单行容量为 6 MiB。
- 从 v7.6.0 开始，你可以使用 [`tidb_txn_entry_size_limit`](/system-variables.md#tidb_txn_entry_size_limit-从-v760-版本开始引入) 系统变量动态修改该配置项的值。
- 注意，TiKV 对单个写入请求的数据量大小也有限制。若单个写入请求的数据量超出 [`raftstore.raft-entry-max-size`](/tikv-configuration-file.md#raft-entry-max-size)（默认值为 8 MiB），TiKV 会拒绝处理该请求。当单行记录较大时，需要同时调整 TiDB 的 `tidb_txn_entry_size_limit` 和 TiKV 的 `raftstore.raft-entry-max-size`。

@coderabbitai coderabbitai Bot Jul 23, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

兼容 v7.6.0 之前的版本

当前表述只要求调整 tidb_txn_entry_size_limit，但该系统变量从 v7.6.0 才引入；本 PR 覆盖的 7.5、7.1 和 6.5 用户无法按此说明配置 TiDB。请同时说明旧版本使用 performance.txn-entry-size-limit，并保留新版本的动态调整方式。

As per path instructions：对于 Markdown 文件，能够安全替换连续变更行时必须提供 GitHub 可提交建议块。

Suggested change
- 注意，TiKV 对单个写入请求的数据量大小也有限制。若单个写入请求的数据量超出 [`raftstore.raft-entry-max-size`](/tikv-configuration-file.md#raft-entry-max-size)（默认值为 8 MiB），TiKV 会拒绝处理该请求。当单行记录较大时，需要同时调整 TiDB 的 `tidb_txn_entry_size_limit` 和 TiKV 的 `raftstore.raft-entry-max-size`。
- 注意，TiKV 对单个写入请求的数据量大小也有限制。若单个写入请求的数据量超出 [`raftstore.raft-entry-max-size`](/tikv-configuration-file.md#raft-entry-max-size)（默认值为 8 MiB），TiKV 会拒绝处理该请求。当单行记录较大时，需要同时调整 TiDB 的 [`performance.txn-entry-size-limit`](/tidb-configuration-file.md#txn-entry-size-limit-从-v4010-和-v500-版本开始引入) 和 TiKV 的 [`raftstore.raft-entry-max-size`](/tikv-configuration-file.md#raft-entry-max-size)；从 v7.6.0 开始，也可以通过 [`tidb_txn_entry_size_limit`](/system-variables.md#tidb_txn_entry_size_limit-从-v760-版本开始引入) 动态调整 TiDB 的限制。

Source: Path instructions


- 支持的最大单个事务容量为 1 TiB。

Expand Down
Loading