Skip to content

Commit 5593155

Browse files
author
github-actions
committed
update MD by dispatch event pingcap/docs i18n-zh-release-8.5
1 parent 6398606 commit 5593155

File tree

43 files changed

+1675
-1469
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+1675
-1469
lines changed

markdown-pages/zh/tidbcloud/master/information-schema/information-schema-processlist.md

Lines changed: 61 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -5,35 +5,35 @@ summary: 了解 `PROCESSLIST` information_schema 表。
55

66
# PROCESSLIST
77

8-
`PROCESSLIST`就像 [`SHOW PROCESSLIST`](/sql-statements/sql-statement-show-processlist.md) 一样,用于查看正在处理的请求。
8+
`PROCESSLIST` [`SHOW PROCESSLIST`](/sql-statements/sql-statement-show-processlist.md) 类似,用于查看正在处理的请求。
99

10-
`PROCESSLIST` 表具有在 `SHOW PROCESSLIST` 中不存在的附加列
10+
`PROCESSLIST` 表包含了一些 `SHOW PROCESSLIST` 中没有的额外列
1111

1212
<CustomContent platform="tidb">
1313

14-
* 一个 `DIGEST` 列,用于显示 SQL 语句的摘要。
15-
* 一个 `MEM` 列,用于显示请求所使用的内存,单位为字节。
16-
* 一个 `DISK` 列,用于显示磁盘使用量,单位为字节。
17-
* 一个 `TxnStart` 列,用于显示事务的开始时间。
18-
* 一个 `RESOURCE_GROUP` 列,用于显示资源组名称。
19-
* 一个 `SESSION_ALIAS` 列,用于显示当前会话的别名。
20-
* 一个 `ROWS_AFFECTED` 列,用于显示当前语句影响的行数。
21-
* 一个 `TIDB_CPU` 列,用于显示语句消耗的 TiDB 服务器 CPU 时间(纳秒)。只有在启用 [Top SQL](/dashboard/top-sql.md) 功能时,此列才有意义,否则值为 `0`
22-
* 一个 `TIKV_CPU` 列,用于显示语句消耗的 TiKV 服务器 CPU 时间(纳秒)
14+
* `DIGEST` 列,用于显示 SQL 语句的摘要。
15+
* `MEM` 列,用于显示当前请求已使用的内存,单位为字节。
16+
* `DISK` 列,用于显示磁盘使用量,单位为字节。
17+
* `TxnStart` 列,用于显示事务的开始时间。
18+
* `RESOURCE_GROUP` 列,用于显示资源组名称。
19+
* `SESSION_ALIAS` 列,用于显示当前会话的别名。
20+
* `ROWS_AFFECTED` 列,用于显示当前语句影响的行数。
21+
* `TIDB_CPU` 列,用于显示该语句在 TiDB 服务器上消耗的 CPU 时间,单位为纳秒。只有在启用 [Top SQL](/dashboard/top-sql.md) 功能时,该列才有意义,否则值为 `0`
22+
* `TIKV_CPU` 列,用于显示该语句在 TiKV 服务器上消耗的 CPU 时间,单位为纳秒
2323

2424
</CustomContent>
2525

2626
<CustomContent platform="tidb-cloud">
2727

28-
* 一个 `DIGEST` 列,用于显示 SQL 语句的摘要。
29-
* 一个 `MEM` 列,用于显示请求所使用的内存,单位为字节。
30-
* 一个 `DISK` 列,用于显示磁盘使用量,单位为字节。
31-
* 一个 `TxnStart` 列,用于显示事务的开始时间。
32-
* 一个 `RESOURCE_GROUP` 列,用于显示资源组名称。
33-
* 一个 `SESSION_ALIAS` 列,用于显示当前会话的别名。
34-
* 一个 `ROWS_AFFECTED` 列,用于显示当前语句影响的行数。
35-
* 一个 `TIDB_CPU` 列,用于显示语句消耗的 TiDB 服务器 CPU 时间(纳秒)。只有在启用 [Top SQL](https://docs.pingcap.com/tidb/stable/top-sql) 功能时,此列才有意义,否则值为 `0`
36-
* 一个 `TIKV_CPU` 列,用于显示语句消耗的 TiKV 服务器 CPU 时间(纳秒)
28+
* `DIGEST` 列,用于显示 SQL 语句的摘要。
29+
* `MEM` 列,用于显示当前请求已使用的内存,单位为字节。
30+
* `DISK` 列,用于显示磁盘使用量,单位为字节。
31+
* `TxnStart` 列,用于显示事务的开始时间。
32+
* `RESOURCE_GROUP` 列,用于显示资源组名称。
33+
* `SESSION_ALIAS` 列,用于显示当前会话的别名。
34+
* `ROWS_AFFECTED` 列,用于显示当前语句影响的行数。
35+
* `TIDB_CPU` 列,用于显示该语句在 TiDB 服务器上消耗的 CPU 时间,单位为纳秒。只有在启用 [Top SQL](https://docs.pingcap.com/tidb/stable/top-sql) 功能时,该列才有意义,否则值为 `0`
36+
* `TIKV_CPU` 列,用于显示该语句在 TiKV 服务器上消耗的 CPU 时间,单位为纳秒
3737

3838
</CustomContent>
3939

@@ -91,55 +91,55 @@ RESOURCE_GROUP: default
9191
TIKV_CPU: 0
9292
```
9393

94-
Fields in the `PROCESSLIST` 表的描述如下
94+
`PROCESSLIST` 表中的各字段说明如下
9595

9696
<CustomContent platform="tidb">
9797

98-
* `ID`: 用户连接的 ID。
99-
* `USER`: 执行 `PROCESS` 的用户名称
100-
* `HOST`: 用户连接的地址。
101-
* `DB`: 当前连接的默认数据库名称。
102-
* `COMMAND`: `PROCESS` 执行的命令类型
103-
* `TIME`: `PROCESS` 当前的执行时长,单位为秒。
104-
* `STATE`: 当前连接状态
105-
* `INFO`: 正在处理的请求语句。
106-
* `DIGEST`: SQL 语句的摘要。
107-
* `MEM`: 请求所使用的内存,单位为字节。
108-
* `DISK`: 磁盘使用量,单位为字节。
109-
* `TxnStart`: 事务的开始时间。
110-
* `RESOURCE_GROUP`: 资源组名称。
111-
* `SESSION_ALIAS`: 当前会话的别名。
112-
* `ROWS_AFFECTED`: 当前语句影响的行数。
113-
* `TIDB_CPU`: 语句消耗的 TiDB 服务器 CPU 时间(纳秒)。只有在启用 [Top SQL](/dashboard/top-sql.md) 时,此列才有意义,否则值为 `0`
114-
* `TIKV_CPU`: 语句消耗的 TiKV 服务器 CPU 时间(纳秒)
98+
* `ID`用户连接的 ID。
99+
* `USER`执行 `PROCESS` 的用户名
100+
* `HOST`用户连接的地址。
101+
* `DB`当前连接的默认数据库名称。
102+
* `COMMAND``PROCESS` 正在执行的命令类型
103+
* `TIME``PROCESS` 当前的执行时长,单位为秒。
104+
* `STATE`:当前连接的状态
105+
* `INFO`正在处理的请求语句。
106+
* `DIGEST`SQL 语句的摘要。
107+
* `MEM`:当前请求已使用的内存,单位为字节。
108+
* `DISK`磁盘使用量,单位为字节。
109+
* `TxnStart`事务的开始时间。
110+
* `RESOURCE_GROUP`资源组名称。
111+
* `SESSION_ALIAS`当前会话的别名。
112+
* `ROWS_AFFECTED`当前语句影响的行数。
113+
* `TIDB_CPU`:该语句在 TiDB 服务器上消耗的 CPU 时间,单位为纳秒。只有在启用 [Top SQL](/dashboard/top-sql.md) 功能时,该列才有意义,否则值为 `0`
114+
* `TIKV_CPU`:该语句在 TiKV 服务器上消耗的 CPU 时间,单位为纳秒
115115

116116
</CustomContent>
117117

118118
<CustomContent platform="tidb-cloud">
119119

120-
* `ID`: 用户连接的 ID。
121-
* `USER`: 执行 `PROCESS` 的用户名称
122-
* `HOST`: 用户连接的地址。
123-
* `DB`: 当前连接的默认数据库名称。
124-
* `COMMAND`: `PROCESS` 执行的命令类型
125-
* `TIME`: `PROCESS` 当前的执行时长,单位为秒。
126-
* `STATE`: 当前连接状态
127-
* `INFO`: 正在处理的请求语句。
128-
* `DIGEST`: SQL 语句的摘要。
129-
* `MEM`: 请求所使用的内存,单位为字节。
130-
* `DISK`: 磁盘使用量,单位为字节。
131-
* `TxnStart`: 事务的开始时间。
132-
* `RESOURCE_GROUP`: 资源组名称。
133-
* `SESSION_ALIAS`: 当前会话的别名。
134-
* `ROWS_AFFECTED`: 当前语句影响的行数。
135-
* `TIDB_CPU`: 语句消耗的 TiDB 服务器 CPU 时间(纳秒)。只有在启用 [Top SQL](https://docs.pingcap.com/tidb/stable/top-sql) 时,此列才有意义,否则值为 `0`
136-
* `TIKV_CPU`: 语句消耗的 TiKV 服务器 CPU 时间(纳秒)
120+
* `ID`用户连接的 ID。
121+
* `USER`执行 `PROCESS` 的用户名
122+
* `HOST`用户连接的地址。
123+
* `DB`当前连接的默认数据库名称。
124+
* `COMMAND``PROCESS` 正在执行的命令类型
125+
* `TIME``PROCESS` 当前的执行时长,单位为秒。
126+
* `STATE`:当前连接的状态
127+
* `INFO`正在处理的请求语句。
128+
* `DIGEST`SQL 语句的摘要。
129+
* `MEM`:当前请求已使用的内存,单位为字节。
130+
* `DISK`磁盘使用量,单位为字节。
131+
* `TxnStart`事务的开始时间。
132+
* `RESOURCE_GROUP`资源组名称。
133+
* `SESSION_ALIAS`当前会话的别名。
134+
* `ROWS_AFFECTED`当前语句影响的行数。
135+
* `TIDB_CPU`:该语句在 TiDB 服务器上消耗的 CPU 时间,单位为纳秒。只有在启用 [Top SQL](https://docs.pingcap.com/tidb/stable/top-sql) 功能时,该列才有意义,否则值为 `0`
136+
* `TIKV_CPU`:该语句在 TiKV 服务器上消耗的 CPU 时间,单位为纳秒
137137

138138
</CustomContent>
139139

140140
## CLUSTER_PROCESSLIST
141141

142-
`CLUSTER_PROCESSLIST` 是对应 `PROCESSLIST` 的集群系统表,用于查询集群中所有 TiDB 节点的 `PROCESSLIST` 信息。`CLUSTER_PROCESSLIST` 表的表结构比 `PROCESSLIST` 多一列,`INSTANCE` 列,用于存储该行数据所属的 TiDB 节点地址。
142+
`CLUSTER_PROCESSLIST` 是对应于 `PROCESSLIST` 的集群系统表,用于查询集群中所有 TiDB 节点的 `PROCESSLIST` 信息。`CLUSTER_PROCESSLIST` 的表结构比 `PROCESSLIST` 多一个 `INSTANCE` 列,用于存储该行数据所属的 TiDB 节点地址。
143143

144144
```sql
145145
SELECT * FROM information_schema.cluster_processlist;
@@ -151,4 +151,8 @@ SELECT * FROM information_schema.cluster_processlist;
151151
+-----------------+------------+------+-----------------+------+---------+------+------------+------------------------------------------------------+------------------------------------------------------------------+------+------+----------------------------------------+----------------+---------------+---------------+----------+----------+
152152
| 127.0.0.1:10080 | 1268776964 | root | 127.0.0.1:59922 | NULL | Query | 0 | autocommit | SELECT * FROM information_schema.cluster_processlist | b1e38e59fbbc3e2b35546db5c8053040db989a497ac6cd71ff8dd4394395701a | 0 | 0 | 07-29 12:39:24.282(451471727468740609) | default | | 0 | 0 | 0 |
153153
+-----------------+------------+------+-----------------+------+---------+------+------------+------------------------------------------------------+------------------------------------------------------------------+------+------+----------------------------------------+----------------+---------------+---------------+----------+----------+
154-
```
154+
```
155+
156+
## 权限
157+
158+
如果当前用户没有 `PROCESS` 权限,`PROCESSLIST` 只会显示该用户自己会话的请求。

markdown-pages/zh/tidbcloud/master/sql-statements/sql-statement-create-binding.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ summary: 在 TiDB 数据库中使用 CREATE BINDING。
99

1010
`BINDING` 可以是 `GLOBAL`(全局)或 `SESSION`(会话)级别。默认级别为 `SESSION`
1111

12-
被绑定的 SQL 语句会被参数化并存储在系统表中。当 SQL 查询被处理时,只要参数化后的 SQL 语句与系统表中的绑定语句一致,并且系统变量 `tidb_use_plan_baselines` 设置为 `ON`(默认),则会生效相应的优化器 Hint。如果存在多个执行计划,优化器会选择成本最低的绑定计划。更多信息,参见 [创建绑定](/sql-plan-management.md#create-a-binding)
12+
被绑定的 SQL 语句会被参数化并存储在系统表中。当 SQL 查询被处理时,只要参数化后的 SQL 语句与系统表中的绑定语句一致,并且系统变量 `tidb_use_plan_baselines` 设置为 `ON`(默认),则会应用相应的优化器 Hint。如果存在多个执行计划,优化器会选择成本最低的绑定计划。更多信息请参见 [创建绑定](/sql-plan-management.md#create-a-binding)
1313

1414
## 语法
1515

@@ -40,7 +40,7 @@ StringLiteralOrUserVariable ::=
4040
当你根据历史执行计划创建绑定时,需要指定对应的 Plan Digest:
4141

4242
- 你可以使用字符串字面量或字符串类型的用户变量来指定 Plan Digest。
43-
- 你可以指定多个 Plan Digest,以便同时为多条语句创建绑定。在这种情况下,可以指定多个字符串,并在每个字符串中包含多个 digest。注意字符串或 digest 之间需要用逗号分隔。
43+
- 你可以指定多个 Plan Digest,以便同时为多条语句创建绑定。在这种情况下,你可以指定多个字符串,并在每个字符串中包含多个 digest。注意字符串或 digest 之间需要用逗号分隔。
4444

4545
以下示例展示了如何根据 SQL 语句创建绑定。
4646

@@ -160,14 +160,14 @@ SELECT * FROM t1 WHERE t1.a IN (SELECT a FROM t2);
160160
SELECT @@LAST_PLAN_FROM_BINDING;
161161
```
162162

163-
方法 1
163+
方法一
164164

165165
```sql
166166
SELECT query_sample_text, stmt_type, table_names, plan_digest FROM information_schema.statements_summary_history WHERE table_names LIKE '%test.t1%' AND stmt_type != 'CreateTable';
167167
CREATE GLOBAL BINDING FROM HISTORY USING PLAN DIGEST 'e72819cf99932f63a548156dbf433adda60e10337e89dcaa8638b4caf16f64d8,c291edc36b2482738d3389d335f37efc76290be2930330fe5034c5f4c42eeb36,8dc146249484f4a6ab219bfe9effa6b7a18aeed3764d49b610da61ac347ab914,73b2dec866595688ea416675f88ccb3456eb8e7443a79cd816695b688e07ac6b';
168168
```
169169

170-
方法 2
170+
方法二
171171

172172
```sql
173173
SELECT @digests:=GROUP_CONCAT(plan_digest) FROM information_schema.statements_summary_history WHERE table_names LIKE '%test.t1%' AND stmt_type != 'CreateTable';
@@ -310,7 +310,11 @@ Empty set (0.002 sec)
310310

311311
## SQL 语句截断
312312

313-
当你使用 `CREATE BINDING ... FROM HISTORY USING PLAN DIGEST` 时,如果 [语句摘要表](/statement-summary-tables.md) 中存储的该 digest 的 SQL 语句因长度超过 [`tidb_stmt_summary_max_sql_length`](/system-variables.md#tidb_stmt_summary_max_sql_length-new-in-v40) 而被截断,则绑定可能会失败。此时,你需要增大 `tidb_stmt_summary_max_sql_length` 的值。
313+
当你使用 `CREATE BINDING ... FROM HISTORY USING PLAN DIGEST` 时,如果 [语句概要表](/statement-summary-tables.md) 中存储的该 digest 的 SQL 语句因长度超过 [`tidb_stmt_summary_max_sql_length`](/system-variables.md#tidb_stmt_summary_max_sql_length-new-in-v40) 而被截断,则绑定可能会失败。此时,你需要增大 `tidb_stmt_summary_max_sql_length`
314+
315+
## 权限
316+
317+
`CREATE BINDING` 语句需要 `SUPER` 权限。
314318

315319
## MySQL 兼容性
316320

0 commit comments

Comments
 (0)