*: Update documents and sqlgrams with "alter" prefixed statements (pi…

…ngcap#3235)
imtbkcat · May 22, 2020 · 79b9b63 · 79b9b63
1 parent 832cc1f
commit 79b9b63
Show file tree

Hide file tree

Showing 33 changed files with 87 additions and 16 deletions.
diff --git a/media/sqlgram/AlterDatabaseStmt.png b/media/sqlgram/AlterDatabaseStmt.png
diff --git a/media/sqlgram/AlterInstanceStmt.png b/media/sqlgram/AlterInstanceStmt.png
diff --git a/media/sqlgram/AlterTableSpec.png b/media/sqlgram/AlterTableSpec.png
diff --git a/media/sqlgram/AlterTableStmt.png b/media/sqlgram/AlterTableStmt.png
diff --git a/media/sqlgram/AlterUserStmt.png b/media/sqlgram/AlterUserStmt.png
diff --git a/media/sqlgram/AuthOption.png b/media/sqlgram/AuthOption.png
diff --git a/media/sqlgram/ColumnDef.png b/media/sqlgram/ColumnDef.png
diff --git a/media/sqlgram/ColumnPosition.png b/media/sqlgram/ColumnPosition.png
diff --git a/media/sqlgram/Constraint.png b/media/sqlgram/Constraint.png
diff --git a/media/sqlgram/ConstraintElem.png b/media/sqlgram/ConstraintElem.png
diff --git a/media/sqlgram/ConstraintKeywordOpt.png b/media/sqlgram/ConstraintKeywordOpt.png
diff --git a/media/sqlgram/DatabaseOption.png b/media/sqlgram/DatabaseOption.png
diff --git a/media/sqlgram/IndexInvisible.png b/media/sqlgram/IndexInvisible.png
diff --git a/media/sqlgram/IndexKeyTypeOpt.png b/media/sqlgram/IndexKeyTypeOpt.png
diff --git a/media/sqlgram/IndexNameAndTypeOpt.png b/media/sqlgram/IndexNameAndTypeOpt.png
diff --git a/media/sqlgram/IndexOption.png b/media/sqlgram/IndexOption.png
diff --git a/media/sqlgram/IndexOptionList.png b/media/sqlgram/IndexOptionList.png
diff --git a/media/sqlgram/IndexPartSpecification.png b/media/sqlgram/IndexPartSpecification.png
diff --git a/media/sqlgram/IndexPartSpecificationList.png b/media/sqlgram/IndexPartSpecificationList.png
diff --git a/media/sqlgram/IndexTypeName.png b/media/sqlgram/IndexTypeName.png
diff --git a/media/sqlgram/InstanceOption.png b/media/sqlgram/InstanceOption.png
diff --git a/media/sqlgram/KeyOrIndex.png b/media/sqlgram/KeyOrIndex.png
diff --git a/media/sqlgram/UserSpec.png b/media/sqlgram/UserSpec.png
diff --git a/media/sqlgram/UserSpecList.png b/media/sqlgram/UserSpecList.png
diff --git a/media/sqlgram/Username.png b/media/sqlgram/Username.png
diff --git a/resources/figma-quick-start-guide.md b/resources/figma-quick-start-guide.md
@@ -31,7 +31,7 @@ summary: 本文档介绍如何使用 Figma 绘制图片。
 
 ### 第 2 步：打开 tidb-sketch-book 文件
 
-点击 [tidb-sketch-book](https://www.figma.com/file/MOBwqkBtuA03agMjeGEGUT/tidb-sketch-book) 查看该绘图模板文件。
+点击 [tidb-sketch-book](https://www.figma.com/file/dHQ9B7X4mF1q78NRIzNTs5/tidb-sketch-book-2020) 查看该绘图模板文件。
 
 > **注意：**
 >

diff --git a/sql-statements/sql-statement-add-column.md b/sql-statements/sql-statement-add-column.md
@@ -19,10 +19,6 @@ aliases: ['/docs-cn/dev/reference/sql/statements/add-column/']
 
 ![AlterTableSpec](/media/sqlgram/AlterTableSpec.png)
 
-**ColumnKeywordOpt:**
-
-![ColumnKeywordOpt](/media/sqlgram/ColumnKeywordOpt.png)
-
 **ColumnDef:**
 
 ![ColumnDef](/media/sqlgram/ColumnDef.png)
@@ -120,9 +116,10 @@ SELECT * FROM t1;
 
 ## MySQL 兼容性
 
-* 不支持同时添加多列。
+* 不支持在一条语句中同时添加多列。
 * 不支持将新添加的列设为 `PRIMARY KEY`。
 * 不支持将新添加的列设为 `AUTO_INCREMENT`。
+* 对添加生成列有局限性，具体可参考：[生成列局限性](/generated-columns.md#局限性)。
 
 ## 另请参阅
 

diff --git a/sql-statements/sql-statement-add-index.md b/sql-statements/sql-statement-add-index.md
@@ -19,17 +19,53 @@ aliases: ['/docs-cn/dev/reference/sql/statements/add-index/']
 
 ![AlterTableSpec](/media/sqlgram/AlterTableSpec.png)
 
-**ColumnKeywordOpt:**
+**Constraint:**
 
-![ColumnKeywordOpt](/media/sqlgram/ColumnKeywordOpt.png)
+![Constraint](/media/sqlgram/Constraint.png)
 
-**ColumnDef:**
+**ConstraintKeywordOpt:**
 
-![ColumnDef](/media/sqlgram/ColumnDef.png)
+![ConstraintKeywordOpt](/media/sqlgram/ConstraintKeywordOpt.png)
 
-**ColumnPosition:**
+**ConstraintElem:**
 
-![ColumnPosition](/media/sqlgram/ColumnPosition.png)
+![ConstraintElem](/media/sqlgram/ConstraintElem.png)
+
+**IndexNameAndTypeOpt:**
+
+![IndexNameAndTypeOpt](/media/sqlgram/IndexNameAndTypeOpt.png)
+
+**IndexPartSpecificationList:**
+
+![IndexPartSpecificationList](/media/sqlgram/IndexPartSpecificationList.png)
+
+**IndexPartSpecification:**
+
+![IndexPartSpecification](/media/sqlgram/IndexPartSpecification.png)
+
+**IndexOptionList:**
+
+![IndexOptionList](/media/sqlgram/IndexOptionList.png)
+
+**IndexOption:**
+
+![IndexOption](/media/sqlgram/IndexOption.png)
+
+**KeyOrIndex:**
+
+![KeyOrIndex](/media/sqlgram/KeyOrIndex.png)
+
+**IndexKeyTypeOpt:**
+
+![IndexKeyTypeOpt](/media/sqlgram/IndexKeyTypeOpt.png)
+
+**IndexInvisible:**
+
+![IndexInvisible](/media/sqlgram/IndexInvisible.png)
+
+**IndexTypeName:**
+
+![IndexTypeName](/media/sqlgram/IndexTypeName.png)
 
 ## 示例
 
@@ -100,9 +136,10 @@ EXPLAIN SELECT * FROM t1 WHERE c1 = 3;
 ## MySQL 兼容性
 
 * 不支持 `FULLTEXT`，`HASH` 和 `SPATIAL` 索引。
+* 不支持 `VISIBLE/INVISIBLE` 索引。
 * 不支持降序索引（类似于 MySQL 5.7）。
-* 目前尚不支持同时添加多个索引。
-* 默认无法向表中添加 `PRIMARY KEY`，在开启 `alter-primary-key` 配置项后可支持此功能，详情参考：[alter-primary-key](/tidb-configuration-file.md#alter-primary-key)。
+* 目前尚不支持在一条中同时添加多个索引。
+* 默认无法向表中添加 `PRIMARY KEY`，在开启 `alter-primary-key` 配置项后可支持此功能，详情可参考：[alter-primary-key](/tidb-configuration-file.md#alter-primary-key)。
 
 ## 另请参阅
 

diff --git a/sql-statements/sql-statement-alter-database.md b/sql-statements/sql-statement-alter-database.md
@@ -9,6 +9,16 @@ aliases: ['/docs-cn/dev/reference/sql/statements/alter-database/']
 
 `ALTER DATABASE` 用于修改指定或当前数据库的默认字符集和排序规则。`ALTER SCHEMA` 跟 `ALTER DATABASE` 操作效果一样。
 
+## 语法图
+
+**AlterDatabaseStmt:**
+
+![AlterDatabaseStmt](/media/sqlgram/AlterDatabaseStmt.png)
+
+**DatabaseOption:**
+
+![DatabaseOption](/media/sqlgram/DatabaseOption.png)
+
 ## 示例
 
 {{< copyable "sql" >}}

diff --git a/sql-statements/sql-statement-alter-index.md b/sql-statements/sql-statement-alter-index.md
@@ -9,6 +9,20 @@ aliases: ['/docs-cn/dev/reference/sql/statements/alter-index/']
 
 `ALTER INDEX` 语句用于修改索引的可见性，可以将索引设置为 `Visible` 或者 `Invisible`。设置为 `Invisible` 的索引将无法被优化器使用。
 
+## 语法图
+
+**AlterTableStmt:**
+
+![AlterTableStmt](/media/sqlgram/AlterTableStmt.png)
+
+**AlterTableSpec:**
+
+![AlterTableSpec](/media/sqlgram/AlterTableSpec.png)
+
+**IndexInvisible:**
+
+![IndexInvisible](/media/sqlgram/IndexInvisible.png)
+
 ## 语法
 
 {{< copyable "sql" >}}

diff --git a/sql-statements/sql-statement-alter-instance.md b/sql-statements/sql-statement-alter-instance.md
@@ -19,8 +19,14 @@ aliases: ['/docs-cn/dev/reference/sql/statements/alter-instance/']
 
 ## 语法图
 
+**AlterInstanceStmt:**
+
 ![AlterInstanceStmt](/media/sqlgram/AlterInstanceStmt.png)
 
+**InstanceOption:**
+
+![InstanceOption](/media/sqlgram/InstanceOption.png)
+
 ## 示例
 
 {{< copyable "sql" >}}

diff --git a/sql-statements/sql-statement-alter-table.md b/sql-statements/sql-statement-alter-table.md
@@ -94,8 +94,7 @@ EXPLAIN SELECT * FROM t1 WHERE c1 = 3;
 
 ## MySQL 兼容性
 
-* 支持除空间类型外的所有数据类型。
-* 不支持 `FULLTEXT`，`HASH` 和 `SPATIAL` 索引。
+* 支持除空间类型外的所有数据类型。其它不支持的情况可参考：[alter-primary-key](/tidb-configuration-file.md#alter-primary-key)。
 
 ## 另请参阅
 

diff --git a/sql-statements/sql-statement-alter-user.md b/sql-statements/sql-statement-alter-user.md
@@ -23,6 +23,14 @@ aliases: ['/docs-cn/dev/reference/sql/statements/alter-user/']
 
 ![UserSpec](/media/sqlgram/UserSpec.png)
 
+**Username:**
+
+![Username](/media/sqlgram/Username.png)
+
+**AuthOption:**
+
+![AuthOption](/media/sqlgram/AuthOption.png)
+
 ## 示例
 
 {{< copyable "sql" >}}