Skip to content

Commit 43758a9

Browse files
TomShawnTomShawn
authored
Capitalize sql keywords in several files (#4862)
1 parent cc62ce1 commit 43758a9

6 files changed

+51
-52
lines changed

‎auto-random.md

+15-16
Original file line numberDiff line numberDiff line change
@@ -17,29 +17,29 @@ aliases: ['/docs-cn/dev/auto-random/','/docs-cn/dev/reference/sql/attributes/aut
1717
以下面语句建立的表为例：
1818

1919
```sql
20-
create table t (a bigint primary key auto_increment, b varchar(255))
20+
CREATE TABLE t (a bigint PRIMARY KEY AUTO_INCREMENT, b varchar(255))
2121
```
2222

2323
在以上语句所建的表上执行大量未指定主键值的 `INSERT` 语句，示例如下：
2424

2525
```sql
26-
insert into t(b) values ('a'), ('b'), ('c')
26+
INSERT INTO t(b) VALUES ('a'), ('b'), ('c')
2727
```
2828

2929
如以上语句，由于未指定主键列的值（`a` 列），TiDB 会使用连续自增的行值作为行 ID，可能导致单个 TiKV 节点上产生写入热点，进而影响对外提供服务的性能。要避免这种写入热点，可以在执行建表语句时为 `a` 列指定 `AUTO_RANDOM` 属性而不是 `AUTO_INCREMENT` 属性。示例如下：
3030

3131
{{< copyable "sql" >}}
3232

3333
```sql
34-
create table t (a bigint primary key auto_random, b varchar(255))
34+
CREATE TABLE t (a bigint PRIMARY KEY AUTO_RANDOM, b varchar(255))
3535
```
3636

3737
或者
3838

3939
{{< copyable "sql" >}}
4040

4141
```sql
42-
create table t (a bigint auto_random, b varchar(255), primary key (a))
42+
CREATE TABLE t (a bigint AUTO_RANDOM, b varchar(255), PRIMARY KEY (a))
4343
```
4444

4545
此时再执行形如 `INSERT INTO t(b) values...` 的 `INSERT` 语句。
@@ -60,7 +60,7 @@ create table t (a bigint auto_random, b varchar(255), primary key (a))
6060
{{< copyable "sql" >}}
6161

6262
```sql
63-
create table t (a bigint primary key auto_random(3), b varchar(255))
63+
CREATE TABLE t (a bigint PRIMARY KEY AUTO_RANDOM(3), b varchar(255))
6464
```
6565

6666
以上建表语句中，shard bits 的数量为 `3`。shard bits 的数量的取值范围是 `[1, field_max_bits)`，其中 `field_max_bits` 为整型主键列类型占用的位长度。
@@ -70,16 +70,15 @@ create table t (a bigint primary key auto_random(3), b varchar(255))
7070
{{< copyable "sql" >}}
7171

7272
```sql
73-
show warnings
73+
SHOW WARNINGS
7474
```
7575

76-
```
76+
```sql
7777
+-------+------+----------------------------------------------------------+
7878
| Level | Code | Message |
7979
+-------+------+----------------------------------------------------------+
8080
| Note | 1105 | Available implicit allocation times: 1152921504606846976 |
8181
+-------+------+----------------------------------------------------------+
82-
8382
```
8483

8584
> **注意：**
@@ -88,19 +87,19 @@ show warnings
8887
8988
另外，要查看某张含有 `AUTO_RANDOM` 属性的表的 shard bits 数量，可以在系统表 `information_schema.tables` 中 `TIDB_ROW_ID_SHARDING_INFO` 一列看到模式为 `PK_AUTO_RANDOM_BITS=x` 的值，其中 `x` 为 shard bits 的数量。
9089

91-
`AUTO RANDOM` 列隐式分配的值会影响 `last_insert_id()`。可以使用 `select last_insert_id()` 获取上一次 TiDB 隐式分配的 ID，例如：
90+
`AUTO RANDOM` 列隐式分配的值会影响 `last_insert_id()`。可以使用 `SELECT last_insert_id()` 获取上一次 TiDB 隐式分配的 ID，例如：
9291

9392
{{< copyable "sql" >}}
9493

9594
```sql
96-
insert into t (b) values ("b")
97-
select * from t;
98-
select last_insert_id()
95+
INSERT INTO t (b) VALUES ("b")
96+
SELECT * FROM t;
97+
SELECT last_insert_id()
9998
```
10099

101100
可能得到的结果如下：
102101

103-
```
102+
```sql
104103
+------------+---+
105104
| a | b |
106105
+------------+---+
@@ -121,18 +120,18 @@ TiDB 支持解析版本注释语法。示例如下：
121120
{{< copyable "sql" >}}
122121

123122
```sql
124-
create table t (a bigint primary key /*T![auto_rand] auto_random */)
123+
CREATE TABLE t (a bigint PRIMARY KEY /*T![auto_rand] auto_random */)
125124
```
126125

127126
{{< copyable "sql" >}}
128127

129128
```sql
130-
create table t (a bigint primary key auto_random)
129+
CREATE TABLE t (a bigint PRIMARY KEY AUTO_RANDOM)
131130
```
132131

133132
以上两个语句含义相同。
134133

135-
在 `show create table` 的结果中，`AUTO_RANDOM` 属性会被注释掉。注释会附带一个特性标识符，例如 `/*T![auto_rand] auto_random */`。其中 `auto_rand` 表示 `AUTO_RANDOM` 的特性标识符，只有实现了该标识符对应特性的 TiDB 版本才能够正常解析 SQL 语句片段。
134+
在 `SHOW CREATE TABLE` 的结果中，`AUTO_RANDOM` 属性会被注释掉。注释会附带一个特性标识符，例如 `/*T![auto_rand] auto_random */`。其中 `auto_rand` 表示 `AUTO_RANDOM` 的特性标识符，只有实现了该标识符对应特性的 TiDB 版本才能够正常解析 SQL 语句片段。
136135

137136
该功能支持向前兼容，即降级兼容。没有实现对应特性的 TiDB 版本则会忽略表（带有上述注释）的 `AUTO_RANDOM` 属性，因此能够使用含有该属性的表。
138137

‎backup-and-restore-using-dumpling-lightning.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -67,15 +67,15 @@ Could not read data from testSchema.testTable: GC life time is shorter than tran
6767
{{< copyable "sql" >}}
6868

6969
```sql
70-
update mysql.tidb set VARIABLE_VALUE = '720h' where VARIABLE_NAME = 'tikv_gc_life_time';
70+
UPDATE mysql.tidb SET VARIABLE_VALUE = '720h' WHERE VARIABLE_NAME = 'tikv_gc_life_time';
7171
```
7272

7373
2. 执行 `dumpling` 命令后，将 TiDB 集群的 GC 值恢复到第 1 步中的初始值：
7474

7575
{{< copyable "sql" >}}
7676

7777
```sql
78-
update mysql.tidb set VARIABLE_VALUE = '10m' where VARIABLE_NAME = 'tikv_gc_life_time';
78+
UPDATE mysql.tidb SET VARIABLE_VALUE = '10m' WHERE VARIABLE_NAME = 'tikv_gc_life_time';
7979
```
8080

8181
## 向 TiDB 恢复数据

‎backup-and-restore-using-mydumper-lightning.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -78,15 +78,15 @@ aliases: ['/docs-cn/dev/backup-and-restore-using-mydumper-lightning/','/docs-cn/
7878
{{< copyable "sql" >}}
7979

8080
```sql
81-
update mysql.tidb set VARIABLE_VALUE = '720h' where VARIABLE_NAME = 'tikv_gc_life_time';
81+
UPDATE mysql.tidb SET VARIABLE_VALUE = '720h' WHERE VARIABLE_NAME = 'tikv_gc_life_time';
8282
```
8383

8484
2. 执行 `mydumper` 命令后，将 TiDB 集群的 GC 值恢复到第 1 步中的初始值：
8585

8686
{{< copyable "sql" >}}
8787

8888
```sql
89-
update mysql.tidb set VARIABLE_VALUE = '10m' where VARIABLE_NAME = 'tikv_gc_life_time';
89+
UPDATE mysql.tidb SET VARIABLE_VALUE = '10m' WHERE VARIABLE_NAME = 'tikv_gc_life_time';
9090
```
9191

9292
## 向 TiDB 恢复数据

‎basic-sql-operations.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ SHOW DATABASES;
4040
{{< copyable "sql" >}}
4141

4242
```sql
43-
use mysql;
43+
USE mysql;
4444
```
4545

4646
使用 `SHOW TABLES` 语句查看数据库中的所有表。例如：
@@ -104,7 +104,7 @@ CREATE TABLE person (
104104
{{< copyable "sql" >}}
105105

106106
```sql
107-
SHOW CREATE table person;
107+
SHOW CREATE TABLE person;
108108
```
109109

110110
使用 `DROP TABLE` 语句删除表。例如：
@@ -154,7 +154,7 @@ ALTER TABLE person ADD UNIQUE person_unique_id (id);
154154
{{< copyable "sql" >}}
155155

156156
```sql
157-
SHOW INDEX from person;
157+
SHOW INDEX FROM person;
158158
```
159159

160160
使用 `ALTER TABLE` 或 `DROP INDEX` 语句来删除索引。与 `CREATE INDEX` 语句类似，`DROP INDEX` 也可以嵌入 `ALTER TABLE` 语句。例如：
@@ -241,7 +241,7 @@ SELECT name FROM person;
241241
{{< copyable "sql" >}}
242242

243243
```sql
244-
SELECT * FROM person where id<5;
244+
SELECT * FROM person WHERE id<5;
245245
```
246246

247247
常用的 DCL 功能是创建或删除用户，和对用户权限的管理。

‎blacklist-control-plan.md

+14-14
Original file line numberDiff line numberDiff line change
@@ -43,27 +43,27 @@ aliases: ['/docs-cn/dev/blacklist-control-plan/']
4343
{{< copyable "sql" >}}
4444

4545
```sql
46-
insert into mysql.opt_rule_blacklist values("join_reorder"), ("topn_push_down");
46+
INSERT INTO mysql.opt_rule_blacklist VALUES("join_reorder"), ("topn_push_down");
4747
```
4848

4949
执行以下 SQL 语句可让禁用规则立即生效，包括相应 TiDB Server 的所有旧链接：
5050

5151
{{< copyable "sql" >}}
5252

5353
```sql
54-
admin reload opt_rule_blacklist;
54+
ADMIN reload opt_rule_blacklist;
5555
```
56-
56+
5757
> **注意：**
58-
>
58+
>
5959
> `admin reload opt_rule_blacklist` 只对执行该 SQL 语句的 TiDB server 生效。若需要集群中所有 TiDB server 生效，需要在每台 TiDB server 上执行该 SQL 语句。
6060

6161
- 需要解除一条规则的禁用时，需要删除表中禁用该条规则的相应数据，再执行 `admin reload`：
6262

6363
{{< copyable "sql" >}}
6464

6565
```sql
66-
delete from mysql.opt_rule_blacklist where name in ("join_reorder", "topn_push_down");
66+
DELETE FROM mysql.opt_rule_blacklist WHERE name IN ("join_reorder", "topn_push_down");
6767
admin reload opt_rule_blacklist;
6868
```
6969

@@ -83,15 +83,15 @@ aliases: ['/docs-cn/dev/blacklist-control-plan/']
8383
| [日期运算](/functions-and-operators/date-and-time-functions.md) | [`DATE_FORMAT()`](https://dev.mysql.com/doc/refman/5.7/en/date-and-time-functions.html#function_date-format) |
8484

8585
### 禁止特定表达式下推
86-
86+
8787
当函数的计算过程由于下推而出现异常时，可通过黑名单功能禁止其下推来快速恢复业务。具体而言，你可以将上述支持的函数或运算符名加入黑名单 `mysql.expr_pushdown_blacklist` 中，以禁止特定表达式下推。
8888

8989
`mysql.expr_pushdown_blacklist` 的 schema 如下：
9090

9191
{{< copyable "sql" >}}
9292

9393
```sql
94-
desc mysql.expr_pushdown_blacklist;
94+
DESC mysql.expr_pushdown_blacklist;
9595
```
9696

9797
```sql
@@ -147,7 +147,7 @@ desc mysql.expr_pushdown_blacklist;
147147
{{< copyable "sql" >}}
148148

149149
```sql
150-
explain select * from t where a < 2 and a > 2;
150+
EXPLAIN SELECT * FROM t WHERE a < 2 AND a > 2;
151151
```
152152

153153
```sql
@@ -166,7 +166,7 @@ desc mysql.expr_pushdown_blacklist;
166166
{{< copyable "sql" >}}
167167

168168
```sql
169-
insert into mysql.expr_pushdown_blacklist values('<','tikv',''), ('>','tikv','');
169+
INSERT INTO mysql.expr_pushdown_blacklist VALUES('<','tikv',''), ('>','tikv','');
170170
```
171171

172172
```sql
@@ -177,7 +177,7 @@ desc mysql.expr_pushdown_blacklist;
177177
{{< copyable "sql" >}}
178178

179179
```sql
180-
admin reload expr_pushdown_blacklist;
180+
ADMIN reload expr_pushdown_blacklist;
181181
```
182182

183183
```sql
@@ -189,7 +189,7 @@ desc mysql.expr_pushdown_blacklist;
189189
{{< copyable "sql" >}}
190190

191191
```sql
192-
explain select * from t where a < 2 and a > 2;
192+
EXPLAIN SELECT * FROM t WHERE a < 2 and a > 2;
193193
```
194194

195195
```sql
@@ -208,7 +208,7 @@ desc mysql.expr_pushdown_blacklist;
208208
{{< copyable "sql" >}}
209209

210210
```sql
211-
delete from mysql.expr_pushdown_blacklist where name = '>';
211+
DELETE FROM mysql.expr_pushdown_blacklist WHERE name = '>';
212212
```
213213

214214
```sql
@@ -218,7 +218,7 @@ desc mysql.expr_pushdown_blacklist;
218218
{{< copyable "sql" >}}
219219

220220
```sql
221-
admin reload expr_pushdown_blacklist;
221+
ADMIN reload expr_pushdown_blacklist;
222222
```
223223

224224
```sql
@@ -230,7 +230,7 @@ desc mysql.expr_pushdown_blacklist;
230230
{{< copyable "sql" >}}
231231

232232
```sql
233-
explain select * from t where a < 2 and a > 2;
233+
EXPLAIN SELECT * FROM t WHERE a < 2 AND a > 2;
234234
```
235235

236236
```sql

‎character-set-and-collation.md

+14-14
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ ALTER DATABASE db_name
174174
{{< copyable "sql" >}}
175175

176176
```sql
177-
create schema test1 character set utf8mb4 COLLATE uft8mb4_general_ci;
177+
CREATE SCHEMA test1 CHARACTER SET utf8mb4 COLLATE uft8mb4_general_ci;
178178
```
179179

180180
```sql
@@ -184,7 +184,7 @@ Query OK, 0 rows affected (0.09 sec)
184184
{{< copyable "sql" >}}
185185

186186
```sql
187-
use test1;
187+
USE test1;
188188
```
189189

190190
```sql
@@ -209,7 +209,7 @@ SELECT @@character_set_database, @@collation_database;
209209
{{< copyable "sql" >}}
210210

211211
```sql
212-
create schema test2 character set latin1 COLLATE latin1_bin;
212+
CREATE SCHEMA test2 CHARACTER SET latin1 COLLATE latin1_bin;
213213
```
214214

215215
```sql
@@ -219,7 +219,7 @@ Query OK, 0 rows affected (0.09 sec)
219219
{{< copyable "sql" >}}
220220

221221
```sql
222-
use test2;
222+
USE test2;
223223
```
224224

225225
```sql
@@ -390,13 +390,13 @@ SELECT _utf8mb4'string' COLLATE utf8mb4_general_ci;
390390
{{< copyable "sql" >}}
391391

392392
```sql
393-
create table t(a varchar(20) charset utf8mb4 collate utf8mb4_general_ci primary key);
393+
CREATE TABLE t(a varchar(20) charset utf8mb4 collate utf8mb4_general_ci PRIMARY KEY);
394394
Query OK, 0 rows affected
395-
insert into t values ('A');
395+
INSERT INTO t VALUES ('A');
396396
Query OK, 1 row affected
397-
insert into t values ('a');
397+
INSERT INTO t VALUES ('a');
398398
Query OK, 1 row affected # TiDB 会执行成功，而在 MySQL 中，则由于 utf8mb4_general_ci 大小写不敏感，报错 Duplicate entry 'a'。
399-
insert into t1 values ('a ');
399+
INSERT INTO t VALUES ('a ');
400400
Query OK, 1 row affected # TiDB 会执行成功，而在 MySQL 中，则由于补齐空格比较，报错 Duplicate entry 'a '。
401401
```
402402

@@ -407,7 +407,7 @@ TiDB 4.0 新增了完整的排序规则支持框架，从语义上支持了排
407407
{{< copyable "sql" >}}
408408

409409
```sql
410-
select VARIABLE_VALUE from mysql.tidb where VARIABLE_NAME='new_collation_enabled';
410+
SELECT VARIABLE_VALUE FROM mysql.tidb WHERE VARIABLE_NAME='new_collation_enabled';
411411
```
412412

413413
```sql
@@ -426,13 +426,13 @@ select VARIABLE_VALUE from mysql.tidb where VARIABLE_NAME='new_collation_enabled
426426
{{< copyable "sql" >}}
427427

428428
```sql
429-
create table t(a varchar(20) charset utf8mb4 collate utf8mb4_general_ci primary key);
429+
CREATE TABLE t(a varchar(20) charset utf8mb4 collate utf8mb4_general_ci PRIMARY KEY);
430430
Query OK, 0 rows affected (0.00 sec)
431-
insert into t values ('A');
431+
INSERT INTO t VALUES ('A');
432432
Query OK, 1 row affected (0.00 sec)
433-
insert into t values ('a');
433+
INSERT INTO t VALUES ('a');
434434
ERROR 1062 (23000): Duplicate entry 'a' for key 'PRIMARY' # TiDB 兼容了 MySQL 的 case insensitive collation。
435-
insert into t values ('a ');
435+
INSERT INTO t VALUES ('a ');
436436
ERROR 1062 (23000): Duplicate entry 'a ' for key 'PRIMARY' # TiDB 修正了 `PADDING` 行为，与 MySQL 兼容。
437437
```
438438

@@ -468,7 +468,7 @@ TiDB 支持使用 `COLLATE` 子句来指定一个表达式的排序规则，该
468468
{{< copyable "sql" >}}
469469

470470
```sql
471-
select 'a' = _utf8mb4 'A' collate utf8mb4_general_ci;
471+
SELECT 'a' = _utf8mb4 'A' collate utf8mb4_general_ci;
472472
```
473473

474474
```sql

0 commit comments

Comments
 (0)