1. 历史数据

历史数据是实时数据的归档查询视图，支持按时间范围查看某台设备的全部历史上报记录，提供曲线图和表格两种展示形式，适用于趋势分析、异常溯源和报表导出。

数据流位置

flowchart LR
    DEV[LoRaWAN 设备]:::dim
    GW[网关]:::dim
    NS[NS 数据\nMAC层原始帧]:::dim
    AS[AS 数据\n解密结构化报文]:::dim
    RT[实时数据\n物模型解析值]:::dim
    HIS[历史数据\n归档查询]:::highlight

    DEV -->|无线信号| GW
    GW -->|SEMTECH UDP| NS
    NS -->|LoRaWAN 解密| AS
    AS -->|物模型解析| RT
    RT -->|持久化| HIS

    classDef highlight fill:#1a6fcf,color:#fff,stroke:#1a6fcf
    classDef dim fill:#f0f0f0,color:#888,stroke:#ddd

历史数据依赖持久化存储。当前实时值为空或被清理，并不能单独证明历史记录也为空；应按设备、物模型和时间范围实际查询，并检查存储开关与保留策略。

---

1.1. 进入历史数据

在实时数据列表中，点击某设备行末的历史数据按钮即可进入该设备的历史查询页。也可在设备管理中直接导航。

---

1.2. 曲线视图

以折线图形式展示选定时间范围内各属性的变化趋势，可勾选/取消属性字段控制显示内容。

---

1.3. 表格视图

以逐条记录形式列出各时间点的所有属性值，支持按时间范围过滤，适合精确查阅某时刻的数据或导出原始记录。

---

1.4. 查询建议

• 时间范围：单次查询建议不超过 7 天，数据量大时页面响应会变慢。
• 属性筛选：曲线视图中取消不需要的属性可提升渲染速度。
• 数据缺口：若某时段数据断档，结合 NS 数据确认该时段是否有上行包。
• 保留期限：管理员可在TimescaleDB 管理中检查对应表的保留策略。“建议不超过 7 天”是查询性能建议，不是统一保存期限或已确认的硬性输入上限。