Skip to content

Commit 320457b

Browse files
enkileeqiancai
enkilee
and
qiancai
authored
Update SHOW STATUS docs (#16171)
* fix pr15363 * fix pr15363 * fix * fix * Update sql-statements/sql-statement-flush-status.md Co-authored-by: Grace Cai <qqzczy@126.com> * Update sql-statements/sql-statement-show-status.md Co-authored-by: Grace Cai <qqzczy@126.com> * Update sql-statements/sql-statement-show-status.md Co-authored-by: Grace Cai <qqzczy@126.com> * Update sql-statements/sql-statement-show-status.md Co-authored-by: Grace Cai <qqzczy@126.com> * Update status-variables.md Co-authored-by: Grace Cai <qqzczy@126.com> * Update sql-statements/sql-statement-show-status.md Co-authored-by: Grace Cai <qqzczy@126.com> --------- Co-authored-by: Grace Cai <qqzczy@126.com>
1 parent 4fa7522 commit 320457b

File tree

4 files changed

+143
-42
lines changed

4 files changed

+143
-42
lines changed

‎TOC.md

+1
Original file line numberDiff line numberDiff line change
@@ -653,6 +653,7 @@
653653
- [TiDB 分布式执行框架介绍](/tidb-distributed-execution-framework.md)
654654
- [TiDB 全局排序](/tidb-global-sort.md)
655655
- [系统变量](/system-variables.md)
656+
- [服务器状态变量](/status-variables.md)
656657
- 配置文件参数
657658
- [tidb-server](/tidb-configuration-file.md)
658659
- [tikv-server](/tikv-configuration-file.md)

‎sql-statements/sql-statement-flush-status.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -100,8 +100,9 @@ show status;
100100

101101
## MySQL 兼容性
102102

103-
* `FLUSH STATUS` 语句仅用于提供 MySQL 兼容性。
103+
* `FLUSH STATUS` 语句与 MySQL 兼容。
104104

105105
## 另请参阅
106106

107107
* [SHOW \[GLOBAL|SESSION\] STATUS](/sql-statements/sql-statement-show-status.md)
108+
* [服务器状态变量](/status-variables.md)

‎sql-statements/sql-statement-show-status.md

+48-41
Original file line numberDiff line numberDiff line change
@@ -6,68 +6,75 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-show-status/','/docs-cn/dev
66

77
# SHOW [GLOBAL|SESSION] STATUS
88

9-
`SHOW [GLOBAL|SESSION] STATUS` 语句用于提供 MySQL 兼容性，对 TiDB 没有作用。因为 TiDB 使用 Prometheus 和 Grafana 而非 `SHOW STATUS` 来进行集中度量收集。
9+
`SHOW [GLOBAL|SESSION] STATUS` 语句用于提供 MySQL 兼容性。对于大部分监控指标，TiDB 使用 Prometheus 和 Grafana 来集中收集，而不是使用 `SHOW STATUS`。
1010

11-
## 语法图
12-
13-
**ShowStmt:**
14-
15-
![ShowStmt](/media/sqlgram/ShowStmt.png)
16-
17-
**ShowTargetFilterable:**
18-
19-
![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png)
11+
该语句输出中各变量的详细介绍，请参考[服务器状态变量](/status-variables.md)。
2012

21-
**GlobalScope:**
13+
## 语法图
2214

23-
![GlobalScope](/media/sqlgram/GlobalScope.png)
15+
```ebnf+diagram
16+
ShowStatusStmt ::=
17+
'SHOW' Scope? 'STATUS' ShowLikeOrWhere?
18+
Scope ::=
19+
( 'GLOBAL' | 'SESSION' )
20+
ShowLikeOrWhere ::=
21+
"LIKE" SimpleExpr
22+
| "WHERE" Expression
23+
```
2424

2525
## 示例
2626

27-
{{< copyable "sql" >}}
28-
2927
```sql
30-
show status;
28+
SHOW SESSION STATUS;
3129
```
3230

3331
```
34-
+--------------------+--------------------------------------+
35-
| Variable_name | Value |
36-
+--------------------+--------------------------------------+
37-
| Ssl_cipher_list | |
38-
| server_id | 93e2e07d-6bb4-4a1b-90b7-e035fae154fe |
39-
| ddl_schema_version | 141 |
40-
| Ssl_verify_mode | 0 |
41-
| Ssl_version | |
42-
| Ssl_cipher | |
43-
+--------------------+--------------------------------------+
44-
6 rows in set (0.01 sec)
32+
+-------------------------------+--------------------------------------+
33+
| Variable_name | Value |
34+
+-------------------------------+--------------------------------------+
35+
| Compression | OFF |
36+
| Compression_algorithm | |
37+
| Compression_level | 0 |
38+
| Ssl_cipher | |
39+
| Ssl_cipher_list | |
40+
| Ssl_server_not_after | |
41+
| Ssl_server_not_before | |
42+
| Ssl_verify_mode | 0 |
43+
| Ssl_version | |
44+
| Uptime | 1409 |
45+
| ddl_schema_version | 116 |
46+
| last_plan_binding_update_time | 0000-00-00 00:00:00 |
47+
| server_id | 61160e73-ab80-40ff-8f33-27d55d475fd1 |
48+
+-------------------------------+--------------------------------------+
49+
13 rows in set (0.00 sec)
4550
```
4651

47-
{{< copyable "sql" >}}
48-
4952
```sql
50-
show global status;
53+
SHOW GLOBAL STATUS;
5154
```
5255

5356
```
54-
+--------------------+--------------------------------------+
55-
| Variable_name | Value |
56-
+--------------------+--------------------------------------+
57-
| Ssl_cipher | |
58-
| Ssl_cipher_list | |
59-
| Ssl_verify_mode | 0 |
60-
| Ssl_version | |
61-
| server_id | 93e2e07d-6bb4-4a1b-90b7-e035fae154fe |
62-
| ddl_schema_version | 141 |
63-
+--------------------+--------------------------------------+
64-
6 rows in set (0.00 sec)
57+
+-----------------------+--------------------------------------+
58+
| Variable_name | Value |
59+
+-----------------------+--------------------------------------+
60+
| Ssl_cipher | |
61+
| Ssl_cipher_list | |
62+
| Ssl_server_not_after | |
63+
| Ssl_server_not_before | |
64+
| Ssl_verify_mode | 0 |
65+
| Ssl_version | |
66+
| Uptime | 1413 |
67+
| ddl_schema_version | 116 |
68+
| server_id | 61160e73-ab80-40ff-8f33-27d55d475fd1 |
69+
+-----------------------+--------------------------------------+
70+
9 rows in set (0.00 sec)
6571
```
6672

6773
## MySQL 兼容性
6874

69-
`SHOW [GLOBAL|SESSION] STATUS` 语句仅用于提供 MySQL 兼容性。
75+
`SHOW [GLOBAL|SESSION] STATUS` 语句与 MySQL 兼容。
7076

7177
## 另请参阅
7278

7379
* [FLUSH STATUS](/sql-statements/sql-statement-flush-status.md)
80+
* [服务器状态变量](/status-variables.md)

‎status-variables.md

+92
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
title: 服务器状态变量
3+
summary: 使用状态变量查看系统和会话状态
4+
---
5+
6+
# 服务器状态变量
7+
8+
服务器状态变量提供有关服务器全局状态和 TiDB 中当前会话状态的信息。大多数变量与 MySQL 兼容。
9+
10+
你可以使用 [SHOW GLOBAL STATUS](/sql-statements/sql-statement-show-status.md) 命令查看全局状态，使用 [SHOW SESSION STATUS](/sql-statements/sql-statement-show-status.md) 命令查看当前会话状态。
11+
12+
此外，[FLUSH STATUS](/sql-statements/sql-statement-flush-status.md) 命令与 MySQL 兼容。
13+
14+
## 变量参考
15+
16+
### Compression
17+
18+
- 作用域：SESSION
19+
- 类型：布尔值
20+
- MySQL 是否使用压缩协议。
21+
22+
### Compression_algorithm
23+
24+
- 作用域：SESSION
25+
- 类型：字符串
26+
- MySQL 协议使用的压缩算法。
27+
28+
### Compression_level
29+
30+
- 作用域：SESSION
31+
- 类型：整数型
32+
- MySQL 协议使用的压缩等级。
33+
34+
### Ssl_cipher
35+
36+
- 作用域：SESSION | GLOBAL
37+
- 类型：字符串
38+
- 正在使用的 TLS 加密套件.
39+
40+
### Ssl_cipher_list
41+
42+
- 作用域：SESSION | GLOBAL
43+
- 类型：字符串
44+
- 服务器支持的 TLS 加密套件列表.
45+
46+
### Ssl_server_not_after
47+
48+
- 作用域：SESSION | GLOBAL
49+
- 类型：日期
50+
- 服务器用于 TLS 连接的 X.509 证书的过期时间。
51+
52+
### Ssl_server_not_before
53+
54+
- 作用域：SESSION | GLOBAL
55+
- 类型：字符串
56+
- 服务器用于 TLS 连接的 X.509 证书的开始时间。
57+
58+
### Ssl_verify_mode
59+
60+
- 作用域：SESSION | GLOBAL
61+
- 类型：整数型
62+
- TLS 验证模式掩码。
63+
64+
### Ssl_version
65+
66+
- 作用域：SESSION | GLOBAL
67+
- 类型：字符串
68+
- TLS 协议使用的版本。
69+
70+
### Uptime
71+
72+
- 作用域：SESSION | GLOBAL
73+
- 类型：整数型
74+
- 服务器正常运行时间（秒）。
75+
76+
### ddl_schema_version
77+
78+
- 作用域：SESSION | GLOBAL
79+
- 类型：整数型
80+
- DDL schema 使用的版本。
81+
82+
### last_plan_binding_update_time <span class="version-mark">New in v5.2.0</span>
83+
84+
- 作用域：SESSION
85+
- 类型：时间戳
86+
- 最后一次计划绑定更新的日期时间。
87+
88+
### server_id
89+
90+
- 作用域：SESSION | GLOBAL
91+
- 类型：字符串
92+
- 服务器的通用唯一识别码 (UUID)。

0 commit comments

Comments
 (0)