sqlite窗口函数最低支持版本为3.25.0,且需编译时启用enable_window_functions宏;语法上必须显式指定order by,不可省略;窗口别名不能在where中直接使用。

SQLite 窗口函数最低支持版本是 3.25.0
SQLite 在 3.25.0(2018年9月发布)才首次实现窗口函数,低于这个版本(比如常见的 3.19.0、3.8.11)执行 ROW_NUMBER() OVER 会直接报错:near "OVER": syntax error。这不是你写错了语法,而是 SQLite 引擎压根不认识 OVER 这个关键字。
验证当前版本最直接的方法是运行:SELECT sqlite_version();。如果返回结果小于 3.25.0,就别折腾窗口函数了——必须升级或改用 CTE + 相关子查询等替代方案。
即使版本 ≥3.25.0,也得确认运行时是否启用
SQLite 的窗口函数不是“版本达标就自动可用”。某些发行版(尤其是系统自带的旧包、嵌入式环境或精简编译版本)可能在编译时未开启 ENABLE_WINDOW_FUNCTIONS 宏,导致功能缺失。
仅靠 sqlite_version() 不够保险,建议补测一句实际调用:SELECT sum(1) OVER (); 或 SELECT ROW_NUMBER() OVER (ORDER BY 1);。如果报错 no such function: ROW_NUMBER 或类似提示,说明窗口函数模块没加载,得换二进制或自己编译。
PARTITION BY 和 ORDER BY 都不能省,且 ORDER BY 要稳定
SQLite 对窗口函数的语法要求比 PostgreSQL 或 MySQL 更严格:哪怕只想要全局编号,OVER () 也不合法;PARTITION BY 可省,但 ORDER BY 必须显式写出。
-
ROW_NUMBER() OVER (PARTITION BY dept ORDER BY sal DESC)✅ -
ROW_NUMBER() OVER (ORDER BY sal DESC)✅(全表排序) -
ROW_NUMBER() OVER ()❌ 报错:near ")": syntax error
更关键的是:ORDER BY 字段必须能保证行序唯一。如果 sal 有重复,ROW_NUMBER() 结果每次执行可能不同。稳妥做法是追加 rowid 或主键作为第二排序项:ORDER BY sal DESC, rowid。
WHERE 里不能直接用窗口别名,得套一层
窗口函数计算发生在 WHERE 之后、SELECT 之前,所以你不能在 WHERE 中引用 rk 这样的别名:
SELECT *, ROW_NUMBER() OVER (PARTITION BY dept ORDER BY sal DESC) AS rk FROM emp WHERE rk → 报错:<code>no such column: rk
正确做法只有两种:
- 用子查询:
SELECT * FROM (SELECT *, ROW_NUMBER() OVER (...) AS rk FROM emp) t WHERE t.rk - 用 CTE:
WITH ranked AS (SELECT *, ROW_NUMBER() OVER (...) AS rk FROM emp) SELECT * FROM ranked WHERE rk
CTE 写法更清晰,但注意 SQLite 3.25+ 才支持 CTE 与窗口函数嵌套,低版本 CTE 本身都不可用。
真正容易被忽略的点是:ORDER BY 的稳定性不是可选项,而是 SQLite 窗口函数行为可重现的前提;而运行时是否启用,比版本号更能决定你写的 SQL 能不能跑起来。










