diff --git a/docs/en/12-taos-sql/12-distinguished.md b/docs/en/12-taos-sql/12-distinguished.md
index 502b7562f3..64687de9f3 100644
--- a/docs/en/12-taos-sql/12-distinguished.md
+++ b/docs/en/12-taos-sql/12-distinguished.md
@@ -16,7 +16,10 @@ When you query a supertable, you may need to partition the supertable by some di
 PARTITION BY part_list
 ```
 
-part_list can be any scalar expression, such as a column, constant, scalar function, or a combination of the preceding items.
+part_list can be any scalar expression, such as a column, constant, scalar function, or a combination of the preceding items. For example, grouping data by label location, taking the average voltage within each group.
+```sql
+select avg(voltage) from meters partition by location
+```
 
 A PARTITION BY clause is processed as follows:
 
@@ -28,7 +31,10 @@ A PARTITION BY clause is processed as follows:
 select max(current) from meters partition by location interval(10m)
 ```
 
-The most common usage of PARTITION BY is partitioning the data in subtables by tags then perform computation when querying data in a supertable. More specifically, `PARTITION BY TBNAME` partitions the data of each subtable into a single timeline, and this method facilitates the statistical analysis in many use cases of processing timeseries data.
+The most common usage of PARTITION BY is partitioning the data in subtables by tags then perform computation when querying data in a supertable. More specifically, `PARTITION BY TBNAME` partitions the data of each subtable into a single timeline, and this method facilitates the statistical analysis in many use cases of processing timeseries data. For example, calculate the average voltage of each meter every 10 minutes£º
+```sql
+select avg(voltage) from meters partition by tbname interval(10m)
+```
 
 ## Windowed Queries
 
diff --git a/docs/zh/12-taos-sql/12-distinguished.md b/docs/zh/12-taos-sql/12-distinguished.md
index 98bfd3567a..a9fa1b6bb1 100755
--- a/docs/zh/12-taos-sql/12-distinguished.md
+++ b/docs/zh/12-taos-sql/12-distinguished.md
@@ -16,7 +16,11 @@ TDengine �供的特色查询包括数�切分查询和时间窗�切分查
 PARTITION BY part_list
 ```
 
-part_list �以是任�的标�表达�，包括列�常��标�函数和它们的组�。
+part_list �以是任�的标�表达�，包括列�常��标�函数和它们的组�。例如，将数�按标签 location 进行分组，��个分组内的电压平�值：
+```sql
+select avg(voltage) from meters partition by location
+```
+
 
 TDengine 按如下方�处�数�切分��：
 
@@ -27,7 +31,11 @@ TDengine 按如下方�处�数�切分��：
 ```sql
 select max(current) from meters partition by location interval(10m)
 ```
-数�切分��最常�的用法就是在超级表查询中，按标签将�表数�进行切分，然�分别进行计算。特别是 PARTITION BY TBNAME 用法，它将�个�表的数�独立出�，形�一��独立的时间�列，�大的方便了��时�场景的统计分�。
+数�切分��最常�的用法就是在超级表查询中，按标签将�表数�进行切分，然�分别进行计算。特别是 PARTITION BY TBNAME 用法，它将�个�表的数�独立出�，形�一��独立的时间�列，�大的方便了��时�场景的统计分�。例如，统计�个电表� 10 分钟内的电压平�值：
+```sql
+select avg(voltage) from meters partition by tbname interval(10m)
+```
+
 
 ## 窗�切分查询