Thingsboard 中“设备配置”和“设备”的关系是一对多的关系,通过设备配置为每个设备设置不同的配置,每个设备都会有一个与其关联的设备配置文件。等等,这不就是TDengine 中超级表的概念:
超级表是一种特殊的表结构,用于代表一类具有相同数据模式的数据采集点。一个超级表有多个子表,一个子表只能隶属于一个超级表。
因此,将两者有机结合起来:TDengine 中创建超级表作为“设备配置”,Thingsboard 中添加设备则自动在TDengine 中创建子表,伟大的设计殊途同归。
灵魂的碰撞
安装部署
安装过程可以直接参考官方安装教程:Installing ThingsBoard CE on Ubuntu Server | ThingsBoard Community Edition
但是有两点需要注意:
- 请点击这里,联系我们获取适配版本。
- 配置文件增加 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
操作步骤
1.创建“设备配置”
以一个车辆管理系统为例,需要记录车辆的车牌号、数据上报时间、经度、纬度、车速这几个变量。因此,我们调用接口来创建一个新的“设备配置”。
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” 的“设备配置”:
数据库中成功创建超级表:
2.添加新设备
选择已有配置“profileStable”,创建新的设备。
成功创建了一个名叫“测A88888″ 的设备,具体的子表名称可以通过“复制设备ID” 查看。
3.测试写入数据
直接通过访问令牌,调用接口发送数据
curl -X POST 'http://127.0.0.1:8080/api/v1/$YOU_DEVICE_TOKEN/telemetry' \
--header 'Content-Type: application/json' \
--data-raw '{"license_plate_number":"京A88888","longtitude":108.938744,"latitude":34.368150,"speed":60}'
界面中更新数据
数据库中也写入了最新的记录
业务展示
场景一:车辆实时定位追踪
- 数据采集:车辆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`
wherespeed > 90 partition by device_name interval(1d);
- 查看流计算结果
注:本次适配没有修改原有前端页面,需要调用HTTP API 来创建设备配置。感兴趣的小伙伴可以完善一下,欢迎提交代码交流。