当前位置：首页 > news >正文

ThingsBoard部件数据结构解析 - 教程

news 2026/5/31 7:32:51

本文描述在Entities Table表中定义数据源后，在部件中获得的数据，并对数据结构进行解释。这代表了最新值部件的数据结构。

数据源定义

提取用户直接相关的资产或设备，并增加获取每个实体的类型字段。
在这里插入图片描述

部件数据

按所设置的别名，部件的self.ctx.data会获得一个数组，每个子项表示获取的一个资产或设备。如下是其中一条子项的结构

{
"datasource": {
"type": "entity",
"name": "午羊科技",
"entityAliasId": "38b298f6-87a5-3d54-935b-80390bca1a95",
"dataKeys": [
{
"name": "type",
"type": "entityField",
"label": "类型",
"color": "#2196f3",
"settings": {
},
"_hash": 0.41103952066475935,
"hidden": false,
"inLegend": true,
"pattern": "类型"
}
],
"alarmFilterConfig": {
"statusList": [
"ACTIVE"
]
},
"aliasName": "用户的直接",
"entityFilter": {
"type": "relationsQuery",
"resolveMultiple": true,
"rootStateEntity": false,
"stateEntityParamName": null,
"defaultStateEntity": null,
"rootEntity": {
"entityType": "USER",
"id": "ced2ae20-679f-11f0-a3ef-fd437db78ef1"
},
"direction": "FROM",
"maxLevel": 1,
"fetchLastLevelOnly": false,
"filters": [
{
"relationType": "Contains",
"entityTypes": [
"ASSET"
]
},
{
"relationType": "Manages",
"entityTypes": [
"ASSET"
]
}
]
},
"pageLink": {
"pageSize": 1024,
"page": 0,
"sortOrder": {
"key": {
"type": "ENTITY_FIELD",
"key": "createdTime"
},
"direction": "DESC"
}
},
"dataReceived": true,
"entity": {
"id": {
"entityType": "ASSET",
"id": "b78f3120-8c5c-11f0-87b9-7908c6298307"
},
"label": "",
"name": "午羊科技"
},
"entityId": "b78f3120-8c5c-11f0-87b9-7908c6298307",
"entityType": "ASSET",
"entityName": "午羊科技",
"entityLabel": "",
"entityDescription": "",
"generated": false
},
"dataKey": {
"name": "type",
"type": "entityField",
"label": "类型",
"color": "#2196f3",
"settings": {
},
"_hash": 0.41103952066475935,
"hidden": false,
"inLegend": true,
"pattern": "类型"
},
"data": [
[
1761784842450,
"组织",
[
1761784842450,
1761784842450
]
]
]
}

结构分析

在 ThingsBoard 的self.ctx.data结构中，这条内容首要描述了与 “午羊科技” 资产相关的数据源安装及具体数据，核心存储结构和关键信息如下：

顶层核心字段

datasource：数据源安装（最关键的结构），涵盖数据来源的实体、过滤规则、查询参数等。
dataKey：数据键配置，定义了当前获取的具体字段信息。
data：实际的业务数据，包含时间戳和对应的值。

datasource 核心子结构
描述数据的来源实体、过滤逻辑、查询范围等，是 ThingsBoard 中数据关联的核心部署：

子字段	含义说明
type	数据源类型，此处为"entity"，表示素材来自 ThingsBoard 的实体（如资产、设备等）。
name	实体名称，此处为"午羊科技"（对应资产的名称）。
entityAliasId	实体别名 ID，用于在仪表盘等配置中关联该实体的唯一标识。
entityId / entityType	实体 ID 和类型，此处entityType为"ASSET"（资产），entityId是该资产的唯一 ID。
entityFilter	实体过滤规则，用于筛选符合条件的实体。
pageLink	分页和排序配置。
dataKeys	要获取的实体字段列表，此处只部署了"type"字段（对应dataKey的信息）。
dataReceived	数据接收状态，true表示已成功获取数据。