From 2c5b0754ea44e270bf73e089aca0515abf40b649 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Aug 2026 14:35:38 +0800 Subject: [PATCH 1/4] Create empty translation PR From dad2709793a86f665ca501f3b903b0fcea2a81be Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 19 Aug 2026 06:37:13 +0000 Subject: [PATCH 2/4] Auto-sync: Update English docs from Chinese PR Synced from: https://github.com/pingcap/docs-cn/pull/21752 Target PR: https://github.com/pingcap/docs/pull/23565 Co-authored-by: github-actions[bot] --- system-variables.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/system-variables.md b/system-variables.md index 1555a6ceb02e6..03b52192586ad 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5499,6 +5499,18 @@ SHOW WARNINGS; - Range: `[0, 2147483647]` - This variable controls the iteration of the optimizer's estimation logic. After changing the value of this variable, the estimation logic of the optimizer will change greatly. Currently, `0` is the only valid value. It is not recommended to set it to other values. +### `tidb_paging_size_bytes` New in v9.0.0 + +- Scope: SESSION | GLOBAL +- Persists to cluster: Yes +- Applies to hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value): Yes +- Type: Integer +- Default value: `0` +- Range: `[0, 9223372036854775807]` +- Unit: bytes +- Controls the upper limit on the number of bytes in a single paged response in the coprocessor protocol, providing additional pagination by byte count beyond the row-count-based pagination mechanism provided by [`tidb_max_paging_size`](#tidb_max_paging_size-new-in-v630). The default value is `0`, which means pagination by byte count is disabled. This feature takes effect only when [resource control](/tidb-resource-control-ru-groups.md) is enabled and the resource group to which the current statement belongs has a fixed RU quota. It is used by PD's resource control module to estimate and pre-deduct RU based on the amount of scanned data before executing the statement. If you need to enable it, consider setting it to `4194304` (that is, 4 MiB). +- This variable is an internal TiDB variable. It is **not recommended** to modify its value. + ### tidb_partition_prune_mode New in v5.1 > **Warning:** From a7a3bf513d998ce16dffd51a516b96b6a16edecb Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Aug 2026 15:30:09 +0800 Subject: [PATCH 3/4] Update system-variables.md --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 03b52192586ad..2a212cb353d65 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5508,7 +5508,7 @@ SHOW WARNINGS; - Default value: `0` - Range: `[0, 9223372036854775807]` - Unit: bytes -- Controls the upper limit on the number of bytes in a single paged response in the coprocessor protocol, providing additional pagination by byte count beyond the row-count-based pagination mechanism provided by [`tidb_max_paging_size`](#tidb_max_paging_size-new-in-v630). The default value is `0`, which means pagination by byte count is disabled. This feature takes effect only when [resource control](/tidb-resource-control-ru-groups.md) is enabled and the resource group to which the current statement belongs has a fixed RU quota. It is used by PD's resource control module to estimate and pre-deduct RU based on the amount of scanned data before executing the statement. If you need to enable it, consider setting it to `4194304` (that is, 4 MiB). +- Controls the maximum size, in bytes, of a single paged response in the coprocessor protocol, providing an additional response-size-based pagination mechanism alongside the row-based pagination controlled by [`tidb_max_paging_size`](#tidb_max_paging_size-new-in-v630).The default value of this variable is `0`, which disables byte-based pagination. This feature takes effect only when [resource control](/tidb-resource-control-ru-groups.md) is enabled, and the resource group of the current statement has a fixed RU quota. It allows the PD resource control module to estimate RU consumption based on the amount of data to be scanned and deduct the estimated RUs in advance before the statement is executed. To enable this feature, consider setting the variable to `4194304` (4 MiB). - This variable is an internal TiDB variable. It is **not recommended** to modify its value. ### tidb_partition_prune_mode New in v5.1 From 3b9f8780bd94530413c851f21005007fc3bc4bf8 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 20 Aug 2026 14:21:09 +0800 Subject: [PATCH 4/4] Update system-variables.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 2a212cb353d65..540e514dcd8f8 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5508,7 +5508,7 @@ SHOW WARNINGS; - Default value: `0` - Range: `[0, 9223372036854775807]` - Unit: bytes -- Controls the maximum size, in bytes, of a single paged response in the coprocessor protocol, providing an additional response-size-based pagination mechanism alongside the row-based pagination controlled by [`tidb_max_paging_size`](#tidb_max_paging_size-new-in-v630).The default value of this variable is `0`, which disables byte-based pagination. This feature takes effect only when [resource control](/tidb-resource-control-ru-groups.md) is enabled, and the resource group of the current statement has a fixed RU quota. It allows the PD resource control module to estimate RU consumption based on the amount of data to be scanned and deduct the estimated RUs in advance before the statement is executed. To enable this feature, consider setting the variable to `4194304` (4 MiB). +- Controls the maximum size, in bytes, of a single paged response in the coprocessor protocol, providing an additional response-size-based pagination mechanism alongside the row-based pagination controlled by [`tidb_max_paging_size`](#tidb_max_paging_size-new-in-v630). The default value of this variable is `0`, which disables byte-based pagination. This feature takes effect only when [resource control](/tidb-resource-control-ru-groups.md) is enabled, and the resource group of the current statement has a fixed RU quota. It allows the PD resource control module to estimate RU consumption based on the amount of data to be scanned and deduct the estimated RUs in advance before the statement is executed. To enable this feature, consider setting the variable to `4194304` (4 MiB). - This variable is an internal TiDB variable. It is **not recommended** to modify its value. ### tidb_partition_prune_mode New in v5.1