ebnf: show bindings, show databases, show privileges, show config (#1…

…7079) (#17142)
pingcap · Apr 18, 2024 · b56d762 · b56d762
1 parent 558a493
commit b56d762
Show file tree

Hide file tree

Showing 4 changed files with 28 additions and 51 deletions.
diff --git a/sql-statements/sql-statement-show-bindings.md b/sql-statements/sql-statement-show-bindings.md
@@ -9,30 +9,17 @@ summary: TiDB 数据库中 SHOW [GLOBAL|SESSION] BINDINGS 的使用概况。
 
 ## 语法图
 
-**ShowStmt:**
+```ebnf+diagram
+ShowBindingsStmt ::=
+    "SHOW" ("GLOBAL" | "SESSION")? "BINDINGS" ShowLikeOrWhere?
 
-![ShowStmt](/media/sqlgram/ShowStmt.png)
-
-**ShowTargetFilterable:**
-
-![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png)
-
-**GlobalScope:**
-
-![GlobalScope](/media/sqlgram/GlobalScope.png)
-
-**ShowLikeOrWhereOpt**
-
-![ShowLikeOrWhereOpt](/media/sqlgram/ShowLikeOrWhereOpt.png)
+ShowLikeOrWhere ::=
+    "LIKE" SimpleExpr
+|   "WHERE" Expression
+```
 
 ## 语法说明
 
-{{< copyable "sql" >}}
-
-```sql
-SHOW [GLOBAL | SESSION] BINDINGS [ShowLikeOrWhereOpt];
-```
-
 该语句会输出 GLOBAL 或者 SESSION 作用域内的执行计划绑定，在不指定作用域时默认作用域为 SESSION。目前 `SHOW BINDINGS` 会输出 8 列，具体如下：
 
 | 列名 | 说明            |
@@ -49,8 +36,6 @@ SHOW [GLOBAL | SESSION] BINDINGS [ShowLikeOrWhereOpt];
 
 ## 示例
 
-{{< copyable "sql" >}}
-
 ```sql
 CREATE TABLE t1 (
     id INT NOT NULL PRIMARY KEY auto_increment,

diff --git a/sql-statements/sql-statement-show-config.md b/sql-statements/sql-statement-show-config.md
@@ -9,20 +9,19 @@ summary: TiDB 数据库中 SHOW CONFIG 的使用概况。
 
 ## 语法图
 
-**ShowStmt:**
+```ebnf+diagram
+ShowConfigStmt ::=
+    "SHOW" "CONFIG" ShowLikeOrWhere?
 
-![ShowStmt](/media/sqlgram/ShowStmt.png)
-
-**ShowTargetFilterable:**
-
-![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png)
+ShowLikeOrWhere ::=
+    "LIKE" SimpleExpr
+|   "WHERE" Expression
+```
 
 ## 示例
 
 显示所有配置：
 
-{{< copyable "sql" >}}
-
 ```sql
 SHOW CONFIG;
 ```
@@ -40,8 +39,6 @@ SHOW CONFIG;
 
 显示 `type` 是 `tidb` 的配置：
 
-{{< copyable "sql" >}}
-
 ```sql
 SHOW CONFIG WHERE type = 'tidb' AND name = 'advertise-address';
 ```
@@ -57,8 +54,6 @@ SHOW CONFIG WHERE type = 'tidb' AND name = 'advertise-address';
 
 也可以用 `LIKE` 子句来显示 `type` 是 `tidb` 的配置：
 
-{{< copyable "sql" >}}
-
 ```sql
 SHOW CONFIG LIKE 'tidb';
 ```

diff --git a/sql-statements/sql-statement-show-databases.md b/sql-statements/sql-statement-show-databases.md
@@ -13,16 +13,17 @@ summary: TiDB 数据库中 SHOW DATABASES 的使用概况。
 
 **ShowDatabasesStmt:**
 
-![ShowDatabasesStmt](/media/sqlgram/ShowDatabasesStmt.png)
+```ebnf+diagram
+ShowDatabasesStmt ::=
+    "SHOW" "DATABASES" ShowLikeOrWhere?
 
-**ShowLikeOrWhereOpt:**
-
-![ShowLikeOrWhereOpt](/media/sqlgram/ShowLikeOrWhereOpt.png)
+ShowLikeOrWhere ::=
+    "LIKE" SimpleExpr
+|   "WHERE" Expression
+```
 
 ## 示例
 
-{{< copyable "sql" >}}
-
 ```sql
 SHOW DATABASES;
 ```
@@ -39,8 +40,6 @@ SHOW DATABASES;
 4 rows in set (0.00 sec)
 ```
 
-{{< copyable "sql" >}}
-
 ```sql
 CREATE DATABASE mynewdb;
 ```
@@ -49,8 +48,6 @@ CREATE DATABASE mynewdb;
 Query OK, 0 rows affected (0.10 sec)
 ```
 
-{{< copyable "sql" >}}
-
 ```sql
 SHOW DATABASES;
 ```
@@ -77,3 +74,4 @@ SHOW DATABASES;
 * [SHOW SCHEMAS](/sql-statements/sql-statement-show-schemas.md)
 * [DROP DATABASE](/sql-statements/sql-statement-drop-database.md)
 * [CREATE DATABASE](/sql-statements/sql-statement-create-database.md)
+* [`INFORMATION_SCHEMA.SCHEMATA`](/information-schema/information-schema-schemata.md)
diff --git a/sql-statements/sql-statement-show-privileges.md b/sql-statements/sql-statement-show-privileges.md
@@ -9,20 +9,18 @@ summary: TiDB 数据库中 SHOW PRIVILEGES 的使用概况。
 
 ## 语法图
 
-**ShowStmt:**
-
-![ShowStmt](/media/sqlgram/ShowStmt.png)
+```ebnf+diagram
+ShowPrivilegesStmt ::=
+    "SHOW" "PRIVILEGES"
+```
 
 ## 示例
 
-{{< copyable "sql" >}}
-
 ```sql
-show privileges;
+SHOW PRIVILEGES;
 ```
 
 ```sql
-mysql> show privileges;
 +---------------------------------+---------------------------------------+-------------------------------------------------------+
 | Privilege                       | Context                               | Comment                                               |
 +---------------------------------+---------------------------------------+-------------------------------------------------------+
@@ -86,4 +84,5 @@ mysql> show privileges;
 ## 另请参阅
 
 * [SHOW GRANTS](/sql-statements/sql-statement-show-grants.md)
+* [权限管理](/privilege-management.md)
 * [`GRANT <privileges>`](/sql-statements/sql-statement-grant-privileges.md)