如何将JSON格式时序数据存入Apache IoTDB？拆分还是整体存储？

一、存储JSON时序数据的两种方式 #

1. 直接存储完整JSON字符串 #

IoTDB支持STRING数据类型，你可以直接将整个JSON字符串作为单个时间序列的字段值插入。示例SQL：

INSERT INTO root.device.sensor(timestamp, raw_json) VALUES(1690000000000, '{"temp":23.5, "humi":58, "pressure":101.3}')

查询时直接读取raw_json字段就能拿到完整的JSON内容。

2. 拆分JSON为多时序序列存储 #

先解析JSON字符串，提取出内部的每个指标（比如温度、湿度），将每个指标映射为IoTDB的一个时间序列，再执行插入。示例SQL：

INSERT INTO root.device.sensor(timestamp, temp, humi, pressure) VALUES(1690000000000, 23.5, 58, 101.3)

二、两种存储方式的选择依据 #

优先选择拆分存储的场景 #

• 需要对单个指标做分析操作：比如计算温度的小时平均值、筛选湿度超过60的记录，拆分后能直接利用IoTDB的聚合、过滤等时序分析能力。
• 追求存储与查询性能：IoTDB对数值类型的时序数据做了压缩、分区等优化，拆分后的数据占用空间更小，查询速度更快。
• 后续需要多指标关联分析：如果要和其他设备的同类型指标做对比或关联，拆分后的结构更便于操作。

适合存储完整JSON的场景 #

• JSON结构频繁变动：如果JSON里的字段经常新增或修改，拆分存储需要频繁修改IoTDB的元数据（添加/删除时间序列），成本较高。
• 仅需完整读取数据：业务场景只需要获取完整的JSON内容，不需要对内部指标做任何分析，直接存储更简单。
• 数据量小且性能要求低：小规模数据下，两种方式的性能差异可以忽略，直接存储能减少解析JSON的开发工作量。

内容的提问来源于stack exchange，提问作者shuww