数据存储规则

配置项	默认值	说明
项目数据桶过期时间	1 年	新建项目默认 1 年，历史项目自动升级（原默认 14 天）
数据点存储上限	单次 100 个	超出上限接口返回 400 错误
数据点存储开关	用户可控	通过 /data/setStore 接口配置
云组态试用时长	30 天	从网关创建时计算，不可续期
云组态到期行为	WS 停推 + 停止存储	不删除已有数据

数据桶管理

什么是数据桶（Bucket）

数据桶是 InfluxDB 中的逻辑存储单元，平台按项目维度创建数据桶，用于隔离不同项目的时序数据。

过期策略

• 新建项目：默认创建 1 年有效期的数据桶
• 历史项目：系统自动检测并升级旧项目的存储时长（原默认 14 天 → 1 年）
• 到期行为：数据桶到期后，新数据不再写入，已有数据保留但不可查询

数据点存储控制

用户可精细控制每个数据点是否存储历史：

1. 进入网关详情 → 数据点管理
2. 勾选需要存储历史的数据点（单次上限 100 个）
3. 调用 /data/setStore 接口保存配置
4. 被标记的数据点数据写入 InfluxDB，未标记的仅保持实时推送

存储架构

边缘网关 ──MQTT──▶ data 模块 ──写入──▶ InfluxDB Bucket
                                       │
                          ┌────────────┴────────────┐
                          ▼                         ▼
                     实时查询 API              历史查询 API
                    (Redis 缓存)            (InfluxDB 查询)