address comment

Signed-off-by: 童剑 <[email protected]>

Author: bufferflies

sql-statements/sql_statement_distribute_table.md

@@ -1,10 +1,10 @@
 ---
-title: distribute table 使用文档
-summary: TiDB 中的 distribute table 功能可以解决表中 region 分布不均衡问题。通过重新调整 table 中的 region 的分布，可以让指定 table 下的 region 按照一定的策略进行均衡。重新分配可以指定不同的存储引擎，比如 TIFLASH 和 TIKV。同时也可以指定不同的 raft role，比如 learner，leader，voter。
+title: DISTRIBUTE TABLE
+summary: 介绍 TiDB 数据库中 DISTRIBUTE TABLE 的使用概况。
 ---
 
 # DISTRIBUTE TABLE 使用文档
-`DISTRIBUTE TABLE` 用于对指定表范围内的 region 进行重新打散调度， 使其按照表纬度进行均衡分布，防止个别 region 集中在少数的 TIFLASH 和 TIKV。
+`DISTRIBUTE TABLE` 语句用于对指定表的 Region 进行重新打散和调度，以实现表维度的均衡分布。执行该语句可以防止个别 Region 集中在少数 TiFlash 或 TiKV 节点上，从而解决表中 Region 分布不均衡的问题。
 
 ## 语法图
 
@@ -27,10 +27,12 @@ RoleOption ::=
 ```
 
 ## 示例
+通过 `DISTRIBUTE TABLE` 语句重新调度表中的 Region 时，你可以根据需求指定存储引擎（如 TiFlash 或 TiKV）以及不同的 Raft 角色（如 learner、leader、voter） 进行打散均衡操作。
+
+对表 `t1` 在 TiKV 上的 leader 所在的 Region 重新进行均衡调度：
 
-对表A 上的 tikv 上的 leader 重新进行均衡调度
 ```sql
-CREATE TABLE t1 (a INT)；
+CREATE TABLE t1 (a INT);
 ...
 DISTRIBUTE TABLE table_name engine tikv role leader
 ```
@@ -39,24 +41,46 @@ DISTRIBUTE TABLE table_name engine tikv role leader
 100
 +---------+
 
+对表 `t2` 在 TiFlash 上的 learner 所在的 Region 重新进行均衡调度：
+```sql
+CREATE TABLE t2 (a INT);
+...
+DISTRIBUTE TABLE t2 ENGINE tiflash role learner;
+```
++---------+
+| JOB_ID  | 
+101
++---------+
+
+对分区表 `t5` 的 `p1` 和 `p2` 分区在 TiKV 上的 leader 所在的 Region 重新进行均衡调度：
+
+```sql
+CREATE TABLE t5 (a INT);
+...
+DISTRIBUTE TABLE t5 PARTITION (p1, p2) ENGINE tikv role leader;
+```
++---------+
+| JOB_ID  | 
+102
++---------+
 
 
-显示当前所有的调度任务
+显示当前所有的调度任务：
 ```sql
 SHOW DISTRIBUTION JOBS;
 ```
 
 +---------+------------+------------+-----------------+------------+-----------+----------+-------------+---------------+
 | JOB_ID  |  DB_NAME   | TABLE_NAME | PARTITION_NAMES | ENGINE_TYPE | ROLE_TYPE | STATUS  | CREATE_USER | CREATE_TIME   |
 +---------+------------+------------+-----------------+------------+-----------+--------+---------------+---------------+
-|    1    |   db_1     |    t1      |                 | TIKV       | LEADER    | RUNNING  | ADMIN       |   20240712    |
+|    1    |   db_1     |    t1      |                 | TIKV       | LEADER    | RUNNING  | ADMIN       | 20240712      |
 |    2    |   db_1     |    t2      |                 | TIFLASH    | LEARNER   | FINISHED | ADMIN       | 20240715      |
 |    3    |   db_1     |    t3      |                 | TiKV       | VOTER     | STOPPED  | ADMIN       | 20240713      |
 |    4    |   db_1     |    t4      |                 | TIFLASH    | LEARNER   | FINISHED | ADMIN       | 20240713      |
 +---------+------------+------------+-----------------+------------+-----------+----------+-------------+---------------+
 
 
-显示当前表 t1 的 region 分布情况
+显示当前表 `t1` 的 region 分布情况:
 ```sql
 SHOW TABLE DISTRIBUTION t1;
 ```