时序数据库 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

操作步骤

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`
where
  speed > 90 partition by device_name interval(1d);

• 查看流计算结果

注：本次适配没有修改原有前端页面，需要调用HTTP API 来创建设备配置。感兴趣的小伙伴可以完善一下，欢迎提交代码交流。