IoTDB 是最早由清華大學發起的開源時序資料庫專案，現已經是 Apache 的頂級專案。IoTDB 可以為使用者提供資料收集、儲存和分析等服務。由於其輕量級架構、高效能和高可用的特性，以及與 Hadoop 和 Spark 生態的無縫整合，滿足了工業 IoT 領域中海量資料儲存、高吞吐量資料寫入和複雜資料查詢分析的需求。
EMQ X 是一個大規模擴充套件、可彈性伸縮的開源雲原生分散式物聯網訊息中介軟體，由開源物聯網資料基礎設施軟體供應商 EMQ 映雲科技釋出。EMQ X 可以高效可靠地處理海量物聯網裝置的併發連線，並且內建了強大的規則引擎功能，用以對事件和訊息流資料進行高效能地實時處理。規則引擎通過 SQL 語句提供了靈活的 "配置式" 的業務整合方案，簡化了業務開發流程，提升了易用性，降低了使用者的業務邏輯與 EMQ X 的耦合度。
本文將介紹如何使用 EMQ X 規則引擎的 MQTT 資料橋接功能，接收 MQTT 客戶端傳送的資料，並實時插入到時序資料庫 IoTDB。
準備工作
本文示例中用到的軟體和環境：
- 作業系統： Mac OSX
- IoTDB： Binary 包（Server），版本 0.12.4
- MQTT 伺服器： EMQ X 開源版 v4.3.11
- MQTT 客戶端軟體：MQTTX v1.6.0
IoTDB 安裝
首先我們需要從 IoTDB 官方頁面下載 IoTDB Server（單機版）的二進位制包。
下載完成之後解壓，進入解壓後的目錄：
% ls
LICENSE README.md RELEASE_NOTES.md data ext licenses sbin
NOTICE README_ZH.md conf docs lib logs tools要啟用 IoTDB 的 MQTT 協議支援，需要改動 IoTDB 的配置檔案 conf/iotdb-engine.properties：
*後續建模使用了一個儲存組 root.sg，為了增加寫入並行度，需要同時將 iotdb-engine.properties 中的 virtual_storage_group_num 設定為機器核數。
####################
### 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 byte
mqtt_max_message_size=1048576其中 enable_mqtt_service 預設為 false，需要改成 true。mqtt_port 預設值是 1883，為了避免與 emqx 的埠號衝突，需要改為 2883。
然後使用 ./sbin/start-server.sh 啟動 IoTDB 服務端：
% ./sbin/start-server.sh
---------------------
Starting IoTDB
---------------------
Maximum memory allocation pool = 2048MB, initial memory allocation pool = 512MB
If 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 stopped
2022-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.4
IoTDB> login successfully
IoTDB>至此 IoTDB 環境就準備好了。如要了解 IoTDB 的基本使用方法，可以參考官網的快速上手頁面。
安裝、配置 EMQ X
下載和啟動 EMQ X
我們直接使用命令列下載 macOS 版本的 EMQ X 開源版，更多安裝包請訪問 EMQ X 開源版下載頁面。
% wget https://www.emqx.com/en/downloads/broker/4.3.11/emqx-macos-4.3.11-amd64.zip然後解壓並啟動 EMQ X：
% unzip -q emqx-macos-4.3.11-amd64.zip
% cd emqx
% ./bin/emqx console
log.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.1
Start 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 語句為：
SELECT
clientid,
now_timestamp('millisecond') as now_ts_ms,
payload.bar as bar
FROM
"t/#"然後我們在頁面的底部，給規則加一個 "橋接資料到 MQTT Broker" 動作：
這個動作需要關聯一個資源，我們點選右上角的 “新建資源” 來建立一個 MQTT Bridge 資源：
遠端 Broker 地址要填寫 IoTDB 的 MQTT 服務地址，即 "127.0.0.1:2883"。客戶端 Id、使用者名稱、密碼都填寫 root，因為 root 是 IoTDB 預設的使用者名稱和密碼。
其他選項保持預設值不變，點選 ”測試連線“ 按鈕確保配置無誤，然後再點選右下角的 ”新建“ 按鈕建立資源。
現在返回到動作建立頁面，關聯資源的下拉框裡自動填充了我們剛才建立的資源。
現在我們繼續填寫更多的動作引數：
IoTDB 不關心訊息主題，我們填一個任意的主題：foo。
IoTDB 要求訊息內容是一個 JSON 格式，訊息內容模板可以按照上圖中樣式填寫。詳情請參見 IoTDB 的通訊服務協議文件。
{
"device": "root.sg.${clientid}",
"timestamp": ${now_ts_ms},
"measurements": [
"bar"
],
"values": [
${bar}
]
}注意其中的 "${clientid}", "${now_ts_ms}" 以及 "${bar}" 都是從規則的 SQL 語句的輸出中提取的變數，所以必須保證這些變數跟 SQL 語句的 SELECT 字句對應上。
現在可以點選 ”確認“ 儲存動作配置，然後再次點選 ”新建“ 完成規則的建立。
使用 MQTT Client 傳送訊息
接下來我們使用 MQTT 客戶端工具 - MQTT X，來傳送一條訊息給 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 客戶端視窗，使用下面的 SQL 語句查詢資料：
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 = 1
It costs 0.006s
IoTDB> 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 = 2
It costs 0.007s
IoTDB>資料插入成功！
結語
至此，我們完成了通過 EMQ X 規則引擎功能將訊息持久化到 IoTDB 時序資料庫。
在實際生產場景中，我們可以使用 EMQ X 處理海量的物聯網裝置併發連線，並通過規則引擎靈活地處理業務功能，然後將裝置傳送的訊息持久化到 IoTDB 資料庫，最後使用 Hadoop/Spark、Flink 或 Grafana 等對接 IoTDB 實現大資料分析、視覺化展示等。
EMQ X + IoTDB 的組合是一個簡潔、高效且易擴充套件、高可用的服務端整合方案，對於物聯網裝置管理和資料處理場景來說，是一個不錯的選擇。