[Doc] Update dynamic partition docs (#54366)

Signed-off-by: 絵空事スピリット <[email protected]> Co-authored-by: 絵空事スピリット <[email protected]> (cherry picked from commit 39ddce9)
StarRocks · Dec 26, 2024 · fa3a38b · fa3a38b
1 parent da94c0d
commit fa3a38b
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 1 deletion.
diff --git a/docs/en/table_design/data_distribution/dynamic_partitioning.md b/docs/en/table_design/data_distribution/dynamic_partitioning.md
@@ -60,7 +60,18 @@ PROPERTIES(
 
 ## View partitions
 
-After you enable dynamic partitions for a table, the input data is continuously and automatically partitioned. You can view the current partitions by using the following statement. For example, if the current date is 2020-03-25, you can only see partitions in the time range from 2020-03-22 to 2020-03-28.
+After you enable dynamic partitions for a table, the input data is continuously and automatically partitioned. You can view the current partitions by using the following statement. For example, if the current date is 2020-03-25, you can only see partitions in the time range from 2020-03-25 to 2020-03-28.
+
+```SQL
+SHOW PARTITIONS FROM site_access;
+
+[types: [DATE]; keys: [2020-03-25]; ‥types: [DATE]; keys: [2020-03-26]; )
+[types: [DATE]; keys: [2020-03-26]; ‥types: [DATE]; keys: [2020-03-27]; )
+[types: [DATE]; keys: [2020-03-27]; ‥types: [DATE]; keys: [2020-03-28]; )
+[types: [DATE]; keys: [2020-03-28]; ‥types: [DATE]; keys: [2020-03-29]; )
+```
+
+If you want to create historical partitions when creating a table, you need to specify `dynamic_partition.history_partition_num` to define the number of historical partitions to be created. For example, if you set `dynamic_partition.history_partition_num` to `3` during table creation and the current date is 2020-03-25, you will only see partitions in the time range from 2020-03-22 to 2020-03-28.
 
 ```SQL
 SHOW PARTITIONS FROM site_access;

diff --git a/docs/zh/table_design/data_distribution/dynamic_partitioning.md b/docs/zh/table_design/data_distribution/dynamic_partitioning.md
@@ -68,6 +68,16 @@ SHOW PARTITIONS FROM site_access;
 
 假设当前时间为 2020-03-25，在调度动态分区时，会删除分区上界小于 2020-03-22 的分区，同时在调度时会创建今后 3 天的分区。则如上语句的返回结果中，`Range` 列显示当前分区的信息如下：
 
+```SQL
+[types: [DATE]; keys: [2020-03-25]; ‥types: [DATE]; keys: [2020-03-26]; )
+[types: [DATE]; keys: [2020-03-26]; ‥types: [DATE]; keys: [2020-03-27]; )
+[types: [DATE]; keys: [2020-03-27]; ‥types: [DATE]; keys: [2020-03-28]; )
+[types: [DATE]; keys: [2020-03-28]; ‥types: [DATE]; keys: [2020-03-29]; )
+```
+
+如果你希望在建表时同时创建历史分区，需要指定 `dynamic_partition.history_partition_num` 来定义要创建的历史分区数量。在建表时指定 `dynamic_partition.history_partition_num` 为 `3`，
+则会创建过去 3 天的历史分区，则如上语句的返回结果中，`Range` 列显示当前分区的信息如下：
+
 ```SQL
 [types: [DATE]; keys: [2020-03-22]; ‥types: [DATE]; keys: [2020-03-23]; )
 [types: [DATE]; keys: [2020-03-23]; ‥types: [DATE]; keys: [2020-03-24]; )