From 8260092881c27a6fb8e3c5e96ffb37fd1f1e9b33 Mon Sep 17 00:00:00 2001
From: Aolin <aolin.zhang@pingcap.com>
Date: Tue, 18 Nov 2025 10:14:27 +0800
Subject: [PATCH] docs: deprecate tidb_enable_auto_analyze_priority_queue

---
 system-variables.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/system-variables.md b/system-variables.md
index 394fc7589e5c..2bce97f0e7ce 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -1755,6 +1755,10 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
 
 ### `tidb_enable_auto_analyze_priority_queue` <span class="version-mark">从 v8.0.0 版本开始引入</span>
 
+> **警告：**
+>
+> 从 v9.0.0 版本开始，该变量被废弃。TiDB 始终开启优先队列来调度自动收集统计信息的任务。
+
 - 作用域：GLOBAL
 - 是否持久化到集群：是
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否