sql-stmt: modify SelectStmt and add page for SHOW STATS_HISTOGRAMS

TOC.md

@@ -310,6 +310,7 @@
       - [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md)
       - [`SHOW [FULL] FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md)
       - [`SHOW GRANTS`](/sql-statements/sql-statement-show-grants.md)
+      - [`SHOW STATS_HISTOGRAMS`](/sql-statements/sql-statement-show-histograms.md)
       - [`SHOW STATS_META`](/sql-statements/sql-statement-show-stats-meta.md)
       - [`SHOW INDEXES [FROM|IN]`](/sql-statements/sql-statement-show-indexes.md)
       - [`SHOW INDEX [FROM|IN]`](/sql-statements/sql-statement-show-index.md)

sql-statements/sql-statement-select.md

@@ -59,10 +59,15 @@ aliases: ['/docs-cn/dev/reference/sql/statements/select/']
 
 ![SelectLockOpt](/media/sqlgram/SelectLockOpt.png)
 
+**WindowClauseOptional**
+
+![WindowClauseOptional](/media/sqlgram/WindowClauseOptional.png)
+
 ## 语法元素说明
 
 |语法元素 | 说明 |
 | --------------------- | -------------------------------------------------- |
+|`TableOptimizerHints`| 用于控制优化器行为的 Hint，具体可参见 [Optimizer Hints](/optimizer-hints.md)|
 |`ALL`、`DISTINCT`、`DISTINCTROW` | 查询结果集中可能会包含重复值。指定 DISTINCT/DISTINCTROW 则在查询结果中过滤掉重复的行；指定 ALL 则列出所有的行。默认为 ALL。|
 |`HIGH_PRIORITY` | 该语句为高优先级语句，TiDB 在执行阶段会优先处理这条语句|
 |`SQL_CALC_FOUND_ROWS` | TiDB 出于兼容性解析这个语法，但是不做任何处理|
@@ -75,6 +80,7 @@ aliases: ['/docs-cn/dev/reference/sql/statements/select/']
 |`HAVING where_condition` | Having 子句与 Where 子句作用类似，Having 子句可以让过滤 GroupBy 后的各种数据，Where 子句用于在聚合前过滤记录。|
 |`ORDER BY` | OrderBy 子句用于指定结果排序顺序，可以按照列、表达式或者是 `select_expr` 列表中某个位置的字段进行排序。|
 |`LIMIT` | Limit 子句用于限制结果条数。Limit 接受一个或两个数字参数，如果只有一个参数，那么表示返回数据的最大行数；如果是两个参数，那么第一个参数表示返回数据的第一行的偏移量（第一行数据的偏移量是 0），第二个参数指定返回数据的最大条目数。|
+|`Window window_definition`| 窗口函数的相关语法，用来进行一些分析型计算的操作，详情可见 [窗口函数](/functions-and-operators/window-functions.md)|
 |`FOR UPDATE` | 对查询结果集所有行上锁（对于在查询条件内，但是不在结果集的行，将不会加锁，如事务启动后由其他事务写入的行），以监测其他事务对这些的并发修改。使用[乐观事务模型](/optimistic-transaction.md)时，语句执行期间不会检测锁，因此，不会像 PostgreSQL 之类的数据库一样，在当前事务结束前阻止其他事务执行 `UPDATE`、`DELETE` 和 `SELECT FOR UPDATE`。在事务的提交阶段 `SELECT FOR UPDATE` 读到的行，也会进行两阶段提交，因此，它们也可以参与事务冲突检测。如发生写入冲突，那么包含 `SELECT FOR UPDATE` 语句的事务会提交失败。如果没有冲突，事务将成功提交，当提交结束时，这些被加锁的行，会产生一个新版本，可以让其他尚未提交的事务，在将来提交时发现写入冲突。若使用悲观事务，则行为与其他数据库基本相同，不一致之处参考[和 MySQL InnoDB 的差异](/pessimistic-transaction.md#和-mysql-innodb-的差异)。 |
 |`LOCK IN SHARE MODE` | TiDB 出于兼容性解析这个语法，但是不做任何处理|
 

sql-statements/sql-statement-show-histograms.md

@@ -0,0 +1,67 @@
+---
+title: SHOW STATS_HISTOGRAMS
+summary: TiDB 数据库中 SHOW HISTOGRAMS 语句的简单说明。
+category: reference
+---
+
+# SHOW STATS_HISTOGRAMS
+
+你可以使用 `SHOW STATS_HISTOGRAMS` 语句查看统计信息中直方图的相关信息。
+
+## 语法图
+
+**ShowStmt**
+
+![ShowStmt](/media/sqlgram/ShowStmt.png)
+
+**ShowTargetFiltertable**
+
+![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png)
+
+**ShowLikeOrWhereOpt**
+
+![ShowLikeOrWhereOpt](/media/sqlgram/ShowLikeOrWhereOpt.png)
+
+## 示例
+
+{{< copyable "sql" >}}
+
+```sql
+show stats_histograms;
+```
+
+```sql
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+| Db_name | Table_name | Partition_name | Column_name | Is_index | Update_time         | Distinct_count | Null_count | Avg_col_size | Correlation |
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+| test    | t          |                | a           |        0 | 2020-05-25 19:20:00 |              7 |          0 |            1 |           1 |
+| test    | t2         |                | a           |        0 | 2020-05-25 19:20:01 |              6 |          0 |            8 |           0 |
+| test    | t2         |                | b           |        0 | 2020-05-25 19:20:01 |              6 |          0 |         1.67 |           1 |
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+3 rows in set (0.00 sec)
+```
+
+{{< copyable "sql" >}}
+
+```sql
+show stats_histograms where table_name = 't2';
+```
+
+```sql
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+| Db_name | Table_name | Partition_name | Column_name | Is_index | Update_time         | Distinct_count | Null_count | Avg_col_size | Correlation |
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+| test    | t2         |                | b           |        0 | 2020-05-25 19:20:01 |              6 |          0 |         1.67 |           1 |
+| test    | t2         |                | a           |        0 | 2020-05-25 19:20:01 |              6 |          0 |            8 |           0 |
++---------+------------+----------------+-------------+----------+---------------------+----------------+------------+--------------+-------------+
+2 rows in set (0.00 sec)
+```
+
+## MySQL 兼容性
+
+`SHOW STATS_HISTOGRAMS` 是 TiDB 专有语法，因此不兼容 MySQL。
+
+## 另请参阅
+
+* [ANALYZE](/sql-statements/sql-statement-analyze-table.md)
+* [统计信息介绍](/statistics.md)