同步如何工作

• Edge → Cloud同步
  • Cloud端数据存储
• Cloud → Edge同步
  • Edge端数据存储
• 下一步

ThingsBoard Edge不会自动同步遥测数据， 而是通过基于规则的流程实现。“push to cloud” 和“push to edge”规则节点共同负责 同步逻辑。

Edge → Cloud同步

Edge通过Edge规则链中的“push to cloud”规则节点同步数据（timeseries、attributes等）。 当遥测或属性消息经过该规则节点时，会先作为Cloud Event在Edge本地存储， 存储在本地数据库或Kafka中（取决于队列类型）。 随后该事件异步推送到Cloud。这意味着Edge设备无需等待Cloud确认即可继续执行其他任务。 到达Cloud后，由Cloud上相应的规则链处理。

• 要传播属性变更，请将Attributes updated和Attributes deleted关系连接到“push to cloud”节点。 这可确保key–values和scope随事件一起传递。
• attribute scope type（Server attributes、Shared attributes或Client attributes）也将在“push to cloud”节点内配置。

Cloud端数据存储

Cloud侧更新哪些数据库表，完全取决于Cloud侧规则链配置。

• 要同时存储最新遥测和历史遥测，请将遥测路由到“save timeseries”规则节点，并将Latest values设置为“On every message”。这将同时写入并更新timeseries和latest values表。

• 若仅存储历史遥测，请将遥测路由到 “save timeseries” 规则节点，并将 Latest values 设置为 “Skip”。这将仅更新 timeseries 表，latest values 表保持不变。

Cloud → Edge同步

同样，Cloud使用Cloud规则链中的 “push to edge” 规则节点同步数据。

该节点将消息转换为 Edge Event 并将其存储在Cloud上的 Edge queue 中（本地数据库或Kafka，取决于队列类型）。 随后该事件 异步 推送到目标Edge。 到达Edge实例后，由Edge上相应的规则链处理。

• 要传播属性变更，请将 Attributes updated 和 Attributes deleted 关系连接到 “push to edge” 节点。 这可确保 key–values 和 scope 随事件一起传递。
• attribute scope type（Server attributes、Shared attributes或Client attributes）也将在 “push to edge” 节点内配置。

Edge端数据存储

Edge始终保留其接收或从Cloud接收的本地权威数据副本。这支持离线运行和快速本地响应。

• 当数据从设备发送到Edge时：
  Edge先将遥测数据写入本地数据库。根据规则链配置，Edge决定是否将其推送到Cloud

• 当Cloud的Edge事件到达时：

  • 要同时存储最新遥测和历史遥测，请将遥测路由到 “save timeseries” 规则节点，并将 Latest values 设置为 “On every message”。这将同时写入并更新 timeseries 和 latest values 表。

• 若仅存储历史遥测，请将遥测路由到 “save timeseries” 规则节点，并将 Latest values 设置为 “Skip”。这将仅更新 timeseries 表，latest values 表保持不变。

下一步

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

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

• Edge 规则引擎：

  • Rule Chain Templates（规则链模板）- 了解如何使用 ThingsBoard Edge 规则链模板。

  • Provision Rule Chains from cloud to edge（从云端向 Edge 下发规则链）- 了解如何从云端向 Edge 下发边缘规则链。

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

• 功能：

  • Edge Status（Edge 状态）- 了解 ThingsBoard Edge 上的 Edge Status 页面。

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

• 使用场景：

  • Manage alarms and RPC requests on edge devices（在边缘设备上管理告警和 RPC 请求）- 本指南展示如何在 Edge 上生成本地告警并向连接到 Edge 的设备发送 RPC 请求：

  • Data filtering and traffic reduce（数据过滤与流量削减）- 本指南展示如何从 Edge 向云端仅发送过滤后的设备数据：

• Roadmap（路线图）- ThingsBoard Edge 路线图。