Skip to content

tikv: add configuration items about mvcc load based compaction #21515

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

Open
hfxsd wants to merge 6 commits into
base: master
Choose a base branch
from
Open

tikv: add configuration items about mvcc load based compaction #21515

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
46df403
Add temp.md
hfxsd Apr 7, 2026
080079d
Delete temp.md
hfxsd Apr 7, 2026
1d41956
Auto-sync: Update Chinese docs from English PR
github-actions[bot] Apr 7, 2026
f0a6412
Apply suggestions from code review
hfxsd Apr 7, 2026
80c5ba0
Update tikv-configuration-file.md
hfxsd Apr 7, 2026
0d8aae5
Update tikv-configuration-file.md
hfxsd Apr 8, 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
17 changes: 17 additions & 0 deletions tikv-configuration-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2375,6 +2375,23 @@ Raft Engine 相关的配置项。
+ 控制是否强制对 RocksDB 最底层文件进行 compaction。
+ 默认值：`true`

### `mvcc-read-aware-enabled` <span class="version-mark">从 v8.5.6 和 v9.0.0 版本开始引入</span>

+ 控制是否启用 MVCC-read-aware compaction。启用后，TiKV 会跟踪读取请求期间扫描的 MVCC 版本数量，并利用这些信息优先对 MVCC 读取放大率高的 Region 进行 compaction。这可以降低热点 Region 在扫描过程中遇到大量陈旧版本时产生的读取延迟。
Copy link
Copy Markdown
Collaborator

@Oreoxmt Oreoxmt Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
+ 控制是否启用 MVCC-read-aware compaction。启用后，TiKV 会跟踪读取请求期间扫描的 MVCC 版本数量，并利用这些信息优先对 MVCC 读取放大率高的 Region 进行 compaction。这可以降低热点 Region 在扫描过程中遇到大量陈旧版本时产生的读取延迟。
+ 控制是否启用 MVCC-read-aware compaction。启用后，TiKV 会跟踪读取请求期间扫描的 MVCC 版本数量，并利用这些信息优先对 MVCC 读取放大率高的 Region 进行 compaction。这可以降低在扫描期间遇到大量过期版本的热点 Region 的读延迟。

+ 默认值：`false`

### `mvcc-scan-threshold` <span class="version-mark">从 v8.5.6 和 v9.0.0 版本开始引入</span>

+ 每次读取请求扫描的 MVCC 版本数量的最小值，用于将 Region 标记为 compaction 候选。此配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。
Copy link
Copy Markdown
Collaborator

@Oreoxmt Oreoxmt Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
+ 每次读取请求扫描的 MVCC 版本数量的最小值，用于将 Region 标记为 compaction 候选。此配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。
+ 将 Region 标记为 compaction 候选所需的每个读请求扫描的最小 MVCC 版本数量。此配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。

+ 默认值：`1000`
+ 最小值：`0`

### `mvcc-read-weight` <span class="version-mark">从 v8.5.6 和 v9.0.0 版本开始引入</span>

+ 在计算 Region 的压缩优先级分数时，对 MVCC 读取活动应用的权重乘数。较高的数值会提高 MVCC 读放大在整体评估中的权重，相对于其他压缩触发因素（例如 tombstone 密度）占比更大。该配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。
Copy link
Copy Markdown
Collaborator

@Oreoxmt Oreoxmt Apr 9, 2026

Choose a reason for hiding this comment

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

Suggested change
+ 在计算 Region 的压缩优先级分数时，对 MVCC 读取活动应用的权重乘数。较高的数值会提高 MVCC 读放大在整体评估中的权重，相对于其他压缩触发因素（例如 tombstone 密度）占比更大。该配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。
+ 计算 Region 的 compaction 优先级得分时，应用于 MVCC 读取活动的权重倍数。较高的数值会提高 MVCC 读放大在整体评估中的权重，相对于其他 compaction 触发因素（例如 tombstone 密度）占比更大。该配置项仅在 [`mvcc-read-aware-enabled`](#mvcc-read-aware-enabled-从-v856-和-v900-版本开始引入) 设置为 `true` 时生效。

+ 默认值：`3.0`
+ 最小值：`0.0`

## backup

用于 BR 备份相关的配置项。
Expand Down
Loading