Merge pull request #10494 from taosdata/taos-support-patch-3

Added instructions for TSZ algorithm

documentation20/cn/11.administrator/docs.md

@@ -1699,6 +1699,52 @@ COMPACT VNODES IN (vg_id1, vg_id2, ...)
 COMPACT 命令对指定的一个或多个 VGroup 启动碎片重整，系统会通过任务队列尽快安排重整操作的具体执行。COMPACT 指令所需的 VGroup id，可以通过 `SHOW VGROUPS;` 指令的输出结果获取；而且在 `SHOW VGROUPS;` 中会有一个 compacting 列，值为 2 时表示对应的 VGroup 处于排队等待进行重整的状态，值为 1 时表示正在进行碎片重整，为 0 时则表示并没有处于重整状态（未要求进行重整或已经完成重整）。
 
 需要注意的是，碎片重整操作会大幅消耗磁盘 I/O。因此在重整进行期间，有可能会影响节点的写入和查询性能，甚至在极端情况下导致短时间的阻写。
+   
+## <a class="anchor" id="status"></a>TSZ 压缩算法
+   
+ **TSZ 压缩算法简介**
+
+ TSZ 压缩算法是 TDengine 为浮点数据类型提供更加丰富的压缩功能，可以实现浮点数的有损至无损全状态压缩，相比原来在 TDengine 中原有压缩算法，TSZ 压缩算法压缩选项更丰富，压缩率更高，即使切到无损状态下对浮点数压缩，压缩率也会比原来的压缩算法高一倍。
+
+ **适合场景**
+
+ TSZ 压缩算法压缩率比原来的要高，但压缩时间会更长，即开启 TSZ 压缩算法写入速度会有一些下降，通常情况下会有 20% 左右的下降。影响写入速度是因为需要更多的 CPU 计算，所以从原始数据到压缩好数据的交付时间变长，导致写入速度变慢。如果您的服务器 CPU 配置很高的话，这个影响会变小甚至没有。
+
+ 另外如果设备产生了大量的高精度浮点数，存储占用的空间非常庞大，但实际使用并不需要那么高的精度时，可以通过 TSZ 压缩的有损压缩功能，把精度压缩至指定的长度，节约存储空间。
+
+ 总结：采集到了大量浮点数，存储时占用空间过大或出有存储空间不足，需要超高压缩率的场景。
+
+ **使用步骤**
+
+ - 检查版本支持，2.4.0.10 及之后 TDengine 的版本都支持此功能
+
+ - 配置选项开启功能，在 TDengine 的配置文件 taos.cfg 增加一行以下内容，打开 TSZ 功能
+
+  ```TSZ
+ lossyColumns     float|double
+ ```
+
+  - 根据自己需要配置其它选项，如果不配置都会按默认值处理。
+
+  - 重启服务，配置生效。
+
+  - 确认功能已开启，在服务启动过程中输出的信息如果有前面配置的内容，表明功能已生效：
+
+   ```TSZ Test
+ 02/22 10:49:27.607990 00002933 UTL  lossyColumns     float|double
+ ```
+
+  **注意事项**
+
+  - 确认版本是否支持
+
+  - 除了服务器启动时的输出的配置成功信息外，不再会有其它的信息输出是使用的哪种压缩算法，可以通过配置前后数据库文件大小来比较效果
+
+  - 如果浮点数类型列较少，看整体数据文件大小效果会不太明显
+
+  - 此压缩产生的数据文件中浮点数据部分将不能被 2.4.0.10 以下的版本解析，即不向下兼容，使用时避免更换回旧版本，以免数据不能被读取出来。
+
+  - 在使用过程中允许反复开启和关闭 TSZ 压缩选项的操作，前后两种压缩算法产生的数据都能正常读取。
 
 ## <a class="anchor" id="directories"></a>文件目录结构