Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update SHOW STATUS docs #16171

Merged
merged 10 commits into from
Jan 30, 2024
1 change: 1 addition & 0 deletions TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -645,6 +645,7 @@
- [TiDB 分布式执行框架介绍](/tidb-distributed-execution-framework.md)
- [TiDB 全局排序](/tidb-global-sort.md)
- [系统变量](/system-variables.md)
- [服务器状态变量](/status-variables.md)
- 配置文件参数
- [tidb-server](/tidb-configuration-file.md)
- [tikv-server](/tikv-configuration-file.md)
Expand Down
3 changes: 2 additions & 1 deletion sql-statements/sql-statement-flush-status.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,8 +100,9 @@ show status;

## MySQL 兼容性

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

## 另请参阅

* [SHOW \[GLOBAL|SESSION\] STATUS](/sql-statements/sql-statement-show-status.md)
* [服务器状态变量](/status-variables.md)
85 changes: 48 additions & 37 deletions sql-statements/sql-statement-show-status.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,68 +6,79 @@ aliases: ['/docs-cn/dev/sql-statements/sql-statement-show-status/','/docs-cn/dev

# SHOW [GLOBAL|SESSION] STATUS

`SHOW [GLOBAL|SESSION] STATUS` 语句用于提供 MySQL 兼容性,TiDB 没有作用。因为 TiDB 使用 Prometheus 和 Grafana 而非 `SHOW STATUS` 来进行集中度量收集
`SHOW [GLOBAL|SESSION] STATUS` 语句用于提供 MySQL 兼容性,TiDB 使用 Prometheus 和 Grafana 进行集中度量收集, 而不是使用 `SHOW STATUS` 进行各种度量收集

## 语法图

**ShowStmt:**

![ShowStmt](/media/sqlgram/ShowStmt.png)

**ShowTargetFilterable:**
详细介绍请参考 [服务器状态变量](/status-variables.md)

![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png)

**GlobalScope:**
## 语法图

![GlobalScope](/media/sqlgram/GlobalScope.png)
```ebnf+diagram
ShowStatusStmt ::=
'SHOW' Scope? 'STATUS' ShowLikeOrWhere?
Scope ::=
( 'GLOBAL' | 'SESSION' )
ShowLikeOrWhere ::=
"LIKE" SimpleExpr
| "WHERE" Expression
```

## 示例

{{< copyable "sql" >}}

```sql
show status;
SHOW SESSION STATUS;
```

```
+--------------------+--------------------------------------+
| Variable_name | Value |
+--------------------+--------------------------------------+
| Ssl_cipher_list | |
| server_id | 93e2e07d-6bb4-4a1b-90b7-e035fae154fe |
| ddl_schema_version | 141 |
| Ssl_verify_mode | 0 |
| Ssl_version | |
| Ssl_cipher | |
+--------------------+--------------------------------------+
6 rows in set (0.01 sec)
+-------------------------------+--------------------------------------+
| Variable_name | Value |
+-------------------------------+--------------------------------------+
| Compression | OFF |
| Compression_algorithm | |
| Compression_level | 0 |
| Ssl_cipher | |
| Ssl_cipher_list | |
| Ssl_server_not_after | |
| Ssl_server_not_before | |
| Ssl_verify_mode | 0 |
| Ssl_version | |
| Uptime | 1409 |
| ddl_schema_version | 116 |
| last_plan_binding_update_time | 0000-00-00 00:00:00 |
| server_id | 61160e73-ab80-40ff-8f33-27d55d475fd1 |
+-------------------------------+--------------------------------------+
13 rows in set (0.00 sec)
```

{{< copyable "sql" >}}

```sql
show global status;
SHOW GLOBAL STATUS;
```

```
+--------------------+--------------------------------------+
| Variable_name | Value |
+--------------------+--------------------------------------+
| Ssl_cipher | |
| Ssl_cipher_list | |
| Ssl_verify_mode | 0 |
| Ssl_version | |
| server_id | 93e2e07d-6bb4-4a1b-90b7-e035fae154fe |
| ddl_schema_version | 141 |
+--------------------+--------------------------------------+
6 rows in set (0.00 sec)
+-----------------------+--------------------------------------+
| Variable_name | Value |
+-----------------------+--------------------------------------+
| Ssl_cipher | |
| Ssl_cipher_list | |
| Ssl_server_not_after | |
| Ssl_server_not_before | |
| Ssl_verify_mode | 0 |
| Ssl_version | |
| Uptime | 1413 |
| ddl_schema_version | 116 |
| server_id | 61160e73-ab80-40ff-8f33-27d55d475fd1 |
+-----------------------+--------------------------------------+
9 rows in set (0.00 sec)
```

## MySQL 兼容性

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

## 另请参阅

* [FLUSH STATUS](/sql-statements/sql-statement-flush-status.md)
* [服务器状态变量](/status-variables.md)
92 changes: 92 additions & 0 deletions status-variables.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
---
title: 服务器状态变量
summary: 使用状态变量查看系统和会话状态
---

# 服务器状态变量

服务器状态变量提供有关服务器全局状态和 TiDB 中当前会话状态的信息。大多数变量与 MySQL 兼容。

你可以使用 [SHOW GLOBAL STATUS](/sql-statements/sql-statement-show-status.md) 命令检索全局状态, 当前会话状态可以使用 [SHOW SESSION STATUS](/sql-statements/sql-statement-show-status.md) 命令。

此外, [FLUSH STATUS](/sql-statements/sql-statement-flush-status.md) 命令与 MySQL 兼容。

## 系统变量

### Compression

- 作用域: SESSION
- 类型: 字符串
- MySQL 是否使用压缩协议。

### Compression_algorithm

- 作用域: SESSION
- 类型: 字符串
- MySQL 压缩协议使用的算法。

### Compression_level

- 作用域: SESSION
- 类型: 整数型
- MySQL 压缩协议使用的等级。

### Ssl_cipher

- 作用域: SESSION | GLOBAL
- 类型: 字符串
- 正在使用的 TLS 加密套件.

### Ssl_cipher_list

- 作用域: SESSION | GLOBAL
- 类型: 字符串
- 服务器支持的 TLS 加密套件列表.

### Ssl_server_not_after

- 作用域: SESSION | GLOBAL
- 类型: 时间
- c

### Ssl_server_not_before

- 作用域: SESSION | GLOBAL
- 类型: 字符串
- 服务器用于 TLS 连接的 X.509 证书的过期时间。

### Ssl_verify_mode

- 作用域: SESSION | GLOBAL
- 类型: 整数型
- TLS 验证模式掩码。

### Ssl_version

- 作用域: SESSION | GLOBAL
- 类型: 字符串
- TLS 协议使用的版本。

### Uptime

- 作用域: SESSION | GLOBAL
- 类型: 整数型
- 服务器正常运行时间(秒)。

### ddl_schema_version

- 作用域: SESSION | GLOBAL
- 类型: 整数型
- DDL schema 使用的版本。

### last_plan_binding_update_time <span class="version-mark">New in v5.2.0</span>

- 作用域: SESSION
- 类型: 时间戳
- 上次计划更新的日期时间。

### server_id

- 作用域: SESSION | GLOBAL
- 类型: 字符串
- 服务器的通用唯一识别码(UUID)。