merge with develop

CMakeLists.txt

@@ -26,6 +26,13 @@ SET(CMAKE_VERBOSE_MAKEFILE ON)
 #     open the file named TDengine.sln
 #
 
+SET(TD_GODLL FALSE)
+IF (${DLLTYPE} MATCHES "go")
+  ADD_DEFINITIONS(-D_TD_GO_DLL_)
+  MESSAGE(STATUS "input dll type: " ${DLLTYPE})
+  SET(TD_GODLL TRUE)
+ENDIF ()
+
 IF (NOT DEFINED TD_CLUSTER)
   MESSAGE(STATUS "Build the Lite Version")
   SET(TD_CLUSTER FALSE)
@@ -41,35 +48,44 @@ IF (NOT DEFINED TD_CLUSTER)
   SET(TD_ARM FALSE)
   SET(TD_ARM_64 FALSE)
   SET(TD_ARM_32 FALSE)
+  SET(TD_MIPS FALSE)
   SET(TD_MIPS_64 FALSE)
+  SET(TD_MIPS_32 FALSE)
   SET(TD_DARWIN_64 FALSE)
   SET(TD_WINDOWS_64 FALSE)
 
   # if generate ARM version:
-  #   cmake -DARMVER=arm32 .. or cmake -DARMVER=arm64
-  IF (${ARMVER} MATCHES "arm32")
+  #   cmake -DCPUTYPE=aarch32 .. or cmake -DCPUTYPE=aarch64
+  IF (${CPUTYPE} MATCHES "aarch32")
     SET(TD_ARM TRUE)
     SET(TD_ARM_32 TRUE)
     ADD_DEFINITIONS(-D_TD_ARM_)
     ADD_DEFINITIONS(-D_TD_ARM_32_)
-  ELSEIF (${ARMVER} MATCHES "arm64")
+  ELSEIF (${CPUTYPE} MATCHES "aarch64")
     SET(TD_ARM TRUE)
     SET(TD_ARM_64 TRUE)
     ADD_DEFINITIONS(-D_TD_ARM_)
     ADD_DEFINITIONS(-D_TD_ARM_64_)
-  ENDIF ()
-
-  IF (TD_ARM)
-    ADD_DEFINITIONS(-D_TD_ARM_)
-    IF (TD_ARM_32)
-      ADD_DEFINITIONS(-D_TD_ARM_32_)
-    ELSEIF (TD_ARM_64)
-      ADD_DEFINITIONS(-D_TD_ARM_64_)
+  ELSEIF (${CPUTYPE} MATCHES "mips64")
+    SET(TD_MIPS TRUE)
+    SET(TD_MIPS_64 TRUE)
+    ADD_DEFINITIONS(-D_TD_MIPS_)
+    ADD_DEFINITIONS(-D_TD_MIPS_64_)
+  ELSEIF (${CPUTYPE} MATCHES "x64")
+    MESSAGE(STATUS "input cpuType: " ${CPUTYPE})
+  ELSEIF (${CPUTYPE} MATCHES "x86")
+    MESSAGE(STATUS "input cpuType: " ${CPUTYPE})
   ELSE ()
-      EXIT ()
-    ENDIF ()
+    MESSAGE(STATUS "input cpuType: " ${CPUTYPE})
   ENDIF ()
 
+  #
+  # Get OS information and store in variable TD_OS_INFO.
+  #
+  execute_process(COMMAND chmod 777 ${TD_COMMUNITY_DIR}/packaging/tools/get_os.sh)
+  execute_process(COMMAND ${TD_COMMUNITY_DIR}/packaging/tools/get_os.sh "" OUTPUT_VARIABLE TD_OS_INFO)
+  MESSAGE(STATUS "The current os is " ${TD_OS_INFO})
+
   IF (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
     IF (${CMAKE_SIZEOF_VOID_P} MATCHES 8)
       SET(TD_LINUX_64 TRUE)
@@ -150,6 +166,12 @@ IF (NOT DEFINED TD_CLUSTER)
     ENDIF ()
     ADD_DEFINITIONS(-DLINUX)
     ADD_DEFINITIONS(-D_REENTRANT -D__USE_POSIX -D_LIBC_REENTRANT)
+    IF (${TD_OS_INFO} MATCHES "Alpine")
+      MESSAGE(STATUS "The current OS is Alpine, append extra flags")
+      SET(COMMON_FLAGS "${COMMON_FLAGS} -largp")
+      link_libraries(/usr/lib/libargp.a)
+      ADD_DEFINITIONS(-D_ALPINE)
+    ENDIF ()
   ELSEIF (TD_LINUX_32)
     IF (NOT TD_ARM)
       EXIT ()
@@ -160,11 +182,19 @@ IF (NOT DEFINED TD_CLUSTER)
     ADD_DEFINITIONS(-DLINUX)
     ADD_DEFINITIONS(-D_REENTRANT -D__USE_POSIX -D_LIBC_REENTRANT)
     ADD_DEFINITIONS(-DUSE_LIBICONV)
+    IF (${TD_OS_INFO} MATCHES "Alpine")
+      MESSAGE(STATUS "The current OS is Alpine, add extra flags")
+      SET(COMMON_FLAGS "${COMMON_FLAGS} -largp")
+      link_library(/usr/lib/libargp.a)
+      ADD_DEFINITIONS(-D_ALPINE)
+    ENDIF ()
   ELSEIF (TD_WINDOWS_64)
     SET(CMAKE_GENERATOR "NMake Makefiles" CACHE INTERNAL "" FORCE)
+    IF (NOT TD_GODLL)
       SET(COMMON_FLAGS "/nologo /WX- /Oi /Oy- /Gm- /EHsc /MT /GS /Gy /fp:precise /Zc:wchar_t /Zc:forScope /Gd /errorReport:prompt /analyze-")
       SET(DEBUG_FLAGS "/Zi /W3 /GL")
       SET(RELEASE_FLAGS "/W0 /GL")
+    ENDIF ()
     ADD_DEFINITIONS(-DWINDOWS)
     ADD_DEFINITIONS(-D__CLEANUP_C)
     ADD_DEFINITIONS(-DPTW32_STATIC_LIB)
@@ -230,6 +260,7 @@ IF (NOT DEFINED TD_CLUSTER)
     INSTALL(CODE "execute_process(COMMAND ${TD_MAKE_INSTALL_SH} ${TD_COMMUNITY_DIR} ${PROJECT_BINARY_DIR})")  
   ELSEIF (TD_WINDOWS_64)
     SET(CMAKE_INSTALL_PREFIX C:/TDengine)
+    IF (NOT TD_GODLL)
       INSTALL(DIRECTORY ${TD_COMMUNITY_DIR}/src/connector/go DESTINATION connector)
       INSTALL(DIRECTORY ${TD_COMMUNITY_DIR}/src/connector/grafana DESTINATION connector)
       INSTALL(DIRECTORY ${TD_COMMUNITY_DIR}/src/connector/python DESTINATION connector)
@@ -245,6 +276,10 @@ IF (NOT DEFINED TD_CLUSTER)
       IF (TD_MVN_INSTALLED)
         INSTALL(FILES ${LIBRARY_OUTPUT_PATH}/taos-jdbcdriver-1.0.2-dist.jar DESTINATION connector/jdbc)
       ENDIF ()
+    ELSE ()
+      INSTALL(FILES ${LIBRARY_OUTPUT_PATH}/libtaos.dll DESTINATION driver)
+      INSTALL(FILES ${LIBRARY_OUTPUT_PATH}/libtaos.dll.a DESTINATION driver)
+    ENDIF ()
   ENDIF ()
 ENDIF ()
 

README.md

@@ -45,10 +45,10 @@ mkdir build && cd build
 cmake .. && cmake --build .
 ```
 
-if compiling on an arm64 processor, you need add one parameter:
+if compiling on an aarch64 processor, you need add one parameter:
 
 ```cmd
-cmake .. -DARMVER=arm64 && cmake --build .
+cmake .. -DCPUTYPE=aarch64 && cmake --build .
 ```
 
 # Quick Run

deps/iconv/iconv.c

@@ -175,7 +175,10 @@ static const struct alias sysdep_aliases[] = {
 #ifdef __GNUC__
 __inline
 #endif
-const struct alias *
+// gcc -o0 bug fix 
+// see http://git.savannah.gnu.org/gitweb/?p=libiconv.git;a=blobdiff;f=lib/iconv.c;h=31853a7f1c47871221189dbf597473a16d8a8da7;hp=5a1a32597fa3efc5f69624d37a2eb96f308cd241;hb=b29089d8b43abc8fba073da7e6dccaeba56b2b70;hpb=0a04404c90d6a725b8b6bbcd65e10c5fcf5993e9
+
+static const struct alias *
 aliases2_lookup (register const char *str)
 {
   const struct alias * ptr;

documentation/webdocs/markdowndocs/Connections with other Tools-ch.md

@@ -46,11 +46,11 @@ TDengine的Grafana插件在安装包的/usr/local/taos/connector/grafana目录
 
 #### 配置数据源
 
-用户可以直接通过localhost:3000的网址，登录Grafana服务器(用户名/密码:admin/admin)，通过左侧`Configuration -> Data Sources`可以添加数据源，如下图所示：
+用户可以直接通过 localhost:3000 的网址，登录 Grafana 服务器(用户名/密码:admin/admin)，通过左侧 `Configuration -> Data Sources` 可以添加数据源，如下图所示：
 
 ![img](../assets/add_datasource1.jpg)
 
-点击 `Add data source` 可进入新增数据源页面，在查询框中输入TDengine 可选择添加，如下图所示：
+点击 `Add data source` 可进入新增数据源页面，在查询框中输入 TDengine 可选择添加，如下图所示：
 
 ![img](../assets/add_datasource2.jpg)
 
@@ -58,7 +58,7 @@ TDengine的Grafana插件在安装包的/usr/local/taos/connector/grafana目录
 
 ![img](../assets/add_datasource3.jpg)
 
-* HostTDengine：集群的中任意一台服务器的IP地址与TDengine RESTful接口的端口号(6020)，默认http://localhost:6020。
+* Host： TDengine 集群的中任意一台服务器的 IP 地址与 TDengine RESTful 接口的端口号(6020)，默认 http://localhost:6020。
 * User：TDengine 用户名。
 * Password：TDengine 用户密码。
 
@@ -83,7 +83,7 @@ TDengine的Grafana插件在安装包的/usr/local/taos/connector/grafana目录
 ![img](../assets/create_dashboard2.jpg)
 
 > 关于如何使用Grafana创建相应的监测界面以及更多有关使用Grafana的信息，请参考Grafana官方的[文档](https://grafana.com/docs/)。
-> 
+
 #### 导入 Dashboard
 
 在 Grafana 插件目录 /usr/local/taos/connector/grafana/tdengine/dashboard/ 下提供了一个 `tdengine-grafana.json` 可导入的 dashboard。

documentation/webdocs/markdowndocs/TAOS SQL-ch.md

 # TAOS SQL
 
-TDengine提供类似SQL语法，用户可以在TDengine Shell中使用SQL语句操纵数据库，也可以通过C/C++, Java(JDBC), Python, Go等各种程序来执行SQL语句。 
+本文档说明TAOS SQL支持的语法规则、主要查询功能、支持的SQL查询函数，以及常用技巧等内容。阅读本文档需要读者具有基本的SQL语言的基础。
+
+TAOS SQL是用户对TDengine进行数据写入和查询的主要工具。TAOS SQL为了便于用户快速上手，在一定程度上提供类似于标准SQL类似的风格和模式。严格意义上，TAOS SQL并不是也不试图提供SQL标准的语法。此外，由于TDengine针对的时序性结构化数据不提供修改和更新功能，因此在TAO SQL中不提供数据更新和数据删除的相关功能。
 
 本章节SQL语法遵循如下约定：
 
@@ -9,11 +11,41 @@ TDengine提供类似SQL语法，用户可以在TDengine Shell中使用SQL语句
 - | 表示多选一，选择其中一个即可，但不能输入|本身
 - … 表示前面的项可重复多个
 
+为更好地说明SQL语法的规则及其特点，本文假设存在一个数据集。该数据集是针对两种类型的设备温度（湿度）传感器、气压（海拔）传感器建立的数据模型。
+针对温度传感器，具有超级表（super table） temp_stable。其数据模型如下：
+```
+taos> describe temp_stable;
+Field       | Type     | Length | Note |
+=======================================================================================================
+ts          |TIMESTAMP | 8      |      |
+temperature |FLOAT     | 4      |      |
+humidity    |TINYINT   | 1      |      |
+status      |TINYINT   | 1      |      |
+deviceid    |BIGINT    | 12     |tag   |
+location    |BINARY    | 20     |tag   |
+```
+数据集包含2个温度传感器的数据，按照TDengine的建模规则，对应2个子表，其名称分别是 temp_tb_1，temp_tb_2 。
+针对压力（海拔）传感器，具有超级表（super table） pressure_stable。其数据模型如下：
+数据集包含2个压力传感器数据，对应2个子表，分别是 press_tb_1，press_tb_2。
+
+```text
+taos> describe pressure_stable;
+Field      | Type     | Length | Note |
+=======================================================================================================
+ts         |TIMESTAMP | 8      |      |
+height     |FLOAT     | 4      |      |
+pressure   |FLOAT     | 4      |      |
+devstat    |TINYINT   | 1      |      |
+id         |BIGINT    | 8      |tag   |
+city       |NCHAR     | 20     |tag   |
+longitude  |FLOAT     | 4      |tag   |
+latitude   |FLOAT     | 4      |tag   |
+```
 ## 支持的数据类型
 
 使用TDengine，最重要的是时间戳。创建并插入记录、查询历史记录的时候，均需要指定时间戳。时间戳有如下规则：
 
-- 时间格式为YYYY-MM-DD HH:mm:ss.MS, 默认时间分辨率为毫秒。比如：2017-08-12 18:25:58.128
+- 时间格式为```YYYY-MM-DD HH:mm:ss.MS```, 默认时间分辨率为毫秒。比如：```2017-08-12 18:25:58.128```
 - 内部函数now是服务器的当前时间
 - 插入记录时，如果时间戳为0，插入数据时使用服务器当前时间
 - Epoch Time: 时间戳也可以是一个长整数，表示从1970-01-01 08:00:00.000开始的毫秒数
@@ -27,13 +59,13 @@ TDengine缺省的时间戳是毫秒精度，但通过修改配置参数enableMic
 |      |   类型    | Bytes  | 说明                                                         |
 | ---- | :-------: | ------ | ------------------------------------------------------------ |
 | 1    | TIMESTAMP | 8      | 时间戳。最小精度毫秒。从格林威治时间 1970-01-01 00:00:00.000 (UTC/GMT) 开始，计时不能早于该时间。 |
-| 2    |    INT    | 4      | 整型，范围 [-2^31+1,   2^31-1], -2^31被用作Null值            |
-| 3    |  BIGINT   | 8      | 长整型，范围 [-2^59,   2^59]                                 |
+| 2    |    INT    | 4      | 整型，范围 [-2^31+1,   2^31-1], -2^31用作Null           |
+| 3    |  BIGINT   | 8      | 长整型，范围 [-2^63+1,   2^63-1], -2^63用于NULL                                 |
 | 4    |   FLOAT   | 4      | 浮点型，有效位数6-7，范围 [-3.4E38, 3.4E38]                  |
 | 5    |  DOUBLE   | 8      | 双精度浮点型，有效位数15-16，范围 [-1.7E308,   1.7E308]      |
 | 6    |  BINARY   | 自定义 | 用于记录字符串，最长不能超过504 bytes。binary仅支持字符串输入，字符串两端使用单引号引用，否则英文全部自动转化为小写。使用时须指定大小，如binary(20)定义了最长为20个字符的字符串，每个字符占1byte的存储空间。如果用户字符串超出20字节，将被自动截断。对于字符串内的单引号，可以用转义字符反斜线加单引号来表示， 即 **\’**。 |
-| 7    | SMALLINT  | 2      | 短整型， 范围 [-32767, 32767]                                |
-| 8    |  TINYINT  | 1      | 单字节整型，范围 [-127, 127]                                 |
+| 7    | SMALLINT  | 2      | 短整型， 范围 [-32767, 32767], -32768用于NULL                                |
+| 8    |  TINYINT  | 1      | 单字节整型，范围 [-127, 127], -128用于NULL                                |
 | 9    |   BOOL    | 1      | 布尔型，{true,   false}                                      |
 | 10   |   NCHAR   | 自定义 | 用于记录非ASCII字符串，如中文字符。每个nchar字符占用4bytes的存储空间。字符串两端使用单引号引用，字符串内的单引号需用转义字符 **\’**。nchar使用时须指定字符串大小，类型为nchar(10)的列表示此列的字符串最多存储10个nchar字符，会固定占用40bytes的空间。如用户字符串长度超出声明长度，则将被自动截断。 |
 
@@ -165,19 +197,172 @@ TDengine缺省的时间戳是毫秒精度，但通过修改配置参数enableMic
 
 ## 数据查询
 
-###查询语法是：
+### 查询语法：
 
 ```mysql
-SELECT {* | expr_list} FROM tb_name
-    [WHERE where_condition]
-    [ORDER BY _c0 { DESC | ASC }]
-    [LIMIT limit [, OFFSET offset]]
-    [>> export_file]
+SELECT [DISTINCT] select_expr [, select_expr ...]
+FROM {tb_name_list}
+[WHERE where_condition]
+[INTERVAL [interval_offset,] interval_val]
+[FILL fill_val]
+[SLIDING fill_val]
+[GROUP BY col_list]
+[ORDER BY col_list { DESC | ASC }]
+[HAVING expr_list]
+[SLIMIT limit_val [, SOFFSET offset_val]]
+[LIMIT limit_val [, OFFSET offset_val]]
+[>> export_file]
+```
+#### SELECT子句
+一个选择子句可以是联合查询（UNION）和另一个查询的子查询（SUBQUERY）。
 
-SELECT function_list FROM tb_name
-    [WHERE where_condition]
-    [LIMIT limit [, OFFSET offset]]
-    [>> export_file]
+##### 通配符
+通配符 * 可以用于代指全部列。对于普通表，结果中只有普通列。
+```
+taos> select * from temp_tb_1;
+ts                   | temperature |humidity|status|
+============================================================
+19-04-28 14:22:07.000| 20.00000    | 34     | 1    |
+19-04-28 14:22:08.000| 21.50000    | 38     | 1    |
+19-04-28 14:22:09.000| 21.30000    | 38     | 1    |
+19-04-28 14:22:10.000| 21.20000    | 38     | 1    |
+19-04-28 14:22:11.000| 21.30000    | 35     | 0    |
+19-04-28 14:22:12.000| 22.00000    | 34     | 0    |
+```
+在针对超级表，通配符包含 _标签列_ 。
+```
+taos> select * from temp_stable;
+ts                   | temperature |humidity|status| deviceid | location |
+==============================================================================================
+19-04-28 14:22:07.000| 21.00000    | 37     | 1    |54197     |beijing   |
+19-04-28 14:22:07.000| 20.00000    | 34     | 1    |91234     |beijing   |
+19-04-28 14:22:08.000| 21.50000    | 38     | 1    |91234     |beijing   |
+19-04-28 14:22:09.000| 21.30000    | 38     | 1    |91234     |beijing   |
+19-04-28 14:22:10.000| 21.20000    | 38     | 1    |91234     |beijing   |
+19-04-28 14:22:11.000| 21.30000    | 35     | 0    |91234     |beijing   |
+19-04-28 14:22:12.000| 22.00000    | 34     | 0    |91234     |beijing   |
+```
+通配符支持表名前缀，以下两个SQL语句均为返回全部的列：
+```
+select * from temp_tb_1;
+select temp_tb_1.* from temp_tb_1;
+```
+在Join查询中，带前缀的\*和不带前缀\*返回的结果有差别， \*返回全部表的所有列数据（不包含标签），带前缀的通配符，则只返回该表的列数据。
+```
+taos> select * from temp_tb_1,temp_tb_2 where temp_tb_1.ts=temp_tb_2.ts;
+ts                   | temperature |humidity|status| ts                   | temperature |humidity|status|
+========================================================================================================================
+19-04-28 14:22:07.000| 20.00000    | 34     | 1    | 19-04-28 14:22:07.000| 21.00000    | 37     | 1    |
+```
+
+```
+taos> select temp_tb_1.* from temp_tb_1,temp_tb_2 where temp_tb_1.ts=temp_tb_2.ts;
+ts                   | temperature |humidity|status|
+============================================================
+19-04-28 14:22:07.000| 20.00000    | 34     | 1    |
+```
+
+在使用SQL函数来进行查询过程中，部分SQL函数支持通配符操作。其中的区别在于：
+```count(\*)```函数只返回一列。```first```、```last```、```last_row```函数则是返回全部列。
+
+```
+taos> select count(*) from temp_tb_1;
+count(*)  |
+======================
+1         |
+```
+
+```
+taos> select first(*) from temp_tb_1;
+first(ts)            | first(temperature) |first(humidity)|first(status)|
+==========================================================================
+19-04-28 14:22:07.000| 20.00000           | 34            | 1           |
+```
+
+#### 结果集列名
+
+```SELECT```子句中，如果不指定返回结果集合的列名，结果集列名称默认使用```SELECT```子句中的表达式名称作为列名称。此外，用户可使用```AS```来重命名返回结果集合中列的名称。例如：
+```
+taos> select ts, ts as primary_key_ts from temp_tb_1;
+ts                   | primary_key_ts       |
+==============================================
+19-04-28 14:22:07.000| 19-04-28 14:22:07.000|
+```
+但是针对```first(*)```、```last(*)```、```last_row(*)```不支持针对单列的重命名。
+
+#### DISTINCT修饰符*
+只能用于修饰标签列（TAGS）的结果，不能用于修饰普通列来获得去重后的结果。并且应用```DISTINCT```以后，只能进行单列的标签输出。
+```count(distinct column_name)```用以返回近似的不重复结果的数量，该结果是近似值。
+
+#### 隐式结果列
+```Select_exprs```可以是表所属列的列名，也可以是基于列的函数表达式或计算式，数量的上限256个。当用户使用了```interval```或```group by tags```的子句以后，在最后返回结果中会强制返回时间戳列（第一列）和group by子句中的标签列。后续的版本中可以支持关闭group by子句中隐式列的输出，列输出完全由select子句控制。
+
+#### 表（超级表）列表
+
+FROM关键字后面可以是若干个表（超级表）列表，也可以是子查询的结果。
+如果没有指定用户的当前数据库，可以在表名称之前使用数据库的名称来指定表所属的数据库。例如：```sample.temp_tb_1``` 方式来跨库使用表。
+```
+SELECT * FROM sample.temp_tb_1;
+------------------------------
+use sample;
+SELECT * FROM temp_tb_1;
+```
+From子句中列表可以使用别名来让SQL整体更加简单。
+```
+SELECT t.ts FROM temp_tb_1 t ;
+```
+> 暂不支持FROM子句的表别名
+
+#### 特殊功能
+部分特殊的查询功能可以不使用FROM子句执行。获取当前所在的数据库 database() 
+```
+taos> SELECT database();
+database() |
+=================================
+sample     |
+```
+如果登录的时候没有指定默认数据库，且没有使用```use``命令切换数据，则返回NULL。
+```
+taos> select database();
+database() |
+=================================
+NULL       |
+```
+获取服务器和客户端版本号:
+```
+SELECT client_version()
+SELECT server_version()
+```
+服务器状态检测语句。如果服务器正常，返回一个数字（例如 1）。如果服务器异常，返回error code。该SQL语法能兼容连接池对于TDengine状态的检查及第三方工具对于数据库服务器状态的检查。并可以避免出现使用了错误的心跳检测SQL语句导致的连接池连接丢失的问题。
+```
+SELECT server_status()
+SELECT server_status() AS result
+```
+#### TAOS SQL中特殊关键词
+
+ >   TBNAME： 在超级表查询中可视为一个特殊的标签，代表查询涉及的子表名<br>
+    \_c0: 表示表（超级表）的第一列
+
+#### 小技巧
+获取一个超级表所有的子表名及相关的标签信息：
+```
+SELECT TBNAME, location FROM temp_stable
+```
+统计超级表下辖子表数量：
+```
+SELECT COUNT(TBNAME) FROM temp_stable
+```
+以上两个查询均只支持在Where条件子句中添加针对标签（TAGS）的过滤条件。例如：
+```
+taos> select count(tbname) from temp_stable;
+count(tbname) |
+======================
+2             |
+
+taos> select count(tbname) from temp_stable where deviceid > 60000;
+count(tbname) |
+======================
+1             |
 ```
 
 - 可以使用* 返回所有列，或指定列名。可以对数字列进行四则运算，可以给输出的列取列名

documentation/webdocs/markdowndocs/administrator-ch.md

@@ -33,11 +33,26 @@ taosd -c /home/user
 
 下面仅仅列出一些重要的配置参数，更多的参数请看配置文件里的说明。各个参数的详细介绍及作用请看前述章节。**注意：配置修改后，需要重启*taosd*服务才能生效。**
 
-**internalIp**
-- 默认值：操作配置的IP地址列表中的第一个IP地址
+**privateIp**
+- 默认值：物理节点IP地址列表中的第一个IP地址
 
 对外提供服务的IP地址。
 
+**publicIp**
+- 默认值：与privateIp相同
+
+对于阿里等云平台，此为公网IP地址，publicIp在内部映射为对应的privateIP地址，仅对企业版有效。
+
+**masterIp**
+- 默认值：与privateIp相同
+
+集群内第一个物理节点的privateIp地址，仅对企业版有效。
+
+**secondIp**
+- 默认值：与privateIp相同
+
+集群内第二个物理节点的privateIp地址，仅对企业版有效。
+
 **mgmtShellPort**
 - 默认值： _6030_
 
@@ -50,6 +65,28 @@ taosd -c /home/user
 数据节点与客户端通信使用的TCP/UDP端口号。
 > 端口范围 _6035_ - _6039_ 的5个端口用于UDP通信。此外，还使用端口 _6035_ 用于TCP通讯。
 
+**mgmtVnodePort**
+- 默认值： _6040_
+
+管理节点与数据节点通信使用的TCP/UDP端口号，仅对企业版有效。
+> 端口范围 _6040_ - _6044_ 的5个端口用于UDP通信。此外，还使用端口 _6040_ 用于TCP通讯。
+
+**vnodeVnodePort**
+- 默认值： _6045_
+
+数据节点与数据节点通信使用的TCP/UDP端口号，仅对企业版有效。
+> 端口范围 _6045_ - _6049_ 的5个端口用于UDP通信。此外，还使用端口 _6045_ 用于TCP通讯。
+
+**mgmtMgmtPort**
+- 默认值： _6050_
+
+管理节点与管理节点通信使用的UDP端口号，仅对企业版有效。
+
+**mgmtSyncPort**
+- 默认值： _6050_
+
+管理节点与管理节点同步使用的TCP端口号，仅对企业版有效。
+
 **httpPort**
 - 默认值： _6020_
 

documentation/webdocs/markdowndocs/connector-ch.md

@@ -880,7 +880,7 @@ npm install td-connector
 ```
 我们建议用户使用npm 安装node.js连接器。如果您没有安装npm, 可以将*src/connector/nodejs/*拷贝到您的nodejs 项目目录下
 
-To interact with TDengine, we make use of the [node-gyp](https://github.com/nodejs/node-gyp) library. To install, you will need to install the following depending on platform (the following instructions are quoted from node-gyp)我们使用[node-gyp](https://github.com/nodejs/node-gyp)和TDengine服务端进行交互。安装node.js 连接器之前，还需安装以下软件：
+我们使用[node-gyp](https://github.com/nodejs/node-gyp)和TDengine服务端进行交互。安装node.js 连接器之前，还需安装以下软件：
 
 ### Unix
 
@@ -939,7 +939,7 @@ To interact with TDengine, we make use of the [node-gyp](https://github.com/node
 
 #### 连接
 
-使用node.js连接器时，必须先require```td-connector```，然后使用 ```taos.connect``` 函数。```taos.connect``` 函数必须提供的参数是```host```，其它参数在没有提供的情况下会使用如下的默认值。最后需要初始化```cursor``` 来和TDengine服务端通信 
+使用node.js连接器时，必须先<em>require</em> ```td-connector```，然后使用 ```taos.connect``` 函数。```taos.connect``` 函数必须提供的参数是```host```，其它参数在没有提供的情况下会使用如下的默认值。最后需要初始化```cursor``` 来和TDengine服务端通信 
 
 ```javascript
 const taos = require('td-connector');
@@ -1043,7 +1043,7 @@ https://gitee.com/maikebing/Maikebing.EntityFrameworkCore.Taos
 
 ### 客户端安装
 
-在Windows操作系统下，TDengine提供64位的Windows客户端，客户端安装程序为.exe文件，运行该文件即可安装，安装路径为C:\TDengine。Windows的客户端可运行在主流的64位Windows平台之上，客户端目录结构如下：
+在Windows操作系统下，TDengine提供64位的Windows客户端([点击下载](https://www.taosdata.com/cn/all-downloads/#tdengine_win-list))，客户端安装程序为.exe文件，运行该文件即可安装，安装路径为C:\TDengine。Windows的客户端可运行在主流的64位Windows平台之上，客户端目录结构如下：
 
 ```
 ├── cfg

importSampleData/.gitignore

+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+.idea/
+.vscode/
\ No newline at end of file

importSampleData/README.md

+## 样例数据导入
+
+该工具可以根据用户提供的 `json` 或 `csv` 格式样例数据文件快速导入 `TDengine`，目前仅能在 Linux 上运行。
+
+为了体验写入和查询性能，可以对样例数据进行横向、纵向扩展。横向扩展是指将一个表（监测点）的数据克隆到多张表，纵向扩展是指将样例数据中的一段时间范围内的数据在时间轴上复制。该工具还支持历史数据导入至当前时间后持续导入，这样可以测试插入和查询并行进行的场景，以模拟真实环境。
+
+## 下载安装
+
+### 下载可执行文件
+
+由于该工具使用 go 语言开发，为了方便使用，项目中已经提供了编译好的可执行文件 `bin/taosimport`。通过 `git clone https://github.com/taosdata/TDengine.git` 命令或者直接下载 `ZIP` 文件解压进入样例导入程序目录 `cd importSampleData`，执行 `bin/taosimport`。
+
+### go 源码编译
+
+由于该工具使用 go 语言开发，编译之前需要先安装 go，具体请参考 [Getting Started][2]，而且需要安装 TDengine 的 Go Connector, 具体请参考[TDengine 连接器文档][3]。安装完成之后，执行以下命令即可编译成可执行文件 `bin/taosimport`。
+```shell
+go get https://github.com/taosdata/TDengine/importSampleData
+cd $GOPATH/src/github.com/taosdata/TDengine/importSampleData
+go build -o bin/taosimport app/main.go
+```
+
+> 注：由于目前 TDengine 的 go connector 只支持 linux 环境，所以该工具暂时只能在 linux 系统中运行。
+> 如果 go get 失败可以下载之后复制 `github.com/taosdata/TDengine/importSampleData` 文件夹到 $GOPATH 的 src 目录下再执行 `go build -o bin/taosimport app/main.go`。
+
+## 使用
+
+### 快速体验
+
+执行命令 `bin/taosimport` 会根据默认配置执行以下操作：
+1. 创建数据库
+
+   自动创建名称为 `test_yyyyMMdd` 的数据库。
+   
+2. 创建超级表
+
+   根据配置文件 `config/cfg.toml` 中指定的 `sensor_info` 场景信息创建相应的超级表。
+   > 建表语句： create table s_sensor_info(ts timestamp, temperature int, humidity float) tags(location binary(20), color binary(16), devgroup int);
+
+3. 自动建立子表并插入数据
+
+   根据配置文件 `config/cfg.toml` 中 `sensor_info` 场景指定的 `data/sensor_info.csv` 样例数据进行横向扩展 `100` 倍(可通过 hnum 参数指定)，即自动创建 `10*100=1000` 张子表(默认样例数据中有 10 张子表，每张表 100 条数据)，启动 `10` 个线程（可通过 thread 参数指定）对每张子表循环导入 `1000` 次(可通过 vnum 参数指定)。
+
+进入 `taos shell`，可运行如下查询验证：
+
+* 查询记录数
+
+    ```shell
+    taos> use test_yyyyMMdd;
+    taos> select count(*) from s_sensor_info;
+    ```
+* 查询各个分组的记录数
+
+    ```shell
+    taos> select count(*) from s_sensor_info group by devgroup;
+    ```
+* 按 1h 间隔查询各聚合指标
+
+    ```shell
+    taos> select count(temperature), sum(temperature), avg(temperature) from s_sensor_info interval(1h);
+    ```
+* 查询指定位置最新上传指标
+
+    ```shell
+    taos> select last(*) from s_sensor_info where location = 'beijing';
+    ```
+> 更多查询及函数使用请参考 [数据查询][4]
+
+### 详细使用说明
+
+执行命令 `bin/taosimport -h` 可以查看详细参数使用说明：
+
+* -cfg string
+    
+    导入配置文件路径，包含样例数据文件相关描述及对应 TDengine 配置信息。默认使用 `config/cfg.toml`。
+    
+* -cases string
+
+    需要导入的场景名称，该名称可从 -cfg 指定的配置文件中 `[usecase]` 查看，可同时导入多个场景，中间使用逗号分隔，如：`sensor_info,camera_detection`，默认为 `sensor_info`。
+    
+* -hnum int
+
+    需要将样例数据进行横向扩展的倍数，假设原有样例数据包含 1 张子表 `t_0` 数据，指定 hnum 为 2 时会根据原有表名创建 `t_0、t_1` 两张子表。默认为 100。
+    
+* -vnum int
+
+    需要将样例数据进行纵向扩展的次数，如果设置为 0 代表将历史数据导入至当前时间后持续按照指定间隔导入。默认为 1000，表示将样例数据在时间轴上纵向复制1000 次。
+
+* -delay int
+    
+    当 vnum 设置为 0 时持续导入的时间间隔，默认为所有场景中最小记录间隔时间的一半，单位 ms。
+
+* -tick int
+
+    打印统计信息的时间间隔，默认 2000 ms。
+
+* -save int
+
+    是否保存统计信息到 tdengine 的 statistic 表中，1 是，0 否， 默认 0。
+
+* -auto int
+    
+    是否自动生成样例数据中的主键时间戳，1 是，0 否， 默认 0。
+    
+* -start string
+
+    导入的记录开始时间，格式为 `"yyyy-MM-dd HH:mm:ss.SSS"`，不设置会使用样例数据中最小时间，设置后会忽略样例数据中的主键时间，会按照指定的 start 进行导入。如果 auto 为 1，则必须设置 start，默认为空。
+    
+* -interval int
+
+    导入的记录时间间隔，该设置只会在指定 `auto=1` 之后生效，否则会根据样例数据自动计算间隔时间。单位为毫秒，默认 1000。
+  
+* -thread int
+ 
+    执行导入数据的线程数目，默认为 10。
+  
+* -batch int
+    
+    执行导入数据时的批量大小，默认为 100。批量是指一次写操作时，包含多少条记录。
+ 
+* -host string
+
+    导入的 TDengine 服务器 IP，默认为 127.0.0.1。
+  
+* -port int
+
+    导入的 TDengine 服务器端口，默认为 6030。
+  
+* -user string
+
+    导入的 TDengine 用户名，默认为 root。
+  
+* -password string
+
+    导入的 TDengine 用户密码，默认为 taosdata。
+
+* -dropdb int
+    
+    导入数据之前是否删除数据库，1 是，0 否， 默认 0。
+
+* -db string
+
+    导入的 TDengine 数据库名称，默认为 test_yyyyMMdd。
+  
+* -dbparam string
+
+    当指定的数据库不存在时，自动创建数据库时可选项配置参数，如 `days 10 cache 16000 ablocks 4`，默认为空。
+
+### 常见使用示例
+
+* `bin/taosimport -cfg config/cfg.toml -cases sensor_info,camera_detection -hnum 1 -vnum 10`
+
+    执行上述命令后会将 sensor_info、camera_detection 两个场景的数据各导入 10 次。
+
+* `bin/taosimport -cfg config/cfg.toml -cases sensor_info -hnum 2 -vnum 0 -start "2019-12-12 00:00:00.000" -interval 5000`
+
+    执行上述命令后会将 sensor_info 场景的数据横向扩展2倍从指定时间 `2019-12-12 00:00:00.000` 开始且记录间隔时间为 5000 毫秒开始导入，导入至当前时间后会自动持续导入。
+
+### config/cfg.toml 配置文件说明
+    
+``` toml
+# 传感器场景
+[sensor_info]                               # 场景名称
+format = "csv"                              # 样例数据文件格式，可以是 json 或 csv，具体字段应至少包含 subTableName、tags、fields 指定的字段。
+filePath = "data/sensor_info.csv"           # 样例数据文件路径，程序会循环使用该文件数据
+separator = ","                             # csv 样例文件中字段分隔符，默认逗号
+
+stname = "sensor_info"                      # 超级表名称
+subTableName = "devid"                      # 使用样例数据中指定字段当作子表名称一部分，子表名称格式为 t_subTableName_stname，扩展表名为 t_subTableName_stname_i。
+timestamp = "ts"                            # 使用 fields 中哪个字段当作主键，类型必须为 timestamp
+timestampType="millisecond"                 # 样例数据中主键时间字段是 millisecond 还是 dateTime 格式
+#timestampTypeFormat = "2006-01-02 15:04:05.000"  # 主键日期时间格式，timestampType 为 dateTime 时需要指定
+tags = [
+    # 标签列表，name 为标签名称，type 为标签类型
+    { name = "location",             type = "binary(20)" },
+    { name = "color",             type = "binary(16)" },
+    { name = "devgroup",           type = "int" },
+]
+
+fields = [
+    # 字段列表，name 为字段名称，type 为字段类型
+    { name = "ts",                  type = "timestamp" },
+    { name = "temperature",         type = "int" },
+    { name = "humidity",            type = "float" },
+]
+
+# 摄像头检测场景
+[camera_detection]                          # 场景名称
+format = "json"                             # 样例数据文件格式，可以是 json 或 csv，具体字段应至少包含 subTableName、tags、fields 指定的字段。
+filePath = "data/camera_detection.json"     # 样例数据文件路径，程序会循环使用该文件数据
+#separator = ","                            # csv 样例文件中字段分隔符，默认逗号, 如果是 json 文件可以不用配置
+ 
+stname = "camera_detection"                 # 超级表名称
+subTableName = "sensor_id"                  # 使用样例数据中指定字段当作子表名称一部分，子表名称格式为 t_subTableName_stname，扩展表名为 t_subTableName_stname_i。
+timestamp = "ts"                            # 使用 fields 中哪个字段当作主键，类型必须为 timestamp
+timestampType="dateTime"                    # 样例数据中主键时间字段是 millisecond 还是 dateTime 格式
+timestampTypeFormat = "2006-01-02 15:04:05.000"  # 主键日期时间格式，timestampType 为 dateTime 时需要指定
+tags = [
+    # 标签列表，name 为标签名称，type 为标签类型
+    { name = "home_id",           type = "binary(30)" },
+    { name = "object_type",       type = "int" },
+    { name = "object_kind",       type = "binary(20)" },
+]
+
+fields = [
+    # 字段列表，name 为字段名称，type 为字段类型
+    { name = "ts",                type = "timestamp" },
+    { name = "states",               type = "tinyint" },
+    { name = "battery_voltage",   type = "float" },
+]
+
+# other cases
+
+```
+
+### 样例数据格式说明
+
+#### json
+
+当配置文件 `config/cfg.toml` 中各场景的 format="json" 时，样例数据文件需要提供 tags 和 fields 字段列表中的字段值。样例数据格式如下：
+
+```json
+{"home_id": "603", "sensor_id": "s100", "ts": "2019-01-01 00:00:00.000", "object_type": 1, "object_kind": "night", "battery_voltage": 0.8, "states": 1}
+{"home_id": "604", "sensor_id": "s200", "ts": "2019-01-01 00:00:00.000", "object_type": 2, "object_kind": "day", "battery_voltage": 0.6, "states": 0}
+```
+
+#### csv
+
+当配置文件 `config/cfg.toml` 中各场景的 format="csv" 时，样例数据文件需要提供表头和对应的数据，其中字段分隔符由使用场景中 `separator` 指定，默认逗号。具体格式如下：
+
+```csv
+devid,location,color,devgroup,ts,temperature,humidity
+0, beijing, white, 0, 1575129600000, 16, 19.405091
+0, beijing, white, 0, 1575129601000, 22, 14.377142
+```
+
+
+
+[1]: https://github.com/taosdata/TDengine
+[2]: https://golang.org/doc/install
+[3]: https://www.taosdata.com/cn/documentation/connector/#Go-Connector
+[4]: https://www.taosdata.com/cn/documentation/taos-sql/#%E6%95%B0%E6%8D%AE%E6%9F%A5%E8%AF%A2
\ No newline at end of file

importSampleData/config/cfg.toml

+# 传感器场景
+[sensor_info]                               # 场景名称
+format = "csv"                              # 样例数据文件格式，可以是 json 或 csv，具体字段应至少包含 subTableName、tags、fields 指定的字段。
+filePath = "data/sensor_info.csv"           # 样例数据文件路径，程序会循环使用该文件数据
+separator = ","                             # csv 样例文件中字段分隔符，默认逗号
+
+stname = "sensor_info"                      # 超级表名称
+subTableName = "devid"                      # 使用样例数据中指定字段当作子表名称一部分，子表名称格式为 t_subTableName_stname，扩展表名为 t_subTableName_stname_i。
+timestamp = "ts"                            # 使用 fields 中哪个字段当作主键，类型必须为 timestamp
+timestampType="millisecond"                 # 样例数据中主键时间字段是 millisecond 还是 dateTime 格式
+#timestampTypeFormat = "2006-01-02 15:04:05.000"  # 主键日期时间格式，timestampType 为 dateTime 时需要指定
+tags = [
+    # 标签列表，name 为标签名称，type 为标签类型
+    { name = "location",           type = "binary(20)" },
+    { name = "color",              type = "binary(16)" },
+    { name = "devgroup",           type = "int" },
+]
+
+fields = [
+    # 字段列表，name 为字段名称，type 为字段类型
+    { name = "ts",                  type = "timestamp" },
+    { name = "temperature",         type = "int" },
+    { name = "humidity",            type = "float" },
+]
+
+# 摄像头检测场景
+[camera_detection]                          # 场景名称
+format = "json"                             # 样例数据文件格式，可以是 json 或 csv，具体字段应至少包含 subTableName、tags、fields 指定的字段。
+filePath = "data/camera_detection.json"     # 样例数据文件路径，程序会循环使用该文件数据
+#separator = ","                            # csv 样例文件中字段分隔符，默认逗号, 如果是 json 文件可以不用配置
+ 
+stname = "camera_detection"                 # 超级表名称
+subTableName = "sensor_id"                  # 使用样例数据中指定字段当作子表名称一部分，子表名称格式为 t_subTableName_stname，扩展表名为 t_subTableName_stname_i。
+timestamp = "ts"                            # 使用 fields 中哪个字段当作主键，类型必须为 timestamp
+timestampType="dateTime"                    # 样例数据中主键时间字段是 millisecond 还是 dateTime 格式
+timestampTypeFormat = "2006-01-02 15:04:05.000"  # 主键日期时间格式，timestampType 为 dateTime 时需要指定
+tags = [
+    # 标签列表，name 为标签名称，type 为标签类型
+    { name = "home_id",           type = "binary(30)" },
+    { name = "object_type",       type = "int" },
+    { name = "object_kind",       type = "binary(20)" },
+]
+
+fields = [
+    # 字段列表，name 为字段名称，type 为字段类型
+    { name = "ts",                type = "timestamp" },
+    { name = "states",            type = "tinyint" },
+    { name = "battery_voltage",   type = "float" },
+]
+
+# other case
\ No newline at end of file

importSampleData/dashboard/sensor_info.json

+{
+  "annotations": {
+    "list": [
+      {
+        "builtIn": 1,
+        "datasource": "-- Grafana --",
+        "enable": true,
+        "hide": true,
+        "iconColor": "rgba(0, 211, 255, 1)",
+        "name": "Annotations & Alerts",
+        "type": "dashboard"
+      }
+    ]
+  },
+  "editable": true,
+  "gnetId": null,
+  "graphTooltip": 0,
+  "id": 7,
+  "links": [],
+  "panels": [
+    {
+      "cacheTimeout": null,
+      "colorBackground": false,
+      "colorValue": true,
+      "colors": [
+        "#299c46",
+        "rgba(237, 129, 40, 0.89)",
+        "#d44a3a"
+      ],
+      "datasource": null,
+      "format": "celsius",
+      "gauge": {
+        "maxValue": 100,
+        "minValue": 0,
+        "show": false,
+        "thresholdLabels": false,
+        "thresholdMarkers": true
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 12,
+        "x": 0,
+        "y": 0
+      },
+      "id": 6,
+      "interval": null,
+      "links": [],
+      "mappingType": 1,
+      "mappingTypes": [
+        {
+          "name": "value to text",
+          "value": 1
+        },
+        {
+          "name": "range to text",
+          "value": 2
+        }
+      ],
+      "maxDataPoints": 100,
+      "nullPointMode": "connected",
+      "nullText": null,
+      "options": {},
+      "postfix": "",
+      "postfixFontSize": "50%",
+      "prefix": "",
+      "prefixFontSize": "50%",
+      "rangeMaps": [
+        {
+          "from": "null",
+          "text": "N/A",
+          "to": "null"
+        }
+      ],
+      "sparkline": {
+        "fillColor": "rgba(31, 118, 189, 0.18)",
+        "full": false,
+        "lineColor": "rgb(31, 120, 193)",
+        "show": true,
+        "ymax": null,
+        "ymin": null
+      },
+      "tableColumn": "",
+      "targets": [
+        {
+          "alias": "lastest_temperature",
+          "refId": "A",
+          "sql": "select  ts, temp from  test.stream_temp_last  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        }
+      ],
+      "thresholds": "20,30",
+      "timeFrom": null,
+      "timeShift": null,
+      "title": "最新温度",
+      "type": "singlestat",
+      "valueFontSize": "80%",
+      "valueMaps": [
+        {
+          "op": "=",
+          "text": "N/A",
+          "value": "null"
+        }
+      ],
+      "valueName": "current"
+    },
+    {
+      "datasource": null,
+      "gridPos": {
+        "h": 8,
+        "w": 12,
+        "x": 12,
+        "y": 0
+      },
+      "id": 8,
+      "options": {
+        "fieldOptions": {
+          "calcs": [
+            "last"
+          ],
+          "defaults": {
+            "decimals": 2,
+            "mappings": [],
+            "max": 100,
+            "min": 0,
+            "thresholds": [
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "red",
+                "value": 80
+              }
+            ],
+            "title": ""
+          },
+          "override": {},
+          "values": false
+        },
+        "orientation": "auto",
+        "showThresholdLabels": false,
+        "showThresholdMarkers": true
+      },
+      "pluginVersion": "6.4.3",
+      "targets": [
+        {
+          "alias": "maxHumidity",
+          "refId": "A",
+          "sql": "select  ts, humidity  from  test.stream_humidity_max  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        }
+      ],
+      "timeFrom": null,
+      "timeShift": null,
+      "title": "最大湿度",
+      "type": "gauge"
+    },
+    {
+      "aliasColors": {},
+      "bars": true,
+      "dashLength": 10,
+      "dashes": false,
+      "datasource": null,
+      "fill": 1,
+      "fillGradient": 0,
+      "gridPos": {
+        "h": 10,
+        "w": 12,
+        "x": 0,
+        "y": 8
+      },
+      "id": 4,
+      "legend": {
+        "avg": false,
+        "current": false,
+        "max": false,
+        "min": false,
+        "show": true,
+        "total": false,
+        "values": false
+      },
+      "lines": false,
+      "linewidth": 1,
+      "nullPointMode": "null",
+      "options": {
+        "dataLinks": []
+      },
+      "percentage": false,
+      "pointradius": 2,
+      "points": false,
+      "renderer": "flot",
+      "seriesOverrides": [],
+      "spaceLength": 10,
+      "stack": false,
+      "steppedLine": false,
+      "targets": [
+        {
+          "alias": "avgTemperature",
+          "refId": "A",
+          "sql": "select  ts, temp from  test.stream_temp_avg  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        }
+      ],
+      "thresholds": [],
+      "timeFrom": null,
+      "timeRegions": [],
+      "timeShift": null,
+      "title": "平均温度",
+      "tooltip": {
+        "shared": true,
+        "sort": 0,
+        "value_type": "individual"
+      },
+      "type": "graph",
+      "xaxis": {
+        "buckets": null,
+        "mode": "time",
+        "name": null,
+        "show": true,
+        "values": []
+      },
+      "yaxes": [
+        {
+          "format": "celsius",
+          "label": null,
+          "logBase": 1,
+          "max": null,
+          "min": null,
+          "show": true
+        },
+        {
+          "format": "short",
+          "label": null,
+          "logBase": 1,
+          "max": null,
+          "min": null,
+          "show": true
+        }
+      ],
+      "yaxis": {
+        "align": false,
+        "alignLevel": null
+      }
+    },
+    {
+      "aliasColors": {},
+      "bars": false,
+      "dashLength": 10,
+      "dashes": false,
+      "datasource": null,
+      "fill": 1,
+      "fillGradient": 0,
+      "gridPos": {
+        "h": 10,
+        "w": 12,
+        "x": 12,
+        "y": 8
+      },
+      "id": 10,
+      "legend": {
+        "avg": false,
+        "current": false,
+        "max": false,
+        "min": false,
+        "show": true,
+        "total": false,
+        "values": false
+      },
+      "lines": true,
+      "linewidth": 1,
+      "nullPointMode": "null",
+      "options": {
+        "dataLinks": []
+      },
+      "percentage": false,
+      "pointradius": 2,
+      "points": false,
+      "renderer": "flot",
+      "seriesOverrides": [],
+      "spaceLength": 10,
+      "stack": false,
+      "steppedLine": false,
+      "targets": [
+        {
+          "alias": "max",
+          "refId": "A",
+          "sql": "select  ts, max_temp  from  test.stream_sensor  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        },
+        {
+          "alias": "avg",
+          "refId": "B",
+          "sql": "select  ts, avg_temp   from  test.stream_sensor  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        },
+        {
+          "alias": "min",
+          "refId": "C",
+          "sql": "select  ts, min_temp   from  test.stream_sensor  where ts >= $from and ts < $to",
+          "target": "select metric",
+          "type": "timeserie"
+        }
+      ],
+      "thresholds": [],
+      "timeFrom": null,
+      "timeRegions": [],
+      "timeShift": null,
+      "title": "某传感器",
+      "tooltip": {
+        "shared": true,
+        "sort": 0,
+        "value_type": "individual"
+      },
+      "type": "graph",
+      "xaxis": {
+        "buckets": null,
+        "mode": "time",
+        "name": null,
+        "show": true,
+        "values": []
+      },
+      "yaxes": [
+        {
+          "format": "celsius",
+          "label": null,
+          "logBase": 1,
+          "max": null,
+          "min": null,
+          "show": true
+        },
+        {
+          "format": "short",
+          "label": null,
+          "logBase": 1,
+          "max": null,
+          "min": null,
+          "show": true
+        }
+      ],
+      "yaxis": {
+        "align": false,
+        "alignLevel": null
+      }
+    }
+  ],
+  "refresh": "5s",
+  "schemaVersion": 20,
+  "style": "dark",
+  "tags": [],
+  "templating": {
+    "list": []
+  },
+  "time": {
+    "from": "now-5m",
+    "to": "now"
+  },
+  "timepicker": {
+    "refresh_intervals": [
+      "5s",
+      "10s",
+      "30s",
+      "1m",
+      "5m",
+      "15m",
+      "30m",
+      "1h",
+      "2h",
+      "1d"
+    ]
+  },
+  "timezone": "",
+  "title": "sensor_info",
+  "uid": "dGSoaTLWz",
+  "version": 2
+}
\ No newline at end of file

importSampleData/import/import_config.go

+package dataimport
+
+import (
+	"encoding/json"
+	"fmt"
+	"path/filepath"
+	"sync"
+
+	"github.com/pelletier/go-toml"
+)
+
+var (
+	cfg  Config
+	once sync.Once
+)
+
+// Config inclue all scene import config
+type Config struct {
+	UserCases map[string]CaseConfig
+}
+
+// CaseConfig include the sample data config and tdengine config
+type CaseConfig struct {
+	Format                string
+	FilePath              string
+	Separator             string
+	Stname                string
+	SubTableName          string
+	Timestamp             string
+	TimestampType   	  string
+	TimestampTypeFormat   string
+	Tags                  []FieldInfo
+	Fields                []FieldInfo
+}
+
+// FieldInfo is field or tag info
+type FieldInfo struct {
+	Name string
+	Type string
+}
+
+// LoadConfig will load the specified file config
+func LoadConfig(filePath string) Config {
+	once.Do(func() {
+		filePath, err := filepath.Abs(filePath)
+		if err != nil {
+			panic(err)
+		}
+		fmt.Printf("parse toml file once. filePath: %s\n", filePath)
+		tree, err := toml.LoadFile(filePath)
+		if err != nil {
+			panic(err)
+		}
+
+		bytes, err := json.Marshal(tree.ToMap())
+		if err != nil {
+			panic(err)
+		}
+
+		err = json.Unmarshal(bytes, &cfg.UserCases)
+		if err != nil {
+			panic(err)
+		}
+	})
+	return cfg
+}