时序数据库 TDengine 支持集成开源的物联网平台 ThingsBoard
Thingsboard 中“设备配置”和“设备”的关系是一对多的关系,通过设备配置为每个设备设置不同的配置,每个设备都会有一个与其关联的设备配置文件。等等,这不就是TDengine 中超级表的概念:
超级表是一种特殊的表结构,用于代表一类具有相同数据模式的数据采集点。一个超级表有多个子表,一个子表只能隶属于一个超级表。
因此,将两者有机结合起来:TDengine 中创建超级表作为“设备配置”,Thingsboard 中添加设备则自动在TDengine 中创建子表,伟大的设计殊途同归。
灵魂的碰撞
安装部署
安装过程可以直接参考官方安装教程:https://thingsboard.io/docs/user-guide/install/ubuntu/
但是有两点需要注意:
- 请点击这里,联系我们获取适配版本。
- 配置文件增加 TDengine 相关连接配置:
# spring.tdengine export TDENGINE_URL=jdbc:TAOS-RS://127.0.0.1:6041/thingsboard export TDENGINE_USERNAME=root export TDENGINE_PASSWORD=taosdata export TDENGINE_STR_LEN=1024 export TDENGINE_STR_COL_MAX=65517 export TDENGINE_STR_TAG_MAX=16382
操作步骤
- 创建“设备配置”
以一个车辆管理系统为例,需要记录车辆的车牌号、数据上报时间、经度、纬度、车速这几个变量。因此,我们调用接口来创建一个新的“设备配置”。
curl -X POST 'http://127.0.0.1:8080/api/deviceProfile' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer $YOUR_JWT_TOKEN_HERE' \ --data-raw '{ "name": "truck", "type": "DEFAULT", "image": null, "defaultQueueName": null, "transportType": "DEFAULT", "provisionType": "DISABLED", "description": "", "profileData": { "configuration": { "type": "DEFAULT" }, "transportConfiguration": { "type": "DEFAULT" }, "alarms": null, "provisionConfiguration": { "type": "DISABLED" } }, "tableInfo": { "columns": [{"name":"longtitude","type":"double","len":10},{"name":"latitude","type":"double"},{"name":"speed","type":"float"}], "tags": [{"name":"license_plate_number","type":"nchar","len":8}] } }'
Thingsboard 中成功创建名称为“profileStable” 的“设备配置”:
数据库中成功创建超级表:
- 添加新设备
选择已有配置“profileStable”,创建新的设备。
成功创建了一个名叫“测A88888″ 的设备,具体的子表名称可以通过“复制设备ID” 查看。
- 测试写入数据
直接通过访问令牌,调用接口发送数据
数据库中也写入了最新的记录
业务展示
场景一:车辆实时定位追踪
- 数据采集:车辆GPS定位信息每秒传输到Thingsboard。
- 数据存储:在TDengine中创建表存储定位数据。
- 数据展示:在Thingsboard创建地理位置图表,展示车辆实时位置。
场景二:车队维护预警
按日生成车辆每日超速次数。
- 创建流计算:在TDengine 中创建流计算
create stream high_speed fill_history 1 into high_speed subtable(concat('tb_', device_name)) as select _wstart as 日期, count(speed) as 超速次数, device_name as 设备名称 from `1e169050-86e6-11ef-a5cf-2de52a1b0351` where speed > 90 partition by device_name interval(1d);
- 查看流计算结果
注:本次适配没有修改原有前端页面,需要调用HTTP API 来创建设备配置。感兴趣的小伙伴可以完善一下,欢迎提交代码交流。