CnosDB如何实现分页？为何limit 1查询会返回多条结果？

你观察到的LIMIT 1返回超过1条结果的现象，和时间序列（series）的查询逻辑直接相关。
CnosDB作为时序数据库，默认查询结果是按时间序列分组返回的，它的LIMIT/OFFSET语义和MySQL存在本质区别：LIMIT N不是全局限制返回总结果数，而是限制每一条匹配到的时间序列最多返回N个数据点。如果你的查询条件命中了M条不同的时间序列，写LIMIT 1时会从每条序列各取1个数据点，最终总返回条数就是M，自然会出现结果数大于1的情况。

四个相关语法的实际作用如下：

• LIMIT N：单条时间序列返回的数据点数量上限
• OFFSET N：单条时间序列返回数据点时，跳过的前序数据点个数
• SLIMIT N：整个查询命中的时间序列总返回数量上限
• SOFFSET N：返回时间序列时，跳过的前序匹配序列个数

根据分页的业务目标不同，分两种场景实现：

场景1：按时间序列维度分页 #

适用于需要分页拉取不同设备、不同标签组合对应的时间序列元数据/序列数据的场景，直接使用SLIMIT + SOFFSET组合即可。例如每页返回1条时间序列，取第2页的写法：

SELECT * FROM your_metric
WHERE time >= '2024-01-01 00:00:00' AND time < '2024-01-02 00:00:00'
SLIMIT 1 SOFFSET 1

场景2：全局数据点维度分页（和MySQL LIMIT语义一致） #

适用于需要把所有时间序列的数据点拉平后，按统一排序规则分页取固定条数结果的场景，必须通过子查询先拉平所有序列结果，再在外层做全局排序和截断，直接在主查询写LIMIT无法达到效果。例如全局按时间倒序、每页10条数据，取第3页（跳过前20条）的写法：

SELECT * FROM (
  SELECT * FROM your_metric
  WHERE time >= '2024-01-01 00:00:00' AND time < '2024-01-02 00:00:00'
)
ORDER BY time DESC
LIMIT 10 OFFSET 20

注意：时序数据库场景下不推荐深度使用大OFFSET的全局分页，当数据量较大时，大OFFSET会触发大量数据扫描，性能会出现明显下降，优先通过时间范围过滤缩小数据扫描范围后再做分页。

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