GridDB 中 Collection 与 TimeSeries 容器有什么区别,分别适合哪些场景?
选择容器时,先看记录的唯一标识和主要查询方式。用户、客户等数据通常以业务 ID 标识,适合使用 Collection;以时间戳标识采样点、经常按时间范围读取或进行时序计算的数据,通常适合使用 TimeSeries。日志和事件还需要检查时间戳是否会重复,不能只因带有时间字段就选择 TimeSeries。
两种容器的主要区别
| 比较项 | Collection | TimeSeries |
|---|---|---|
| 数据模型 | 通用记录集合 | 以时间为核心的记录序列 |
| ROWKEY | 可不设置;支持 STRING、INTEGER、LONG、TIMESTAMP 等规定类型,复合键支持需核对版本和客户端 | 必须设置,为单个 TIMESTAMP 列 |
| 时间字段 | 可以作为普通列,也可以作为 ROWKEY | 时间戳本身就是 ROWKEY |
| 时序操作 | 可以按时间条件筛选 | 另有时间邻近查找、插值、采样、时间加权平均等操作 |
| 常见用途 | 用户资料、客户信息、设备元数据 | 传感器读数、监控指标、设备运行历史 |
Collection 的 ROWKEY 类型和组合也有明确约束,并非任意数据类型都能作为键。具体规则见 GridDB 数据模型文档。
TimeSeries 中,同一个容器内的时间戳必须唯一。添加普通的 deviceId 列不会使 (timestamp, deviceId) 自动成为复合键。多个设备在同一时间采样时,需要设计容器划分方式,或改用 Collection。
查询行为有什么不同?
两者都能通过 TQL 执行普通条件查询。Collection 只要有时间列,就可以按时间范围筛选。TimeSeries 还提供专门的时序操作,例如:
TIME_NEXT、TIME_PREV:查找指定时间附近的记录。TIME_INTERPOLATED:对指定时间点进行插值。TIME_SAMPLING:按固定时间间隔采样。TIME_AVG:计算时间加权平均值。
TIME_AVG 与普通 AVG 的含义不同,采样间隔不均匀时,两者可能得到不同结果。插值和采样的结果也可能包含估算值,需要与实际采集的原始记录区分。参见 GridDB 编程指南。
对于 Java API 文档中说明的 Container.query(String) 等读取方式,如果没有指定顺序,Collection 不保证行顺序,TimeSeries 则按时间 ROWKEY 升序返回。业务需要排序时,仍建议明确表达排序要求;使用 SQL 接口时,应遵循 SQL 接口的排序规则。GridDB Java API 参考
查询示例
假设目标容器中有 ts 和数值列 temperature。调用方已经选定容器,因此传给容器查询接口的以下 TQL 不含 FROM:
SELECT *
WHERE ts >= TIMESTAMP('2026-01-01T00:00:00.000Z')
AND ts < TIMESTAMP('2026-01-02T00:00:00.000Z')
ORDER BY ts ASC
带有相应时间列的 Collection 和 TimeSeries 都可以使用这种时间范围筛选。半开区间 [start, end) 便于连续查询相邻时间窗口。
如果目标是 TimeSeries,且 temperature 是数值列,还可以按十分钟间隔采样:
SELECT TIME_SAMPLING(
temperature,
TIMESTAMP('2026-01-01T00:00:00.000Z'),
TIMESTAMP('2026-01-01T01:00:00.000Z'),
10,
MINUTE
)
如果采样时刻没有恰好对应的记录,结果会受到插值规则和邻近数据是否存在的影响,并非每十分钟任选一条原始记录。参数和边界行为见 GridDB TQL 参考。
性能和写入限制需要注意什么?
TimeSeries 针对时间范围提取和时序聚合提供专门实现,通常更适合这类负载,但这并不意味着它在所有查询或写入场景下都更快。按客户 ID 查询单条资料,与扫描某个设备一天的读数,属于不同的访问模式。GridDB C API 参考
评估时,应使用接近实际的数据量和请求比例,对比写入吞吐、范围查询延迟、非时间条件过滤及存储占用。Collection 的时间查询也应配合合适的索引,避免用未建索引的方案作比较。
TimeSeries 的时序抽稀压缩会改变数据保留和写入行为。启用相关压缩选项后,更新、单行删除以及插入早于最新时间记录的数据都存在限制;HI 模式还涉及允许误差的抽稀。如果需要保留每条原始日志,或经常接收迟到数据,应先核对这些约束。压缩模式下的限制不能概括为“所有 TimeSeries 都只能追加”。GridDB 技术参考
TimeSeries 也提供行过期配置,但需要显式设置。创建 TimeSeries 并不意味着历史数据会自动按业务需要清理;具体配置应核对部署版本和所用客户端。TimeSeriesProperties API
用户记录、传感器和日志分别怎么选?
| 场景 | 建议 | 选择依据 |
|---|---|---|
| 用户或客户记录 | Collection | 通常以用户 ID、客户 ID 定位,并需要修改资料 |
| IoT 传感器读数 | 优先评估 TimeSeries | 适合按设备时间线读取、采样和计算指标,但需保证容器内时间戳唯一 |
| 日志或事件记录 | 根据唯一键和查询方式决定 | 同一时间可能产生多条事件;若以事件 ID 定位并要求逐条保留,Collection 往往更直接 |
一种可行的建模方案是用 Collection 保存设备资料,按设备划分 TimeSeries 来保存读数。是否适用,还要结合设备数量、容器数量和跨设备查询需求判断。
选择时可以先确定记录的唯一键,检查同一时间是否需要保存多条记录,再确认是否需要插值、采样等时序操作,最后结合迟到数据、修改需求和保留策略进行性能验证。
备注:内容仅供参考。
