编者荐语：
本文将介绍如何使用 EMQ X 规则引擎的 MQTT 数据桥接功能，接收 MQTT 客户端发送的数据，并实时插入到时序数据库IoTDB。
以下文章来源于EMQ中文社区 ，作者EMQ
前言
EMQ X 是一个大规模扩展、可弹性伸缩的开源云原生分布式物联网消息中间件，由开源物联网数据基础设施软件供应商 EMQ 发布。EMQ X 可以高效可靠地处理海量物联网设备的并发连接，并且内置了强大的规则引擎功能，用以对事件和消息流数据进行高性能地实时处理。规则引擎通过 SQL 语句提供了灵活的 「配置式」的业务集成方案，简化了业务开发流程，提升了易用性，降低了用户的业务逻辑与 EMQ X 的耦合度。
GitHub地址：https://github.com/emqx/emqx
Apache IoTDB
IoTDB 是最早由清华大学发起的开源时序数据库项目，现已经是 Apache 的顶级项目。IoTDB 可以为用户提供数据收集、存储和分析等服务。由于其轻量级架构、高性能和高可用的特性，以及与 Hadoop 和 Spark 生态的无缝集成，满足了工业 IoT 领域中海量数据存储、高吞吐量数据写入和复杂数据查询分析的需求。
本文将介绍如何使用 EMQ X 规则引擎的 MQTT 数据桥接功能，接收 MQTT 客户端发送的数据，并实时插入到时序数据库 IoTDB。
准备工作
本文示例中用到的软件和环境：
操作系统：Mac OSX
IoTDB：Binary 包（Server），版本 0.12.4
MQTT Broker：emqx 开源版 4.3.11
MQTT 客户端软件：MQTTX v1.6.0
IoTDB 安装
首先我们需要从 IoTDB 的官方页面（https://iotdb.apache.org/Download/）下载 IoTDB Server（单机版）的二进制包。
下载完成之后解压，进入解压后的目录：
% lsLICENSE README.md RELEASE_NOTES.md data ext licenses sbinNOTICE README_ZH.md conf docs lib logs tools
要启用 IoTDB 的 MQTT 协议支持，需要改动 IoTDB 的配置文件 conf/iotdb-engine.properties：
####################### MQTT Broker Configuration##################### whether to enable the mqtt service.enable_mqtt_service=true# the mqtt service binding host.mqtt_host=0.0.0.0# the mqtt service binding port.mqtt_port=2883# the handler pool size for handing the mqtt messages.mqtt_handler_pool_size=1# the mqtt message payload formatter.mqtt_payload_formatter=json# max length of mqtt message in bytemqtt_max_message_size=1048576
其中 enable_mqtt_service 默认为 false，需要改成 true。mqtt_port 默认值是 1883，为了避免与 emqx 的端口号冲突，需要改为 2883。
*后续建模使用了一个存储组 root.sg，为了增加写入并行度，需要同时将 iotdb-engine.properties 中的 virtual_storage_group_num 设置为机器核数
然后使用 ./sbin/start-server.sh 启动 IoTDB 服务端：
% ./sbin/start-server.sh---------------------Starting IoTDB---------------------Maximum memory allocation pool = 2048MB, initial memory allocation pool = 512MBIf you want to change this configuration, please check conf/iotdb-env.sh(Unix or OS X, if you use Windows, check conf/iotdb-env.bat).2022-01-10 14:15:31,914 [main] INFO o.a.i.d.c.IoTDBDescriptor:121 - Start to read config file file:./sbin/../conf/iotdb-engine.properties...2022-01-10 14:14:28,690 [main] INFO o.a.i.d.s.UpgradeSevice:73 - Upgrade service stopped2022-01-10 14:14:28,690 [main] INFO o.a.i.db.service.IoTDB:153 - Congratulation, IoTDB is set up successfully. Now, enjoy yourself!2022-01-10 14:14:28,690 [main] INFO o.a.i.db.service.IoTDB:101 - IoTDB has started
我们保持这个终端窗口不动，另外打开一个新的命令行终端窗口，启动 IoTDB 的 shell 工具：
% ./sbin/start-cli.sh---------------------Starting IoTDB Cli---------------------_____ _________ ______ ______|_ _| | _ _ ||_ _ `.|_ _ \| | .--.|_/ | | \_| | | `. \ | |_) || | / .'`\ \ | | | | | | | __'._| |_| \__. | _| |_ _| |_.' /_| |__) ||_____|'.__.' |_____| |______.'|_______/ version 0.12.4IoTDB> login successfullyIoTDB>
至此 IoTDB 环境就准备好了。如要了解 IoTDB 的基本使用方法，可以参考官网的快速上手页面（https://iotdb.apache.org/zh/UserGuide/Master/QuickStart/QuickStart.html）。
配置 EMQ X
下载和启动 EMQ X
我们从 EMQ X 官方下载页面（https://www.emqx.com/en/downloads-and-install?product=broker&version=4.3.11&os=macOS&oslabel=macOS）获取 EMQ X Broker 软件包：
% wget https://www.emqx.com/en/downloads/broker/4.3.11/emqx-macos-4.3.11-amd64.zip--2022-01-10 14:24:06-- https://www.emqx.com/en/downloads/broker/4.3.11/emqx-macos-4.3.11-amd64.zipConnecting to 127.0.0.1:1087... connected.Proxy request sent, awaiting response... 302 FoundLocation: https://packages.emqx.io/emqx-ce/v4.3.11/emqx-macos-4.3.11-amd64.zip [following]--2022-01-10 14:24:07-- https://packages.emqx.io/emqx-ce/v4.3.11/emqx-macos-4.3.11-amd64.zipConnecting to 127.0.0.1:1087... connected.Proxy request sent, awaiting response... 200 OKLength: 26881462 (26M) [application/zip]Saving to: ‘emqx-macos-4.3.11-amd64.zip’emqx-macos-4.3.11-amd64.zip 100%[======================================================>] 25.64M 4.36MB/s in 7.8s2022-01-10 14:24:16 (3.29 MB/s) - ‘emqx-macos-4.3.11-amd64.zip’ saved [26881462/26881462]
然后解压并启动 EMQ X：
% unzip -q emqx-macos-4.3.11-amd64.zip% cd emqx% ./bin/emqx consolelog.to = "console"Erlang/OTP 23 [erts-11.1.8] [emqx] [64-bit] [smp:8:8] [ds:8:8:8] [async-threads:4] [hipe]Starting emqx on node emqx@127.0.0.1Start mqtt:tcp:internal listener on 127.0.0.1:11883 successfully.Start mqtt:tcp:external listener on 0.0.0.0:1883 successfully.Start mqtt:ws:external listener on 0.0.0.0:8083 successfully.Start mqtt:ssl:external listener on 0.0.0.0:8883 successfully.Start mqtt:wss:external listener on 0.0.0.0:8084 successfully.Start http:management listener on 8081 successfully.Start http:dashboard listener on 18083 successfully.EMQ X Broker 4.3.11 is running now!Eshell V11.1.8 (abort with ^G)(emqx@127.0.0.1)1>
配置规则
使用浏览器打开 EMQ X 的 Dashboard，在规则引擎页面创建一条规则：
SQL 语句为：
SELECTclientid,now_timestamp('millisecond') as now_ts_ms,payload.bar as barFROM"t/#"
然后我们在页面的底部，给规则加一个「桥接数据到 MQTT Broker」动作：
这个动作需要关联一个资源，我们点击右上角的「新建资源」来创建一个MQTT Bridge资源：
远程 Broker 地址要填写 IoTDB 的 MQTT 服务地址，即 "127.0.0.1:2883"。客户端 Id、用户名、密码都填写 root，因为 root 是 IoTDB 默认的用户名和密码。
其他选项保持默认值不变，点击「测试连接」按钮确保配置无误，然后再点击右下角的「新建」按钮创建资源。
现在返回到动作创建页面，关联资源的下拉框里自动填充了我们刚才创建的资源。
现在我们继续填写更多的动作参数：
IoTDB 不关心消息主题，我们填一个任意的主题：foo。
IoTDB 要求消息内容是一个 JSON 格式，消息内容模板可以按照上图中样式填写。详情请参见 IoTDB 的通信服务协议文档（https://iotdb.apache.org/zh/UserGuide/Master/Communication-Service-Protocol/Programming-MQTT.html#mqtt-协议）。
{"device": "root.sg.${clientid}","timestamp": ${now_ts_ms},"measurements": ["bar"],"values": [${bar}]}
注意其中的 "${clientid}", "${now_ts_ms}" 以及 "${bar}" 都是从规则的 SQL 语句的输出中提取的变量，所以必须保证这些变量跟 SQL 语句的 SELECT 字句对应上。
现在可以点击「确认」保存动作配置，然后再次点击「新建」完成规则的创建。
接下来我们使用 MQTTX 客户端工具（https://mqttx.app），来发送一条消息给 EMQ X：
*MQTT X 是 EMQ 发布的一款完全开源的 MQTT 5.0 跨平台桌面客户端。支持快速创建多个同时在线的 MQTT 客户端连接，方便测试 MQTT/TCP、MQTT/TLS、MQTT/WebSocket 的连接、发布、订阅功能及其他 MQTT 协议特性。
MQTT 客户端的连接参数里面，我们只需要填一个参数，Client ID："abc"，其他的保持默认值不变。
连接成功之后，我们发送 2 条主题为："t/1" 的消息，消息内容格式为：{ "bar": 0.2}然后回到 EMQ X Dashboard 的规则引擎页面，观察规则的命中次数，确认规则被触发了 2 次：
IoTDB> SHOW TIMESERIES root.sg.abc+---------------+-----+-------------+--------+--------+-----------+----+----------+| timeseries|alias|storage group|dataType|encoding|compression|tags|attributes|+---------------+-----+-------------+--------+--------+-----------+----+----------+|root.sg.abc.bar| null| root.sg| FLOAT| GORILLA| SNAPPY|null| null|+---------------+-----+-------------+--------+--------+-----------+----+----------+Total line number = 1It costs 0.006sIoTDB> SELECT * FROM root.sg.abc+-----------------------------+---------------+| Time|root.sg.abc.bar|+-----------------------------+---------------+|2022-01-10T17:39:41.724+08:00| 0.3||2022-01-10T17:40:32.805+08:00| 0.2|+-----------------------------+---------------+Total line number = 2It costs 0.007sIoTDB>
数据插入成功！
结语
至此，我们完成了通过 EMQ X 规则引擎功能将消息持久化到 IoTDB 时序数据库。
在实际生产场景中，我们可以使用 EMQ X 处理海量的物联网设备并发连接，并通过规则引擎灵活地处理业务功能，然后将设备发送的消息持久化到 IoTDB 数据库，最后使用 Hadoop/Spark、Flink 或 Grafana 等对接 IoTDB 实现大数据分析、可视化展示等。
EMQ X + IoTDB 的组合是一个简洁、高效且易扩展、高可用的服务端集成方案，对于物联网设备管理和数据处理场景来说，是一个不错的选择。
参与开源，可以获得公司及社区内外的认可，结交来自各个领域、志同道合的小伙伴；同时也可以提高个人影响力，促进个人发展。参与开源不是开发者的专属，社区、文档等各个方面都可以让大家发挥一技之长。
作为全球性开源项目，截至目前，Apache IoTDB已拥有 160+ 名贡献者、1.7KStar、500+ Fork。我们为大家提供了参与指南，欢迎越来越多的小伙伴助力 Apache IoTDB项目的不断发展与前进。
欢迎迈出加入 Apache IoTDB 社区的第一步！
QQ群：659990460
微信群：添加好友qinchuqing/tietouqiao
github仓库：https://github.com/apache/iotdb
官网：http://iotdb.apache.org/
