产品定价 立即试用
边缘
文档 > 核心概念 > 实体与关系
入门
安装 架构 API 常见问题
目录

Edge上的实体与关系

实体概述

ThingsBoard 中,实体 是表示平台内物理对象或业务概念的核心组件。您可在此查看ThingsBoard实体列表。

ThingsBoard Edge 支持与边缘计算相关的实体。

可用的Edge实体

  • Devices(设备): 物理物联网设备(传感器、执行器、控制器)。
  • Assets(资产): 用于分组和管理物联网生态系统的真实世界对象(例如机器、建筑、工厂)。
  • Customers(客户): 分配给特定设备/资产的组织或用户。
  • Users(for PE)(用户): 管理并与边缘资源交互的人员。
  • Entity Views(实体视图): 所选实体数据的预定义视图。
  • Alarms(告警): 异常或预定义条件的警报。
  • Dashboards(仪表板): 遥测及设备数据的可视化。
  • Rule Chains(规则链): 本地数据处理与自动化逻辑。

CustomersUsers 外,大多数实体可在 Edge 上创建。这些实体可在 Server 上创建,然后 分配Edge实例

DevicesAssets 实体分别具有 Device ProfilesAsset Profiles 配置模板。

实体核心功能

属性

Attributes(属性)是与实体相关的结构化数据(如设备型号、位置、token)。 其存储在本地数据库中,可用于可视化、分析、逻辑配置及与其他服务集成。

若要全面了解 ThingsBoard属性,请参阅 Working with IoT Attributes 文档。 您也可参阅Edge Attributes文章,了解 Edge 特有属性。

遥测

Telemetry(遥测)指从物联网设备收集并由 Rule Chain 处理的 时序数据

Telemetry键值对 形式存储:

  • Key(键): 遥测字段(如temperature、humidity、voltage)。
  • Value(值): 数值或字符串(如25.4°C、45%、”ON”)。

示例:

1
2
3
4
5
{
  "temperature": 25.4,
  "humidity": 45,
  "status": "ON"
}

您可在此了解更多关于遥测数据的使用。

默认情况下,ThingsBoard EdgeThingsBoard Cloud 同步遥测数据。 在互联网中断期间,遥测 本地 存储,并在连接恢复后发送到 Cloud

关系

Relation(关系)功能定义实体间的连接,并帮助建模物理对象之间的真实层级关系。

以下参数定义实体间的关系层级:

  • Direction(方向): 描述实体之间的关联方式。
    • “Outbound relation - From”: 表示关系 源自 该实体(该实体为源)。
    • “Inbound relation - To”: 表示关系 指向 该实体(该实体为接收方)。
  • Relation type(关系类型): 描述实体间连接的性质。
    • “Contains”: 表示实体是另一个实体的一部分(如Device A是Asset A的一部分)。
    • “Manages”: 表示实体负责管理另一个实体(如Asset A管理Device A)。

实体关系图示例如下: image

下一步

  • Getting started guide(入门指南)- 快速概览 ThingsBoard Edge 主要功能。预计 15–30 分钟完成:

  • Installation guides(安装指南)- 了解如何在各种操作系统上安装 ThingsBoard Edge 并连接到 ThingsBoard Server。

  • Edge 规则引擎:

  • 安全:
    • gRPC over SSL/TLS - 了解如何为 Edge 与云端之间的通信配置 gRPC over SSL/TLS。
  • 功能:

    • Edge Status(Edge 状态)- 了解 ThingsBoard Edge 上的 Edge Status 页面。

    • Cloud Events(云端事件)- 了解 ThingsBoard Edge 上的 Cloud Events 页面。

  • 使用场景:

  • Roadmap(路线图)- ThingsBoard Edge 路线图。