From 180cc507aacb7d9887f9fbe2e4b112b90c6fb492 Mon Sep 17 00:00:00 2001
From: wjHuang <huangwenjun1997@gmail.com>
Date: Fri, 3 Nov 2023 16:44:10 +0800
Subject: [PATCH] mysql-schema: add description for MDL related table (#15303)

---
 mysql-schema.md                               |  5 ++++
 sql-statements/sql-statement-admin.md         | 25 +++++++++++++++++++
 .../sql-statement-show-table-next-rowid.md    |  6 ++---
 3 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/mysql-schema.md b/mysql-schema.md
index 0a2e45818f55..6a852fc2f2bb 100644
--- a/mysql-schema.md
+++ b/mysql-schema.md
@@ -75,6 +75,11 @@ aliases: ['/docs-cn/dev/system-tables/system-table-overview/','/docs-cn/dev/refe
 * `tidb_runaway_watch`：Runaway Queries 的监控列表 (Watch List)
 * `tidb_runaway_watch_done`：被删除或者过期的 Runaway Queries 的监控列表
 
+## 元数据锁相关系统表
+
+* `tidb_mdl_view`：元数据锁的视图，可以用于查看当前阻塞的 DDL 的相关信息
+* `tidb_mdl_info`：TiDB 内部用于同步各节点的元数据锁的相关信息
+
 ## 其它系统表
 
 * `GLOBAL_VARIABLES` 全局系统变量表
diff --git a/sql-statements/sql-statement-admin.md b/sql-statements/sql-statement-admin.md
index 045f3db793ea..25aedc59c188 100644
--- a/sql-statements/sql-statement-admin.md
+++ b/sql-statements/sql-statement-admin.md
@@ -11,6 +11,7 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-admin/','/docs-cn/dev/refer
 - [`ADMIN PLUGIN`](#admin-plugin-语句)
 - [`ADMIN ... BINDINGS`](#admin--bindings-语句)
 - [`ADMIN REPAIR TABLE`](#admin-repair-table-语句)
+- [`ADMIN SHOW NEXT_ROW_ID`](#admin-show-next_row_id-语句)
 - [`ADMIN SHOW SLOW`](#admin-show-slow-语句)
 
 ## ADMIN 与 DDL 相关的扩展语句
@@ -105,6 +106,14 @@ ADMIN REPAIR TABLE tbl_name CREATE TABLE STATEMENT;
 
 `ADMIN REPAIR TABLE tbl_name CREATE TABLE STATEMENT` 用于在极端情况下，对存储层中的表的元信息进行非可信的覆盖。“非可信”是指需要人为保证原表的元信息可以完全由 `CREATE TABLE STATEMENT` 提供。该语句需要打开配置文件项中的 [`repair-mode`](/tidb-configuration-file.md#repair-mode) 开关，并且需要确保所修复的表名在 [`repair-table-list`](/tidb-configuration-file.md#repair-table-list) 名单中。
 
+## `ADMIN SHOW NEXT_ROW_ID` 语句
+
+```sql
+ADMIN SHOW t NEXT_ROW_ID;
+```
+
+以上语句可以查看表中某些特殊列的详情。输出结果与 [SHOW TABLE NEXT_ROW_ID](/sql-statements/sql-statement-show-table-next-rowid.md) 相同。
+
 ## `ADMIN SHOW SLOW` 语句
 
 {{< copyable "sql" >}}
@@ -177,6 +186,22 @@ ADMIN SHOW DDL JOBS 5;
 +--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
 ```
 
+执行以下命令，查看表中某些特殊列的详情。输出结果与 [SHOW TABLE NEXT_ROW_ID](/sql-statements/sql-statement-show-table-next-rowid.md) 相同。
+
+```sql
+ADMIN SHOW t NEXT_ROW_ID;
+```
+
+```sql
++---------+------------+-------------+--------------------+----------------+
+| DB_NAME | TABLE_NAME | COLUMN_NAME | NEXT_GLOBAL_ROW_ID | ID_TYPE        |
++---------+------------+-------------+--------------------+----------------+
+| test    | t          | _tidb_rowid |                101 | _TIDB_ROWID    |
+| test    | t          | _tidb_rowid |                  1 | AUTO_INCREMENT |
++---------+------------+-------------+--------------------+----------------+
+2 rows in set (0.01 sec)
+```
+
 执行以下命令，可查看 test 数据库中未执行完成的 DDL 任务，包括正在执行中以及最近 5 条已经执行完但是执行失败的 DDL 任务。
 
 {{< copyable "sql" >}}
diff --git a/sql-statements/sql-statement-show-table-next-rowid.md b/sql-statements/sql-statement-show-table-next-rowid.md
index a309deef3f2e..117e9b89d5f3 100644
--- a/sql-statements/sql-statement-show-table-next-rowid.md
+++ b/sql-statements/sql-statement-show-table-next-rowid.md
@@ -6,7 +6,7 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-show-table-next-rowid/']
 
 # SHOW TABLE NEXT_ROW_ID
 
-`SHOW TABLE NEXT_ROW_ID` 语句用于显示用表中某些特殊列的详情，主要包含以下几种类型：
+`SHOW TABLE NEXT_ROW_ID` 语句用于显示用户表中某些特殊列的详情，主要包含以下几种类型：
 
 * TiDB 创建的 `AUTO_INCREMENT` 类型列，即 `_tidb_rowid` 列
 * 用户创建的 `AUTO_INCREMENT` 类型列
@@ -25,7 +25,7 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-show-table-next-rowid/']
 
 ## 示例
 
-对于新建的表，由于没有任何的 Row ID 分配，NEXT_GLOBAL_ROW_ID 值为 1
+下面示例中，对于新建的表，由于没有任何的 Row ID 分配，NEXT_GLOBAL_ROW_ID 值为 `1`。
 
 {{< copyable "sql" >}}
 
@@ -44,7 +44,7 @@ show table t next_row_id;
 1 row in set (0.00 sec)
 ```
 
-表中写入了数据，负责写入的 TiDB Server 一次性向存储层请求了 30000 个 ID 缓存起来，NEXT_GLOBAL_ROW_ID 值为 30001
+下面示例中，表中写入了数据，负责写入的 TiDB Server 一次性向存储层请求了 30000 个 ID 缓存起来，NEXT_GLOBAL_ROW_ID 值为 `30001`。
 
 ```sql
 insert into t values (), (), ();