From 2ba5a87f33db9b4e2a0e9aff273f9866abdb9500 Mon Sep 17 00:00:00 2001 From: doc-claw-bot Date: Fri, 21 Aug 2026 10:25:06 +0000 Subject: [PATCH 1/3] docs: fix tidb_server_memory_limit unit description --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index a9724405332f4..f493f56af72cc 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4823,7 +4823,7 @@ SHOW WARNINGS; - Default value: `80%` - Range: - You can set the value in the percentage format, which means the percentage of the memory usage relative to the total memory. The value range is `[1%, 99%]`. - - You can also set the value in memory size. The value range is `0` and `[536870912, 9223372036854775807]` in bytes. The memory format with the units "KiB|MiB|GiB|TiB" is supported. `0` means no memory limit. + - You can also set the value in memory size. The value range is `0` and `[536870912, 9223372036854775807]` in bytes. The memory format without spaces, with the units "KB|MB|GB|TB", is supported. For example, you can set this variable to `90GB`. `0` means no memory limit. - If this variable is set to a memory size that is less than 512 MiB but not `0`, TiDB uses 512 MiB as the actual size. - This variable specifies the memory limit for a TiDB instance. When the memory usage of TiDB reaches the limit, TiDB cancels the currently running SQL statement with the highest memory usage. After the SQL statement is successfully canceled, TiDB tries to call Golang GC to immediately reclaim memory to relieve memory stress as soon as possible. - Only the SQL statements with more memory usage than the [`tidb_server_memory_limit_sess_min_size`](/system-variables.md#tidb_server_memory_limit_sess_min_size-new-in-v640) limit are selected as the SQL statements to be canceled first. From 24abbae32eb0319045daee5fa91104bd50154200 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 21 Aug 2026 18:34:06 +0800 Subject: [PATCH 2/3] Apply suggestion from @qiancai --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index f493f56af72cc..d27524d7c5050 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4823,7 +4823,7 @@ SHOW WARNINGS; - Default value: `80%` - Range: - You can set the value in the percentage format, which means the percentage of the memory usage relative to the total memory. The value range is `[1%, 99%]`. - - You can also set the value in memory size. The value range is `0` and `[536870912, 9223372036854775807]` in bytes. The memory format without spaces, with the units "KB|MB|GB|TB", is supported. For example, you can set this variable to `90GB`. `0` means no memory limit. + - You can also set the value in memory size. The value range is `0` and `[536870912, 9223372036854775807]` in bytes. The memory format with units "KB|MB|GB|TB" is supported. For example, you can set this variable to `90GB` (no space between the number and the unit). `0` means no memory limit. - If this variable is set to a memory size that is less than 512 MiB but not `0`, TiDB uses 512 MiB as the actual size. - This variable specifies the memory limit for a TiDB instance. When the memory usage of TiDB reaches the limit, TiDB cancels the currently running SQL statement with the highest memory usage. After the SQL statement is successfully canceled, TiDB tries to call Golang GC to immediately reclaim memory to relieve memory stress as soon as possible. - Only the SQL statements with more memory usage than the [`tidb_server_memory_limit_sess_min_size`](/system-variables.md#tidb_server_memory_limit_sess_min_size-new-in-v640) limit are selected as the SQL statements to be canceled first. From 7e1419702124e9541fe3e3fe62deb9670e54da95 Mon Sep 17 00:00:00 2001 From: qiancai Date: Tue, 25 Aug 2026 17:06:20 +0800 Subject: [PATCH 3/3] docs: fix session memory limit unit description --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index d27524d7c5050..42f0910c6ea7f 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4852,7 +4852,7 @@ SHOW WARNINGS; - Persists to cluster: Yes - Applies to hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value): No - Default value: `134217728` (which is 128 MiB) -- Range: `[128, 9223372036854775807]`, in bytes. The memory format with the units "KiB|MiB|GiB|TiB" is also supported. +- Range: `[128, 9223372036854775807]`, in bytes. The memory format with units "KB|MB|GB|TB" is supported. For example, you can set this variable to `90GB` (no space between the number and the unit). - After you enable the memory limit, TiDB will terminate the SQL statement with the highest memory usage on the current instance. This variable specifies the minimum memory usage of the SQL statement to be terminated. If the memory usage of a TiDB instance that exceeds the limit is caused by too many sessions with low memory usage, you can properly lower the value of this variable to allow more sessions to be canceled. ### tidb_service_scope New in v7.4.0