Merge pull request #29464 from taosdata/docs/tsma_intro_doc

improve tsma doc
taosdata · Jan 7, 2025 · f242474 · f242474
2 parents 7b8221f + 1cc52e4
commit f242474
Show file tree

Hide file tree

Showing 4 changed files with 9 additions and 2 deletions.
diff --git a/docs/en/14-reference/03-taos-sql/28-tsma.md b/docs/en/14-reference/03-taos-sql/28-tsma.md
@@ -4,7 +4,11 @@ title: Time-Range Small Materialized Aggregates (TSMAs)
 slug: /tdengine-reference/sql-manual/manage-tsmas
 ---
 
-To improve the performance of aggregate function queries with large data volumes, window pre-aggregation (TSMA Time-Range Small Materialized Aggregates) objects are created. By using fixed time windows to pre-calculate specified aggregate functions and storing the results, query performance is enhanced by querying these pre-calculated results.
+In scenarios with large amounts of data, it is often necessary to query summary results for a certain period. As historical data increases or the time range expands, query time will also increase accordingly. By using materialized aggregation, the calculation results can be stored in advance, allowing subsequent queries to directly read the aggregated results without scanning the original data, such as the SMA (Small Materialized Aggregates) information within the current block.
+
+The SMA information within a block has a small granularity. If the query time range is in days, months, or even years, the number of blocks will be large. Therefore, TSMA (Time-Range Small Materialized Aggregates) supports users to specify a time window for materialized aggregation. By pre-calculating the data within a fixed time window and storing the calculation results, queries can be performed on the pre-calculated results to improve query performance.
+
+![TSMA Introduction](./assets/TSMA_intro.png)
 
 ## Creating TSMA
 

diff --git a/docs/en/14-reference/03-taos-sql/assets/TSMA_intro.png b/docs/en/14-reference/03-taos-sql/assets/TSMA_intro.png
diff --git a/docs/zh/14-reference/03-taos-sql/28-tsma.md b/docs/zh/14-reference/03-taos-sql/28-tsma.md
@@ -4,7 +4,10 @@ title: 窗口预聚集
 description: 窗口预聚集使用说明
 ---
 
-为了提高大数据量的聚合函数查询性能，通过创建窗口预聚集 (TSMA Time-Range Small Materialized Aggregates) 对象, 使用固定时间窗口对指定的聚集函数进行预计算，并将计算结果存储下来，查询时通过查询预计算结果以提高查询性能。
+在大数据量场景下, 经常需要查询某段时间内的汇总结果, 当历史数据变多或者时间范围变大时, 查询时间也会相应增加. 通过预聚集的方式可以将计算结果提前存储下来, 后续查询可以直接读取聚集结果, 而不需要扫描原始数据, 如当前Block内的SMA (Small Materialized Aggregates)信息.
+Block内的SMA信息粒度较小, 若查询时间范围是日,月甚至年时, Block的数量将会很多, 因此TSMA (Time-Range Small Materialized Aggregates)支持用户指定时间窗口进行预聚集. 通过对固定时间窗口内的数据进行预计算， 并将计算结果存储下来， 查询时通过查询预计算结果以提高查询性能。
+
+![TSMA Introduction](./pic/TSMA_intro.png)
 
 ## 创建TSMA
 

diff --git a/docs/zh/14-reference/03-taos-sql/pic/TSMA_intro.png b/docs/zh/14-reference/03-taos-sql/pic/TSMA_intro.png