我先联网核实 SonnetDB 5.1.1 的发布信息与更新内容。
这条是开源数据库项目 SonnetDB 的版本发布。我会抓取一手发布说明和仓库页核对细节。
再确认 5.0 的背景和交付物清单,方便把 “为什么打这个补丁” 讲清楚。
核实完成:这是 IoTSharp 团队开源多模型数据引擎 SonnetDB 的补丁版本,NuGet 上确认 5.1.1 包已发布。以下按你的固定格式输出。
标题:SonnetDB 5.1.1 稳定版发布:不添新功能,把 CI、恢复夹具与公开交付验证一起处理完
SonnetDB 5.1.1 已经作为稳定版正式发布,它不是一次功能更新,而是一次 “把验证链路上的漏洞堵住” 的补丁:延续 5.0 的 API、wire 协议与数据库迁移合同,不改兼容性边界,把稳定版发布阶段暴露出来的四个验证缺口集中处理 —— 全文进程 probe 纳入主 solution、Windows Core 的 Legacy/LSM 回归拿到更充足的 job 时间、Ecosystem Soak 的 torn recovery 夹具改走原子 Point WAL v2 读取路径、CrashTests 改为等 ready 文件真正写入内容后再继续。工程门禁跑通后,v5.1.1 标签与 GitHub Release 公开,发行页分层提供 NuGet、SDK/Server bundle、安装包、连接器与校验文件,十个预期 NuGet 包全部以 5.1.1 上架,Docker Hub 的 iotsharp/sonnetdb:5.1.1 也完成读回。换句话说,这个版本卖的不是能力,而是 “你能自己复现它的发布过程” 这件事。
一、5.1.1 到底改了什么:四件事,一张表
| 改动点 | 具体内容 | 解决的实际问题 |
|---|---|---|
| 全文进程 probe 入主工程 | SonnetDB.FullTextProcessProbe 纳入主 solution | Ubuntu 与 Windows 的 REST 测试分片在 Release 构建时拥有独立的全文消费者进程,不再依赖隐式环境 |
| Legacy/LSM 回归给足时间 | Windows Core 的 Legacy/LSM 回归获得更充足的 job 总时间 | 顺序执行因总时限耗尽被取消,导致回归 “看起来失败” |
| torn recovery 夹具升级 | 改用原子 Point WAL v2 的读取路径与 AtomicPointRecord | 不再用 legacy reader 去打开 v2 段 —— 这是会直接读错或读不到的错配 |
| CrashTests ready 握手 | 父进程等 ready 文件真正写入内容后再继续 | 避免只判断 “文件已创建”,落进创建与写入之间的空阶段 |
二、为什么 “只修验证” 也值得发一个正式版
数据库这类产品,稳定版的真实风险往往不在功能不够,而在验证本身有盲区:测试看着是绿的,但它压根没验证到那条路径。SonnetDB 5.1.1 处理掉的四件事,本质都是同一类问题 —— 测试的 “前置条件” 错了。
- 分片缺进程:全文检索的消费者进程没进主工程,那么 REST 分片的测试实际测的是一个不完整的运行环境。
- 时间预算不足:CI 的 job 有总时限,Legacy/LSM 这类顺序执行的回归一旦被截断,报出来的是 timeout,而不是真实的 pass 或 fail。
- 夹具读错格式:恢复测试用的数据夹具如果还走旧读取器,测的就不是新的写入格式。
- 握手看错信号:只判断文件存在,等于把 “正在写” 误认成 “写完了”。
这四条里任何一条成立,都会让发布结论变成 “看起来很稳”。补丁的价值就在这里:把不可信的绿灯换成可回读的证据。
三、torn recovery 夹具为什么必须换成 Point WAL v2 读取路径
“torn recovery”(撕裂恢复)指的是进程或机器在写入过程中突然中断,落盘的数据是 “写了一半” 的状态,重启后要靠 WAL(预写日志)把它修回来。测这个场景,测试夹具本身必须是目标格式的真实样本。
5.1.1 的具体做法是把夹具改成用原子 Point WAL v2 的读取路径和 AtomicPointRecord 打开,而不是沿用 legacy reader。原因很实在:v2 段用旧读取器打开,要么读不出记录,要么读出来的语义跟线上不一致,那么恢复测试通过的结论就站不住。这一步改完,恢复链路上的 “测什么” 和 “线上跑什么” 才对得上。
四、CrashTests 的 ready 握手:一个容易忽略的时序坑
崩溃测试的典型流程是:父进程启动子进程 → 子进程初始化 → 子进程写 ready 文件 → 父进程看到 ready → 开始制造崩溃。
如果父进程只检查 “文件是否存在”,就会撞上一个很窄但真实存在的窗口:文件已经被创建,但内容还没写完。此时父进程以为可以开始了,实际上子进程还没准备好,测试结果就开始漂移 —— 有时过、有时挂,还查不出原因。
5.1.1 把它改成等文件真正写入内容后再继续。这是一行级别的改动,但换来的是崩溃测试从 “偶发不稳定” 变成 “可重复”。
五、公开交付物怎么核对:分层清单
| 层级 | 交付物 | 核对方式 |
|---|---|---|
| 源码 | v5.1.1 标签、提交 a7bd7c9… | 仓库可查 |
| 发行页 | GitHub Release v5.1.1 | 含 NuGet、SDK/Server bundle、安装包、连接器、校验文件 |
| .NET 包 | 十个预期 NuGet 包 | 均以 5.1.1 提供,SonnetDB 包约 915 KB,目标框架 net10.0 |
| 容器 | iotsharp/sonnetdb:5.1.1 | Docker Hub 已读回 |
需要强调的是,官方在说明里把 “已发布” 严格限定为公开交付物存在且完成读回,不把本地构建成功或单次测试通过当成线上消费证据。这个口径值得点赞 —— 它把 “我这儿能跑” 和 “全世界能装” 分开了。
六、这次明确没覆盖的边界,务必看清
发布门禁不覆盖以下路线,它们各自还有独立的验收合同:
- EF Provider 的 NativeAOT 场景;
- 完整九模型 typed Client;
- 固定硬件条件下的性能结论;
- 干净系统安装;
- 时序 us/ns 精度;
- 物理掉电场景;
- 168 小时长稳测试;
- IoTSharp 真实消费者接入。
另外,单库备份不覆盖 Server 实例级的 MQ、身份配置和外部对象。如果你打算把 5.1.1 直接推上生产,这几项需要你自己按业务场景补验收,别把 “稳定版” 三个字读成 “所有场景都验过了”。
七、升级建议
- 先确认你在 5.0 基线上。5.1.1 只延续 5.0 的 API/wire/ 迁移合同,跨大版本升级的迁移仍需单独走。
- 优先跑一遍恢复相关用例。这个版本动得最多的就是恢复夹具与握手,你自己的恢复脚本值得重跑。
- Windows 部署重点回归 Legacy/LSM。CI 时间预算的修正直接影响这条路径的结论可信度。
- 容器方式用 iotsharp/sonnetdb:5.1.1,别沿用旧 tag 做对比实验。
- 需要 AOT 就绕开 ADO.NET 包。SonnetDB NuGet 包明确声明非 AOT 兼容,AOT 场景应直接用 SonnetDB.Core 的 Tsdb API。
一句话记住:SonnetDB 5.1.1 是一次 “把测试的可信度修好” 的稳定版 ——功能没变,但全文 probe、CI 时间预算、WAL v2 恢复夹具、ready 握手这四处一旦补上,发布结论才从 “看着绿” 变成 “能复现”,而边界仍然清楚地摆在那里。
【相关 FAQ】
问题 1:SonnetDB 5.1.1 稳定版相比 5.0 有哪些实际变化?
回答 1:SonnetDB 5.1.1 是稳定性与发布验证补丁,不引入新功能,延续 5.0 的 API、wire 与迁移合同。实际变化集中在验证链路:全文进程 probe 纳入主 solution、Windows Core Legacy/LSM 回归获得更充足的 job 时间、torn recovery 夹具改用原子 Point WAL v2 读取路径、CrashTests 改为等 ready 文件真正写入内容。
问题 2:SonnetDB 5.1.1 里说的 “夹具” 是什么意思,为什么要在意?
回答 2:夹具(fixture)是测试用的固定输入样本。SonnetDB 5.1.1 把恢复到一半数据的 torn recovery 夹具改成用 Point WAL v2 的读取路径和 AtomicPointRecord 打开,如果还用旧读取器打开 v2 段,测的就不是线上真实格式,恢复测试通过也没有意义。夹具对不上,测试结论就是假的。
问题 3:SonnetDB 5.1.1 的 CI 改动对普通用户有影响吗?
回答 3:直接影响不大,但间接影响很关键。SonnetDB 5.1.1 修的是 CI 分片的可信度 —— 全文消费者进程独立、Legacy/LSM 回归拿到足够 job 时间,减少因总时限耗尽被取消的假失败。这意味着你看到的 “CI 全绿” 更接近真实情况,而不是被截断或被环境掩盖的结果。
问题 4:SonnetDB 5.1.1 的公开交付验证具体核对到什么程度?
回答 4:公开交付验证做了分层核对:v5.1.1 标签与提交可查、GitHub Release 发行页提供 NuGet、SDK/Server bundle、安装包、连接器和校验文件、十个预期 NuGet 包均以 5.1.1 提供、Docker Hub 的 iotsharp/sonnetdb:5.1.1 完成读回。官方明确不把本地构建或单次测试当作线上消费证据。
问题 5:SonnetDB 5.1.1 稳定版能直接上生产吗?
回答 5:要看场景。SonnetDB 5.1.1 的发布门禁不覆盖 EF Provider NativeAOT、完整九模型 typed Client、固定硬件性能、干净系统安装、时序 us/ns、物理掉电、168 小时长稳和 IoTSharp 真实消费者;单库备份也不覆盖 Server 实例级 MQ、身份配置与外部对象。生产上线前建议按自己的部署方式补做这些验收。
【参考资料】
[2026-11-16](SonnetDB 5.1.1 稳定版发布:收口 CI、恢复夹具与公开交付验证)开源中国(OSCHINA)
[2026-11-16](SonnetDB 5.1.1:稳定性与发布验证补丁)IoTPaper
[2026-11-16](SonnetDB 5.1.1)NuGet Gallery
[2026-11-14](SonnetDB 5.0 正式发布:增强 SQL 与事务,开放九模型 MCP 读写)CSDN(麦壳饼)
[2026-11-13](ROADMAP—SonnetDB 产品路线图)Gitee(IoTSharp/SonnetDB)
[2026-11-05](SonnetDB 5.0 正式发布:增强 SQL 与事务,开放九模型 MCP 读写)开源中国(OSCHINA)
免责声明
本文基于 SonnetDB 官方发布说明、NuGet 包页面、Gitee 仓库路线图及开源中国、CSDN 等公开报道整理,信息截至 2026 年 11 月 16 日。文中对 CI 分片、夹具、torn recovery、ready 握手的技术解释属于对公开说明的通俗解读,不构成官方技术文档;提交哈希、包体大小、交付物清单等以官方发行页与 NuGet 页面为准,后续可能随版本更新变化。SonnetDB 为 MIT 许可的开源项目,本文仅作技术信息分享,不构成选型建议、生产部署承诺或对项目稳定性、性能的背书。引用内容版权归原作者与原媒体所有。
