From effa7f1a0ddfa7c41f1d95ce7a5cc37e44c87bf0 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Sat, 7 Dec 2024 15:40:16 +0800 Subject: [PATCH 01/10] include announcement to make stats cache GA --- releases/release-7.4.0.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index 1841febd3870..5a4e3390e8c8 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -199,6 +199,12 @@ TiDB 版本：7.4.0 更多信息，请参考[用户文档](/system-variables.md#tidb_opt_enable_hash_join-从-v656v712-和-v740-版本开始引入)。 +* 控制统计信息缓存成为正式功能 [#46695](https://github.com/pingcap/tidb/issues/46695) @[hawkingrei](https://github.com/hawkingrei) + + TiDB 实例会缓存表的统计信息，加速执行计划的生成，提升性能。自 v6.1.0 开始，通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存的大小。当统计信息缓存达到上限时，TiDB 自动驱逐不活跃的缓存，从而提升稳定性。 + + 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 + ### SQL 功能 * TiDB 支持完整的分区类型管理功能 [#42728](https://github.com/pingcap/tidb/issues/42728) @[mjonss](https://github.com/mjonss) From a1afc159880fb539beefbf6c7149a949c0ef6bd2 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Sat, 7 Dec 2024 15:47:19 +0800 Subject: [PATCH 02/10] Update release-7.4.0.md --- releases/release-7.4.0.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index 5a4e3390e8c8..9be7620a30e6 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -201,7 +201,8 @@ TiDB 版本：7.4.0 * 控制统计信息缓存成为正式功能 [#46695](https://github.com/pingcap/tidb/issues/46695) @[hawkingrei](https://github.com/hawkingrei) - TiDB 实例会缓存表的统计信息，加速执行计划的生成，提升性能。自 v6.1.0 开始，通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存的大小。当统计信息缓存达到上限时，TiDB 自动驱逐不活跃的缓存，从而提升稳定性。 + TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL + 执行性能。自 v7.4.0，对统计信息缓存大小的控制成为正式功能。通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 From eb9b19a3363f1f35eba5d99abc35d655423ab9c1 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Sat, 7 Dec 2024 15:59:14 +0800 Subject: [PATCH 03/10] Update release-7.4.0.md --- releases/release-7.4.0.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index 9be7620a30e6..759bd5c7541d 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -199,10 +199,9 @@ TiDB 版本：7.4.0 更多信息，请参考[用户文档](/system-variables.md#tidb_opt_enable_hash_join-从-v656v712-和-v740-版本开始引入)。 -* 控制统计信息缓存成为正式功能 [#46695](https://github.com/pingcap/tidb/issues/46695) @[hawkingrei](https://github.com/hawkingrei) +* 控制统计信息缓存成为正式功能 [#issue]() @[hawkingrei](https://github.com/hawkingrei) - TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL - 执行性能。自 v7.4.0，对统计信息缓存大小的控制成为正式功能。通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。自 v7.4.0，对统计信息缓存大小的控制成为正式功能。通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 From 8b3a8a7a969bba489a1e162ce0647142cbbd9aa8 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Sun, 8 Dec 2024 11:45:52 +0800 Subject: [PATCH 04/10] include issue# --- releases/release-7.4.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index 759bd5c7541d..1d434602ae54 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -199,7 +199,7 @@ TiDB 版本：7.4.0 更多信息，请参考[用户文档](/system-variables.md#tidb_opt_enable_hash_join-从-v656v712-和-v740-版本开始引入)。 -* 控制统计信息缓存成为正式功能 [#issue]() @[hawkingrei](https://github.com/hawkingrei) +* 控制统计信息缓存成为正式功能 [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。自 v7.4.0，对统计信息缓存大小的控制成为正式功能。通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 From 5d3677f23037cfcbdace794f42c377b81274c35d Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Mon, 9 Dec 2024 07:34:33 +0800 Subject: [PATCH 05/10] Update releases/release-7.4.0.md --- releases/release-7.4.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index 1d434602ae54..ca279d752be5 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -199,9 +199,9 @@ TiDB 版本：7.4.0 更多信息，请参考[用户文档](/system-variables.md#tidb_opt_enable_hash_join-从-v656v712-和-v740-版本开始引入)。 -* 控制统计信息缓存成为正式功能 [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) +* 控制统计信息缓存成为正式功能 (GA) [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) - TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。自 v7.4.0，对统计信息缓存大小的控制成为正式功能。通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，TiDB 能够控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。从 v7.4.0 开始，对统计信息缓存大小的控制成为正式功能 (GA)。你可以通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 From 9964d32f5108f8c86d704307edca36a7387eab30 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Mon, 9 Dec 2024 09:13:23 +0800 Subject: [PATCH 06/10] Update releases/release-7.4.0.md --- releases/release-7.4.0.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index ca279d752be5..e1bd15a287de 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -201,7 +201,9 @@ TiDB 版本：7.4.0 * 控制统计信息缓存成为正式功能 (GA) [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) - TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。从 v7.4.0 开始，对统计信息缓存大小的控制成为正式功能 (GA)。你可以通过设置 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + 从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，用于控制 TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + + 从 v7.4.0 开始，控制统计信息缓存大小的功能成为正式功能 (GA)。 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 From 520beaf3e1b9b1430545babd751531380013bc47 Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Mon, 9 Dec 2024 09:15:05 +0800 Subject: [PATCH 07/10] Update releases/release-7.4.0.md --- releases/release-7.4.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index e1bd15a287de..d8ee9537ab94 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -203,7 +203,7 @@ TiDB 版本：7.4.0 从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，用于控制 TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 - 从 v7.4.0 开始，控制统计信息缓存大小的功能成为正式功能 (GA)。 + 从 v7.4.0 开始，该功能成为正式功能 (GA)。 更多信息，请参考[用户文档](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)。 From 7915edf9184183490f2193cbd590df1dbe2063ec Mon Sep 17 00:00:00 2001 From: xixirangrang Date: Mon, 9 Dec 2024 10:09:49 +0800 Subject: [PATCH 08/10] Update releases/release-7.4.0.md --- releases/release-7.4.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index d8ee9537ab94..f6d59bb49d47 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -201,7 +201,7 @@ TiDB 版本：7.4.0 * 控制统计信息缓存成为正式功能 (GA) [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) - 从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，用于控制 TiDB 实例缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + TiDB 实例可以缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 从 v7.4.0 开始，该功能成为正式功能 (GA)。 From e8cce4d4aec21ff66a337b2b20b945675e7a3434 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Mon, 9 Dec 2024 10:57:39 +0800 Subject: [PATCH 09/10] Update wording --- releases/release-7.4.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/release-7.4.0.md b/releases/release-7.4.0.md index f6d59bb49d47..9d6361749521 100644 --- a/releases/release-7.4.0.md +++ b/releases/release-7.4.0.md @@ -201,7 +201,7 @@ TiDB 版本：7.4.0 * 控制统计信息缓存成为正式功能 (GA) [#45367](https://github.com/pingcap/tidb/issues/45367) @[hawkingrei](https://github.com/hawkingrei) - TiDB 实例可以缓存表的统计信息，加速执行计划的生成，提升 SQL 执行性能。从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例内存使用，提升稳定性。 + TiDB 实例可以缓存表的统计信息，以加速执行计划的生成，提升 SQL 执行性能。从 v6.1.0 开始，引入了系统变量 [`tidb_stats_cache_mem_quota`](/system-variables.md#tidb_stats_cache_mem_quota-从-v610-版本开始引入)，你可以通过设置该变量，控制统计信息缓存占用的内存上限。当统计信息缓存达到限额时，TiDB 会自动驱逐不活跃的缓存，从而控制实例的内存使用，提升稳定性。 从 v7.4.0 开始，该功能成为正式功能 (GA)。 From a1450f78b3c7ee9972bedc130fbe61c67f85bd5b Mon Sep 17 00:00:00 2001 From: lilin90 Date: Mon, 9 Dec 2024 11:17:40 +0800 Subject: [PATCH 10/10] Add the value range for the system variable --- system-variables.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/system-variables.md b/system-variables.md index d55b4265ce43..605d11e41c83 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4803,8 +4803,9 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 类型：整数型 - 单位：字节 -- 默认值：`0`，自动设置内部统计信息缓存使用内存的上限为总内存的一半。 -- 这个变量用于控制 TiDB 内部统计信息缓存使用内存的上限。 +- 默认值：`0`，表示自动设置统计信息缓存的内存使用上限为总内存的一半。 +- 范围：`[0, 1099511627776]` +- 这个变量用于控制 TiDB 统计信息缓存的内存使用上限。 ### `tidb_stats_load_sync_wait` 从 v5.4.0 版本开始引入