PAYATHON 2026

GridDB 中 Collection 与 TimeSeries 容器有什么区别,分别适合哪些场景?

数据小许

选择容器时,先看记录的唯一标识和主要查询方式。用户、客户等数据通常以业务 ID 标识,适合使用 Collection;以时间戳标识采样点、经常按时间范围读取或进行时序计算的数据,通常适合使用 TimeSeries。日志和事件还需要检查时间戳是否会重复,不能只因带有时间字段就选择 TimeSeries。

两种容器的主要区别

比较项CollectionTimeSeries
数据模型通用记录集合以时间为核心的记录序列
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 来保存读数。是否适用,还要结合设备数量、容器数量和跨设备查询需求判断。

选择时可以先确定记录的唯一键,检查同一时间是否需要保存多条记录,再确认是否需要插值、采样等时序操作,最后结合迟到数据、修改需求和保留策略进行性能验证。

备注:内容仅供参考。