From 4297dff98b5e6aa57a094fa31aa48ef96f0ff2d8 Mon Sep 17 00:00:00 2001
From: AilinKid <314806019@qq.com>
Date: Tue, 17 Jun 2025 15:51:37 +0800
Subject: [PATCH] .

Signed-off-by: AilinKid <314806019@qq.com>
---
 tidb-configuration-file.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md
index 327b4ad73ba5..a8cc45c11b7d 100644
--- a/tidb-configuration-file.md
+++ b/tidb-configuration-file.md
@@ -906,12 +906,20 @@ TiDB 服务状态相关配置。
 
 ### `in-mem-slow-query-topn-num` <span class="version-mark">从 v7.3.0 版本开始引入</span>
 
-+ 缓存在内存中的最慢的 slow query 个数。
+> **内存查询优先**: 当查询 `INFORMATION_SCHEMA.SLOW_QUERY` 表时候，TiDB 首先检查内存堆上缓存的慢查询，不行然后再去解析节点上的慢查询日志文件，`in-mem-slow-query-topn-num` 提供了指向内存堆中最慢的 N 个慢查询的堆内存缓存数量，该内存堆可以用来提供最慢慢查询的快速内存访问，从而避免解析日志文件。
+
+> **内存消耗**: 该参数用于在快速检索最慢 N 个特征性慢查询的能力与慢查询堆内存占用控制之间实现平衡。设置的太高会导致内存堆在收集慢查询上消耗过多内存，设置太小可能会导致无法提供足够有效的最慢历史慢查询上下文，从而导致需要解析全量的日志文件来获取完整的慢查询信息。
+
++ 每个 tidb 实例缓存在内存堆中的最慢的 slow query 个数。
 + 默认值：30
 
 ### `in-mem-slow-query-recent-num` <span class="version-mark">从 v7.3.0 版本开始引入</span>
 
-+ 缓存在内存中的最近使用的 slow query 个数。
+> **内存查询优先**: 当查询 `INFORMATION_SCHEMA.SLOW_QUERY` 表时候，TiDB 首先检查内存堆上缓存的慢查询，不行然后再去解析节点上的慢查询日志文件，`in-mem-slow-query-recent-num` 提供了指向内存堆中最近的 N 个慢查询的堆内存缓存数量，该内存堆可以用来提供最近慢查询的快速内存访问，从而避免解析日志文件。
+
+> **内存消耗**: 该参数用于在快速检索最近 N 个特征性慢查询的能力与慢查询堆内存占用控制之间实现平衡。设置的太高会导致内存堆在收集慢查询上消耗过多内存，设置太小可能会导致无法提供足够有效的最近历史慢查询上下文，从而导致需要解析全量的日志文件来获取完整的慢查询信息。
+
++ 每个 tidb 实例缓存在内存堆中的最近使用的 slow query 个数。
 + 默认值：500
 
 ### `tidb_expensive_query_time_threshold`