From 2c5b0754ea44e270bf73e089aca0515abf40b649 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Aug 2026 14:35:38 +0800 Subject: [PATCH 1/7] 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/7] 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/7] 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/7] 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 From 201b8236680de761feac6b0749ed9e09f9bfcd94 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 31 Aug 2026 12:02:59 +0800 Subject: [PATCH 5/7] Apply suggestions from code review --- system-variables.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/system-variables.md b/system-variables.md index 540e514dcd8f8..fca48d8589554 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5499,9 +5499,14 @@ 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 +### `tidb_paging_size_bytes` New in v9.0.0 and TiDB-X-CLOUD.202603 -- Scope: SESSION | GLOBAL +>**Note:** +> +> This variable is not supported on TiDB Cloud Starter. + + +- Scope: SESSION | GLOBAL for TiDB Self-Managed; SESSION for TiDB Cloud Essential and Premium - Persists to cluster: Yes - Applies to hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value): Yes - Type: Integer From 1df26e2bb6bea4909fd4fba4be6d9ff069ff4d37 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 31 Aug 2026 15:54:13 +0800 Subject: [PATCH 6/7] Apply suggestions from code review --- system-variables.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index fca48d8589554..a4134af7d8802 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5506,7 +5506,9 @@ SHOW WARNINGS; > This variable is not supported on TiDB Cloud Starter. -- Scope: SESSION | GLOBAL for TiDB Self-Managed; SESSION for TiDB Cloud Essential and Premium +- Scope + - TiDB Self-Managed: SESSION | GLOBAL + - TiDB Cloud Essential and Premium: SESSION - Persists to cluster: Yes - Applies to hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value): Yes - Type: Integer From 2f7d4cf1a63991dc6e1d6cdd707074a6361bb521 Mon Sep 17 00:00:00 2001 From: qiancai Date: Mon, 31 Aug 2026 16:23:53 +0800 Subject: [PATCH 7/7] removed an empty line --- system-variables.md | 1 - 1 file changed, 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index a4134af7d8802..d615954776de8 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5505,7 +5505,6 @@ SHOW WARNINGS; > > This variable is not supported on TiDB Cloud Starter. - - Scope - TiDB Self-Managed: SESSION | GLOBAL - TiDB Cloud Essential and Premium: SESSION