diff --git a/documentation/webdocs/markdowndocs/connector-ch.md b/documentation/webdocs/markdowndocs/connector-ch.md index b5d8fb5afb12ede82f2cdcd9ea29e20e8a82d6b8..b46408c4dbb7bfc99f3510da476083c716081bd3 100644 --- a/documentation/webdocs/markdowndocs/connector-ch.md +++ b/documentation/webdocs/markdowndocs/connector-ch.md @@ -1207,11 +1207,49 @@ TDengine在Window系统上提供的API与Linux系统是相同的, 应用程序 其中,最常用的文件列出如下: + Client可执行文件: /usr/local/taos/bin/taos 软连接到 /usr/local/bin/taos + + 配置文件: /usr/local/taos/cfg/taos.cfg 软连接到 /etc/taos/taos.cfg + + 驱动程序目录: /usr/local/taos/driver/libtaos.1.6.5.1.dylib 软连接到 /usr/local/lib/libtaos.dylib + + 驱动程序头文件: /usr/local/taos/include/taos.h 软连接到 /usr/local/include/taos.h + + 日志目录(第一次运行程序时生成):~/TDengineLog + + + +## MQTT客户端 + +MQTT客户端实现了订阅MQTT Broker的特定Topic将Json数据进行转换入库的功能,任何终端只要将数据发给特定的Topic 即可,不用再编写转换器或者数据解析程序。如果终端量大,需要 Mqtt Broker 群集,这里不再详述。 + +#### 如何配置? + +首先需要在 taos.cfg 中打开配置项 mqtt 用来启用, 再通过修改 mqttBrokerAddress 的值来配置连接,格式为: + +> mqtt://username:password@hostname:port/path/ + + 例如: + +> mqtt://127.0.0.1:1883/taos/ mqtt://root@kissme@127.0.0.1:1883/taos/ + + +#### Topic 格式说明 + + Mqtt 的topic格式为 + +> ///// + +因此TDengine的Mqtt客户端会订阅: + +> /taos/+/+/+/+/ + +例如: + +> /taos/token/db/t/ + +注意: 测试时如果需要使用到Mqtt Broker 推荐使用 [mosquitto](http://mosquitto.org/) ,客户端可以使用 [MQTT.fx ](http://www.jensd.de/) + [1]: https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver diff --git a/packaging/cfg/taos.cfg b/packaging/cfg/taos.cfg index 38e960eb0679453c3d7cd624ceed5616b0b5deb7..a0fd441a8797661945c6abbeb13dbb29e52755db 100644 --- a/packaging/cfg/taos.cfg +++ b/packaging/cfg/taos.cfg @@ -166,6 +166,15 @@ # start system monitor module # monitor 1 +# start http service +# mqtt 0 + +# mqtt uri +# mqttBrokerAddress mqtt://username:password@hostname:1883/taos/ + +# mqtt client name +# mqttBrokerClientId taos_mqtt + # maximum number of rows returned by the restful interface # restfulRowLimit 10240 @@ -244,5 +253,8 @@ # debug flag for system monitor # monitorDebugFlag 131 +#debug flag for mqtt client +# mqttDebugFlag 131 + # debug flag for TAOS TIMER # tmrDebugFlag 131