tidb: global memory arbitrator mechanism by solotzg · Pull Request #20955 · pingcap/docs-cn

solotzg · 2025-09-25T02:41:36Z

First-time contributors' checklist

I've signed the Contributor License Agreement, which is required for the repository owners to accept my contribution.

What is changed, added or deleted? (Required)

新增 TiDB 全局内存仲裁模式文档，包括：

在 configure-memory-usage.md 中新增内存仲裁模式章节，介绍 standard 和 priority 两种模式的工作原理、配置方法、监控指标及最佳实践
在 system-variables.md 中新增以下系统变量说明：
- tidb_mem_arbitrator_mode：设置 TiDB 实例的全局内存管理模式
- tidb_mem_arbitrator_query_reserved：设置 SQL 执行前预先订阅的内存资源份额
- tidb_mem_arbitrator_soft_limit：设置 TiDB 实例的内存资源份额上限
- tidb_mem_arbitrator_wait_averse：控制 SQL 等待内存资源的相关行为，包含 0（默认值，变量不生效）、1 和 nolimit 三个取值的说明

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions (in Chinese).

What is the related PR or file link(s)?

Other reference link(s): ref memory: global mem resources arbitrator tidb#63073 / design doc: TiDB Global Memory Arbitrator

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

Added details about the global memory management framework in TiDB, including modes, error handling, monitoring, and practical deployment recommendations.

Added new system variables related to memory management in TiDB, including details on their scopes, types, default values, and warnings regarding experimental features.

Updated the documentation for the global memory management framework in TiDB, including changes to error messages, memory management modes, and monitoring metrics.

configure-memory-usage.md

system-variables.md

Co-authored-by: xixirangrang <hfxsd@hotmail.com>

configure-memory-usage.md

system-variables.md

configure-memory-usage.md

system-variables.md

configure-memory-usage.md

system-variables.md

solotzg · 2026-04-01T06:23:04Z

/cc @copilot

…wait_averse Agent-Logs-Url: https://github.com/pingcap/docs-cn/sessions/a019b30c-a16a-48b0-98e0-61848219236f Co-authored-by: solotzg <9016847+solotzg@users.noreply.github.com>

solotzg · 2026-04-02T11:37:33Z

@copilot merge master

…tzg-patch-1 Co-authored-by: solotzg <9016847+solotzg@users.noreply.github.com>

Copilot · 2026-04-02T11:38:49Z

@copilot merge master

已在 e49f68d 将 master 合并到本分支。

Updated warning message regarding experimental feature for memory arbitration mode.

configure-memory-usage.md

solotzg added 6 commits September 24, 2025 18:08

Document global memory management framework in TiDB

c4f2c5e

Added details about the global memory management framework in TiDB, including modes, error handling, monitoring, and practical deployment recommendations.

Document new TiDB memory management system variables

80a85a0

Added new system variables related to memory management in TiDB, including details on their scopes, types, default values, and warnings regarding experimental features.

Revise TiDB global memory management documentation

9fc3a44

Updated the documentation for the global memory management framework in TiDB, including changes to error messages, memory management modes, and monitoring metrics.

Update system-variables.md

3642a34

Update memory management mode descriptions in docs

8d9e47e

Fix formatting and links in memory usage documentation

eca03a5

ti-chi-bot bot added missing-translation-status This PR does not have translation status info. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Sep 25, 2025

solotzg added 2 commits September 25, 2025 12:04

Fix formatting and clarify SQL memory arbitration

3b590b5

Fix formatting and indentation in system-variables.md

9c6b567

qiancai added v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3. translation/doing This PR’s assignee is translating this PR. and removed missing-translation-status This PR does not have translation status info. labels Sep 25, 2025

qiancai assigned hfxsd Sep 25, 2025

hfxsd self-requested a review September 25, 2025 07:39

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Oct 10, 2025

View reviewed changes

system-variables.md Outdated Show resolved Hide resolved

hfxsd and others added 3 commits December 4, 2025 10:54

Apply suggestions from code review

25e7348

Apply suggestion from @hfxsd

d09ccc4

Co-authored-by: xixirangrang <hfxsd@hotmail.com>

Apply suggestion from @hfxsd

c209ed2

Co-authored-by: xixirangrang <hfxsd@hotmail.com>

hfxsd reviewed Dec 4, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

Update configure-memory-usage.md

7ab81e2

hfxsd reviewed Dec 4, 2025

View reviewed changes

system-variables.md Outdated Show resolved Hide resolved

Apply suggestion from @hfxsd

903ea35

hfxsd reviewed Dec 4, 2025

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

Apply suggestion from @hfxsd

cc29500

hfxsd added the type/compatibility-or-feature-change This PR involves compatibility changes or feature behavior changes. label Dec 4, 2025

Merge remote-tracking branch 'upstream/master' into solotzg-patch-1

f4948c1

hfxsd removed the request for review from joey-yez March 23, 2026 07:50

hfxsd reviewed Mar 23, 2026

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Mar 23, 2026

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

hfxsd reviewed Mar 23, 2026

View reviewed changes

system-variables.md Outdated Show resolved Hide resolved

hfxsd reviewed Mar 23, 2026

View reviewed changes

configure-memory-usage.md Show resolved Hide resolved

Apply suggestions from code review

6a80223

hfxsd reviewed Mar 23, 2026

View reviewed changes

system-variables.md Show resolved Hide resolved

Copilot started work on behalf of solotzg April 1, 2026 06:23 View session

system-variables: add explanation for value 0 of tidb_mem_arbitrator_…

bc1646f

…wait_averse Agent-Logs-Url: https://github.com/pingcap/docs-cn/sessions/a019b30c-a16a-48b0-98e0-61848219236f Co-authored-by: solotzg <9016847+solotzg@users.noreply.github.com>

Copilot finished work on behalf of solotzg April 1, 2026 06:25

Copilot started work on behalf of solotzg April 2, 2026 11:37 View session

Merge branch 'master' of https://github.com/pingcap/docs-cn into solo…

e49f68d

…tzg-patch-1 Co-authored-by: solotzg <9016847+solotzg@users.noreply.github.com>

Copilot finished work on behalf of solotzg April 2, 2026 11:40

Revise warning for experimental memory arbitration feature

d239b26

Updated warning message regarding experimental feature for memory arbitration mode.

solotzg commented Apr 2, 2026

View reviewed changes

configure-memory-usage.md Outdated Show resolved Hide resolved

Apply suggestion from @solotzg

6a607d1

Conversation

solotzg commented Sep 25, 2025 • edited by Copilot AI Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

First-time contributors' checklist

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

solotzg commented Apr 1, 2026

Uh oh!

solotzg commented Apr 2, 2026

Uh oh!

Copilot AI commented Apr 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

solotzg commented Sep 25, 2025 •

edited by Copilot AI

Loading