add experimental warning for lock/unlock stats (#15151) (#15153)

pingcap · Oct 9, 2023 · 17b6113 · 17b6113
1 parent a8f02dd
commit 17b6113
Show file tree

Hide file tree

Showing 4 changed files with 17 additions and 1 deletion.
diff --git a/sql-statements/sql-statement-lock-stats.md b/sql-statements/sql-statement-lock-stats.md
@@ -5,7 +5,11 @@ summary: TiDB 数据库中 LOCK STATS 的使用概况。
 
 # LOCK STATS
 
-`LOCK STATS` 语句用于锁定表或分区的统计信息，使得在锁定期间，TiDB 不会自动更新统计信息。具体行为请参见[锁定统计信息的行为说明](/statistics.md#锁定统计信息的行为说明)
+`LOCK STATS` 语句用于锁定表或分区的统计信息，使得在锁定期间，TiDB 不会自动更新统计信息。具体行为请参见[锁定统计信息的行为说明](/statistics.md#锁定统计信息的行为说明)。
+
+> **警告：**
+>
+> 锁定统计信息目前为实验特性，不建议在生产环境中使用。
 
 ## 语法图
 

diff --git a/sql-statements/sql-statement-show-stats-locked.md b/sql-statements/sql-statement-show-stats-locked.md
@@ -7,6 +7,10 @@ summary: TiDB 数据库中 SHOW STATS_LOCKED 的使用概况。
 
 `SHOW STATS_LOCKED` 语句显示统计信息被锁定的表。
 
+> **警告：**
+>
+> 锁定统计信息目前为实验特性，不建议在生产环境中使用。
+
 ## 语法图
 
 ```ebnf+diagram

diff --git a/sql-statements/sql-statement-unlock-stats.md b/sql-statements/sql-statement-unlock-stats.md
@@ -7,6 +7,10 @@ summary: TiDB 数据库中 UNLOCK STATS 的使用概况。
 
 `UNLOCK STATS` 语句用于解锁统计信息被锁定的表。
 
+> **警告：**
+>
+> 锁定统计信息目前为实验特性，不建议在生产环境中使用。
+
 ## 语法图
 
 ```ebnf+diagram

diff --git a/statistics.md b/statistics.md
@@ -756,6 +756,10 @@ LOAD STATS 'file_name';
 
 ## 锁定统计信息
 
+> **警告：**
+>
+> 锁定统计信息目前为实验特性，不建议在生产环境中使用。
+
 从 v6.5.0 开始，TiDB 引入了锁定统计信息的特性。当一张表或一个分区的统计信息被锁定以后，该表或分区的统计信息将无法被修改，也无法对该表进行 `ANALYZE` 操作。用例如下：
 
 创建表 `t`，插入一些数据，在未锁定表 `t` 的统计信息的情况下成功执行 `ANALYZE` 语句。