Skip to content

docs: clarify max-ts max-drift constraint #21761

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

Closed
ekexium wants to merge 2 commits into from
Closed

docs: clarify max-ts max-drift constraint #21761

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3682927
docs: clarify max-ts max-drift constraint
ekexium Jul 3, 2026
789a59e
docs: align max-drift description
ekexium Jul 3, 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 tikv-configuration-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -662,6 +662,7 @@ I/O rate limiter 相关的配置项。
+ 定义当读写请求使用的 TS 超过 TiKV 缓存的 PD TSO 时，所允许的最长超出时间。
+ 如果某个读写请求使用的 TS 超过了 TiKV 缓存的 PD TSO + `max-drift`，TiKV 会将其视为非法的 `max-ts` 更新请求，并根据 [`action-on-invalid-update`](#action-on-invalid-update-从-v900-版本开始引入) 的配置进行处理。
+ 默认值：`"60s"`
+ 该值必须大于 [`cache-sync-interval`](#cache-sync-interval-从-v900-版本开始引入)，否则 TiKV 校验配置会失败并拒绝启动。
+ 建议设置为 [`cache-sync-interval`](#cache-sync-interval-从-v900-版本开始引入) 的 3 倍以上。

## pd
Expand Down
Loading