From 3dd447b7f016e00373a987e2fd03ff35488fc25a Mon Sep 17 00:00:00 2001
From: Hui Li <52318143+plum-lihui@users.noreply.github.com>
Date: Thu, 23 Dec 2021 18:48:05 +0800
Subject: [PATCH] Update docs.md

---
 documentation20/cn/12.taos-sql/docs.md | 40 ++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/documentation20/cn/12.taos-sql/docs.md b/documentation20/cn/12.taos-sql/docs.md
index 1ff25d0624..632a678b73 100755
--- a/documentation20/cn/12.taos-sql/docs.md
+++ b/documentation20/cn/12.taos-sql/docs.md
@@ -682,6 +682,46 @@ taos> SELECT SERVER_STATUS() AS status;
            1 |
 Query OK, 1 row(s) in set (0.000081s)
 ```
+函数_block_dist()使用说明
+语法
+
+SELECT _block_dist() FROM { tb_name | stb_name }
+
+功能说明：获得指定的（超级）表的数据块分布信息
+
+返回结果类型：字符串。
+
+
+适用数据类型：不能输入任何参数。
+
+嵌套子查询支持：不支持子查询或嵌套查询。
+
+
+说明：
+
+返回 FROM 子句中输入的表或超级表的数据块分布情况。不支持查询条件。
+
+返回的结果是该表或超级表的数据块所包含的行数的数据分布直方图。
+
+返回结果如下：
+```
+summary:
+5th=[392], 10th=[392], 20th=[392], 30th=[392], 40th=[792], 50th=[792] 60th=[792], 70th=[792], 80th=[792], 90th=[792], 95th=[792], 99th=[792] Min=[392(Rows)] Max=[800(Rows)] Avg=[666(Rows)] Stddev=[2.17] Rows=[2000], Blocks=[3], Size=[5.440(Kb)] Comp=[0.23] RowsInMem=[0] SeekHeaderTime=[1(us)]
+```
+上述信息的说明如下：
+1、查询的（超级）表所包含的存储在文件中的数据块（data block）中所包含的数据行的数量分布直方图信息：5%， 10%， 20%， 30%， 40%， 50%， 60%， 70%， 80%， 90%， 95%， 99% 的数值；
+<br/>2、所有数据块中，包含行数最少的数据块所包含的行数量， 其中的 Min 指标 392 行。
+<br/>3、所有数据块中，包含行数最多的数据块所包含的行数量， 其中的 Max 指标 800 行。
+<br/>4、所有数据块行数的算数平均值 666行（其中的 Avg 项）。
+<br/>5、所有数据块中行数分布的均方差为 2.17 ( stddev ）。
+<br/>6、数据块包含的行的总数为 2000 行（Rows）。
+<br/>7、数据块总数是 3 个数据块 （Blocks）。
+<br/>8、数据块占用磁盘空间大小 5.44 Kb （size）。
+<br/>9、压缩后的数据块的大小除以原始数据的所获得的压缩比例： 23%（Comp），及压缩后的数据规模是原始数据规模的 23%。
+<br/>10、内存中存在的数据行数是0，表示内存中没有数据缓存。
+<br/>11、获取数据块信息的过程中读取头文件的时间开销 1 微秒（SeekHeaderTime）。
+
+支持版本：指定计算算法的功能从2.1.0.x 版本开始，2.1.0.0之前的版本不支持指定使用算法的功能。
 
 #### TAOS SQL中特殊关键词
 
-- 
GitLab