SonnetDB 同时在关系表和 measurement 查询中提供窗口能力,但两条执行路径的分区、排序和可接受语法并不相同;本文用可核查的 SQL 分别演示关系 OVER 与时序 series 窗口,解释结果,并列出不能跨模型套用的边界。

AI 主题示意图,并非实测截图。
先确认本文对应的源码与发行边界
本文在 2026-11-05 对照 SonnetDB 已提交源码基线 78c2c74699e7c8231e6228b878fbaa4bf345f27a 编写,并在发布前按公开 main 的 537dc9bb9ea5bc701d722c4663593d10d26e0467 复核。本文引用的 SQL 参考、关系窗口验收审计、执行器和单元测试与写稿基线的窗口语义一致;它们说明的是源码中的嵌入式 SQL 行为,不自动等同于任一已安装 Server、SDK、REST/Frame 传输路径或正式 NuGet 包的保证。
公开 GitHub 最新正式发行是 v5.0.0,NuGet SonnetDB.Core 5.0.0 也已公开。实际部署请先核对安装版本和发布说明,再在隔离数据库执行本文语句。本文未在固定硬件、远程服务或长期负载上运行这些示例,也不把单元测试或源码审计写成吞吐量、延迟或生产验收结论。
关系表:由 PARTITION BY 和窗口排序定义一组行
先在隔离数据库准备一张关系表。每条语句可独立执行,不要依赖客户端是否允许多语句批处理:
CREATE TABLE device_events (
id INT PRIMARY KEY,
tenant_id INT,
created_at DATETIME,
value INT
);
INSERT INTO device_events (id, tenant_id, created_at, value)
VALUES (1, 10, '2026-01-01T00:00:00Z', 5);
INSERT INTO device_events (id, tenant_id, created_at, value)
VALUES (2, 10, '2026-01-01T00:01:00Z', 7);
INSERT INTO device_events (id, tenant_id, created_at, value)
VALUES (3, 10, '2026-01-01T00:01:00Z', 11);
INSERT INTO device_events (id, tenant_id, created_at, value)
VALUES (4, 20, '2026-01-01T00:00:00Z', 3);
下面的查询以 tenant_id 作为分区,并在每个分区中按时间和唯一 id 排序:
SELECT id, tenant_id, created_at, value,
row_number() OVER (
PARTITION BY tenant_id
ORDER BY created_at ASC, id ASC
) AS row_no,
count(*) OVER (PARTITION BY tenant_id) AS tenant_count,
sum(value) OVER (
PARTITION BY tenant_id
ORDER BY created_at ASC, id ASC
) AS running_total
FROM device_events
ORDER BY tenant_id, created_at, id;
按上述数据,租户 10 的 row_no 为 1、2、3,tenant_count 都是 3,running_total 为 5、12、23;租户 20 则重新从 row_no = 1 开始。窗口在 WHERE 过滤之后、最终的 ORDER BY/LIMIT/OFFSET 之前计算,因此分页不会改变已计算的分区累计值。
row_number() 必须带窗口内 ORDER BY。若只按 created_at 排序,上例中 id 为 2 和 3 的两行是同一排序键;实现会使用本次关系输入顺序打破 row_number() 的并列,但这不是跨执行的稳定保证。需要可重复编号时,应当像示例一样把唯一键显式加入窗口排序。
peer 与 NULL:累计值并非简单的逐行加法
关系表中带排序的聚合窗口采用默认的 RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW 语义。若刻意去掉 id,让两条 00:01 的记录成为同一个 peer 组:
SELECT id, created_at, value,
rank() OVER (ORDER BY created_at ASC) AS position_rank,
dense_rank() OVER (ORDER BY created_at ASC) AS dense_position_rank,
sum(value) OVER (ORDER BY created_at ASC) AS peer_running_total
FROM device_events
WHERE tenant_id = 10
ORDER BY id;
时间为 00:01 的两行具有相同显式排序键,因此 rank() 的结果是 1、2、2,而 dense_rank() 是 1、2、2;两条 peer 行共享同一个累计值 23,而不是先得到 12 再得到 23。这正是默认 RANGE peer 语义的可见结果。若想让同一时间戳中的每一行也出现稳定递增的累计值,应把唯一键加入窗口排序,而不是假设引擎会隐式选择一种行序。
升序中 NULL 排在前,降序中排在后;两个 NULL 排序键视为相同。COUNT(*) 计入 NULL 行,COUNT(expr) 忽略 NULL,其他聚合沿用关系聚合本身的 NULL 与数值类型规则。空输入仍返回零行,同时结果元数据保留窗口列的声明类型;排名列为非空 Int64。
measurement:一个 series 是天然分区,排序只接受 time ASC
measurement 的窗口不是把关系 PARTITION BY 直接搬过来。它复用每个 series 的时间升序行流,因此 series 自身就是分区。下面示例假定 readings 已有两个 tag 组合形成的 series:
SELECT time, device, value,
row_number() OVER (ORDER BY time ASC) AS row_no,
running_sum(value) OVER () AS running_total
FROM readings
WHERE time >= '2026-01-01T00:00:00Z'
ORDER BY time;
对每个 series,row_number() 都从 1 开始;它不会因为结果中出现另一个 device 的行而继续编号。OVER () 与 OVER (ORDER BY time ASC) 是该路径支持的显式形状,已有 difference、running_sum、moving_average 等时序窗口函数也可以写显式 OVER,省略 OVER 的旧语法仍兼容。
因此,关系表里用 PARTITION BY tenant_id 的写法不能照搬到 measurement。measurement 路径明确拒绝 PARTITION BY、非 time 的排序、time DESC、ROWS/RANGE frame;关系表与 measurement 的窗口实现彼此独立。文档集合和向量搜索查询目前也不支持窗口投影。遇到这些形状时应把错误当作合同拒绝,而不是期待它静默改用另一种窗口语义。
当前支持边界与验证顺序
关系表当前支持 row_number()、rank()、dense_rank()、ntile(n) 以及 count、sum、avg、min、max 的 ANSI OVER。但有几个常见形状是明确拒绝的:
- 窗口函数不能嵌套在表达式中,也不能与普通聚合、
GROUP BY或HAVING处于同一 SELECT 层。 - 显式
ROWS/RANGEframe 尚不支持;这里的 peer 行为来自默认语义,不能用语法自定义 frame。 - 关系执行会物化过滤后的行并按分区排序;有序累计聚合对 peer 前缀重算,最坏时间复杂度为
O(n²)。这不是大分区低延迟工作负载的性能承诺。 - 关系 SQL/ADO 单元测试覆盖的是嵌入式边界。远程协议 parity、固定硬件吞吐量、生产数据规模和长期稳定性仍需要独立验证。
建议在隔离环境按以下顺序核查:先用唯一键补全关系窗口排序,再分别断言同分区、多个分区、重复排序键和 NULL;然后给 measurement 准备两个实际 series,验证编号分别重置;最后故意提交一个 PARTITION BY measurement 查询和一个 ROWS 关系查询,确认目标版本返回拒绝而非悄然改变含义。
可核查来源
关注我们,扫码进群沟通
欢迎关注我们,扫码加入微信或 QQ 交流群,一起交流技术实践,分享使用经验和问题反馈。
微信交流二维码

QQ 交流群:IoTSharp,群号 63631741

请扫码并关注我们,进群沟通。若二维码暂时无法使用,可通过 QQ 群号 63631741 搜索加入。