SQLite 3.53.0:3.52.0 被撤回重发,ALTER TABLE 现在能加 NOT NULL 和 CHECK
发布记录:
3.52.0 为什么撤回了
3.52.0 在 2026-03-06 被标记为 withdrawn,所有新特性挪到了 3.53.0。原因是其中一部分新特性与旧版本并不完全兼容,需要返工后才能发布。
会触发兼容问题的场景很窄:数据库中存在建立在表达式上的索引,或者建在 VIRTUAL 计算列上的索引,并且该表达式的结果是由 text 或 JSONB 输入推导出来的浮点数。只有这类库与旧版本互操作会出错,其余情况下 3.52.0 工作正常且完全向后兼容。
替代做法是先发补丁版 3.51.3(2026-03-13),修掉 WAL-reset 损坏 bug。3.53.0(2026-04-09)则是 3.52.0 的重发版本,额外修了 stale expression indexes。
WAL-reset 损坏 bug 与 checkpoint 语义
这个 bug 是多个连接同时写或 checkpoint 同一个 WAL 模式数据库时的竞态:一次 checkpoint 已经完成,第二次 checkpoint 开始,与此同时有写者在重置日志;错误的 checkpoint 进度让后来的 checkpoint 跳过本应写进主库的内容。反过来说,一次成功的 commit 不足以保证主库文件后来处于什么状态。
WAL 帧携带页面内容,重置 WAL 会复用文件开头,靠 salt 区分连续两次使用日志的帧。所以 WAL 文件大小不能当作 checkpoint 是否完成的证据——只有 TRUNCATE 成功后日志才会归零。
四种 checkpoint 的等待语义:
PASSIVE:能拷多少拷多少,不等读者,也不等写者。FULL:在文档描述的条件下等待。RESTART:在 FULL 的基础上,额外等到读者不再需要 WAL。TRUNCATE:成功后再把日志截到 0 字节。
sqlite> PRAGMA wal_checkpoint(TRUNCATE);
修复从 3.51.3 开始,3.53.0 也包含。WAL 模式、多连接并发的库建议升级,同时把「看 WAL 文件大小判断 checkpoint 是否完成」这类判断从代码里去掉。
ALTER TABLE 支持增删 NOT NULL 与 CHECK
3.53.0 之前,给已有表加 NOT NULL 或 CHECK 约束要绕重建表的路子;现在 ALTER TABLE 直接支持添加和删除这两类约束。
REINDEX EXPRESSIONS 重建表达式索引
表达式索引内容过期(stale)时,用 REINDEX EXPRESSIONS 重建:
sqlite> CREATE INDEX idx_lower ON t(lower(name));
sqlite> REINDEX EXPRESSIONS;
3.53.0 修 stale expression indexes 用的就是它。升级到 3.53.0 后,如果库里有过表达式索引,可以主动跑一次。
json_array_insert() / jsonb_array_insert()
新增两个 JSON 函数,在数组的指定位置插入元素:
sqlite> SELECT json_array_insert('[1,2,3]', '$[1]', 99);
sqlite> SELECT jsonb_array_insert('[1,2,3]', '$[1]', 99);
前者返回文本 JSON,后者返回 JSONB。
其它变化
- QRF(Query Result Formatter)库:按 TCL 的格式化方法把查询结果排到定宽屏幕上,CLI 已改用 QRF,交互式输出的对齐方式和之前有差别。
- TEMP 触发器的 body 现在可以修改和查询 main schema 里的表。
- VACUUM INTO 支持 URI 文件名作为目标,并新增
reserve=N(0..255),设置生成副本的 reserve 大小。 - 3.51 系列的底子仍在:
jsonb_each()/jsonb_tree()、carray 与 percentile 扩展编入 amalgamation(默认关闭,用-DSQLITE_ENABLE_CARRAY、-DSQLITE_ENABLE_PERCENTILE打开)、PRAGMA wal_checkpoint=NOOP、sqlite3_set_errmsg()、sqlite3_db_status64();3.51.1 和 3.51.2 修的是新优化引入的 bug,包括嵌套 EXISTS 结果错误、fts5vocab 的潜伏 bug,以及 broken-posix-lock 检测中的死锁。
3.51.3 发布说明: