system-variables: add tidb_paging_size_bytes (internal use)#21752
Open
JmPotato wants to merge 1 commit into
Open
system-variables: add tidb_paging_size_bytes (internal use)#21752JmPotato wants to merge 1 commit into
JmPotato wants to merge 1 commit into
Conversation
Signed-off-by: JmPotato <github@ipotato.me>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
ti-chi-bot
Bot
added
missing-translation-status
ti-chi-bot
Bot
removed
the
missing-translation-status
qiancai
reviewed
Jul 14, 2026
| - 范围：`[0, 9223372036854775807]` | ||
| - 单位：字节 | ||
| - 这个变量用来设置 coprocessor 协议中单个 paging 响应的字节数上限，用于在按行数分页（[`tidb_max_paging_size`](#tidb_max_paging_size-从-v630-版本开始引入)）之外，额外提供按字节分页的能力。默认值为 `0`，表示关闭按字节分页。该功能仅在开启[资源管控](/tidb-resource-control-ru-groups.md)时生效，供 PD 资源管控做 RU 预扣费使用。 | ||
| - 该变量是 TiDB 内部使用的变量，**不推荐**修改该变量的值。 |
Collaborator
There was a problem hiding this comment.
Suggested change
| - 该变量是 TiDB 内部使用的变量，**不推荐**修改该变量的值。 | |
| - 该变量为 TiDB 内部变量，**不推荐**修改该变量的值。 |
qiancai
approved these changes
Jul 14, 2026
| - 默认值：`0` | ||
| - 范围：`[0, 9223372036854775807]` | ||
| - 单位：字节 | ||
| - 这个变量用来设置 coprocessor 协议中单个 paging 响应的字节数上限，用于在按行数分页（[`tidb_max_paging_size`](#tidb_max_paging_size-从-v630-版本开始引入)）之外，额外提供按字节分页的能力。默认值为 `0`，表示关闭按字节分页。该功能仅在开启[资源管控](/tidb-resource-control-ru-groups.md)时生效，供 PD 资源管控做 RU 预扣费使用。 |
Collaborator
There was a problem hiding this comment.
Suggested change
| - 这个变量用来设置 coprocessor 协议中单个 paging 响应的字节数上限，用于在按行数分页（[`tidb_max_paging_size`](#tidb_max_paging_size-从-v630-版本开始引入)）之外，额外提供按字节分页的能力。默认值为 `0`，表示关闭按字节分页。该功能仅在开启[资源管控](/tidb-resource-control-ru-groups.md)时生效，供 PD 资源管控做 RU 预扣费使用。 | |
| - 控制 coprocessor 协议中单个分页响应的字节数上限，用于在 [`tidb_max_paging_size`](#tidb_max_paging_size-从-v630-版本开始引入) 所提供的按行数分页机制之外，额外提供按字节数分页的能力。默认值为 `0`，表示关闭按字节分页。该功能仅在开启[资源管控](/tidb-resource-control-ru-groups.md)时且当前语句所属资源组具有固定的 RU 配额时生效，供 PD 的资源管控模块在执行语句前根据扫描数据量预估并预扣 RU。 |
Collaborator
There was a problem hiding this comment.
reason: “预扣费”通常表示预先扣除费用，容易使人误以为 RU 是货币费用；此处实际是预扣 RU。
[LGTM Timeline notifier]Timeline:
|
Collaborator
|
@JmPotato I've added a few comments on this PR. PTAL. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What is changed, added or deleted? (Required)
新增系统变量
tidb_paging_size_bytes的文档说明。该变量由 pingcap/tidb#68091 引入，用于在 coprocessor 分页协议中，按字节数为单个 paging 响应设置上限（在按行数分页
tidb_max_paging_size之外，额外提供按字节分页的能力）。默认值为0（关闭），仅在开启资源管控时生效，供 PD 资源管控做 RU 预扣费使用。该变量为 TiDB 内部使用的变量，因此文档中已明确标注 不推荐修改该变量的值。
字段（作用域、是否持久化、SET_VAR Hint、类型、默认值、范围、单位）均取自源码定义（
ScopeGlobal | ScopeSession、TypeUnsigned、默认0、范围[0, math.MaxInt64]）。Which TiDB version(s) do your changes apply to? (Required)
What is the related PR or file link(s)?