SonnetDB 是一个以 C#/.NET 10 实现的单节点多模型数据引擎,提供时序、关系表、KV、JSON 文档、全文、向量、对象、SonnetMQ 与原生属性图等模型。最近一轮更新围绕三个实际问题展开:数据如何更可靠地保存,检索如何给出完整且有边界的结果,以及应用如何在资源受限时得到明确反馈。本文介绍已经公开交付的 v5.0.0,也介绍随后合入 main 的新能力,并在各节标明版本范围。

图 1:AI 辅助生成的 SonnetDB 主题示意图,展示 KV 存储、全文查询、准入预算与写入记录四条更新线索;不是产品实测界面、性能结果或客户案例。
已公开交付:v5.0.0 与 Web 预览
v5.0.0 已完成公开交付,可从 NuGet、GitHub Release 和 DockerHub 获取对应发布物。它继续提供同一引擎中的九模型能力,原生属性图保持 Graph Beta 的有限合同。对于希望把设备时序、业务表、文档、搜索索引和消息组织在同一节点的 .NET 应用,这减少了单独维护多种存储组件的接入工作。
安装时可以显式锁定版本,避免把最新源码示例直接套到旧包:
dotnet add package SonnetDB --version 5.0.0
该发行对应 tag v5.0.0;本文后面的“最近源码能力”属于随后合入的 main,应等待包含相应提交的新发布物,或按源码文档自行评估。
同一阶段还发布了限定范围的 Windows R1 Web Workbench Preview 4.5.0-preview.1.12。它完成了匿名四附件、290 项库存以及 Chrome/Edge 本机首跑的已归档验证,但范围明确限于 Web 预览。Studio、VS Code 与所有九模型的完整宿主旅程仍需各自验收。
最近源码能力一:KV-LSM 从可选引擎走向默认路径
近期合入的 KV-LSM 工作把关系表的存储组织、数据迁移和恢复边界进一步收紧:
- 同一数据库中的关系表可共享一个 LSM 实例,并以
StorageId前缀隔离逻辑 keyspace。 - 同一共享实例内的多表行、索引、sequence 与主行计数能够通过一个原子 WAL 批次提交;混合 legacy/独立 LSM 事务仍沿用撤销日志。
- 既有 legacy KV 和关系表可以在打开时迁移到 LSM;迁移保留版本、TTL、sequence 与 generation,并保留有条件的离线回滚路径。
- 共享 SST v3 增加 StorageId 区间属性与前缀布隆;备份固定 Version、manifest 快照和 WAL 长度,后台维护也会尊重查询、CPU 和内存阈值。
这条能力线不是“更快”这一句可以概括的。项目已记录受限容量采样、格式检查、回归和迁移强杀测试,但完整千万条规模、随机强杀 200 轮、固定硬件长期运行、NativeAOT 安装和生产验收仍是独立门槛。LSM 计量目前也只覆盖当前会话中成功发布 SST 的 flush/compaction 字节,不代表完整物理写放大。
最近源码能力二:全文过滤分页改为有界的完整过滤
原先在候选 Top-K 之后才执行过滤,会让窗口之外的匹配文档不可达,也会使 HasMore、TotalHits 和 facet 的语义不完整。现在 embedded、Server /fulltext/search 与 remote .NET SDK 统一执行有界的完整过滤搜索:
- 过滤条件先参与完整结果集的搜索语义,再形成当前页;
- 文档数、查询文本、posting 与时间都带预算;超过任一预算返回明确错误,不返回被截断后伪装成完整的结果;
- 跨页只承诺继续读取当前视图,不把它包装成跨页快照。
这使调用者能把“结果不完整”和“没有更多结果”区分开来,也让服务端、嵌入式与远程 .NET 调用在分页、排序、总命中和 facet 上保持同一合同。
最近源码能力三:请求准入与 Point WAL 继续收口
SQL 的 HTTP/Frame 数据库准入新增了有界排队期限,默认 30 秒,可配置为 1 到 300000 毫秒。调用方取消与排队超时被区分为不同终态,并复用既有 overload 结果,避免无限排队后才把失败交给客户端。
另一个正在收口的方向是单 Point WAL v2 envelope:它定义整点 CRC、严格 UTF-8、最多 1024 字段和 8 MiB 预算、LSN 上界以及有界可取消恢复。v1/v2 reader/writer 会双向拒绝不兼容组合,未知确认后封写并在重开时对账。需要特别说明的是:默认 Tsdb/WalReplay、catalog、滚动与 checkpoint 尚未切换到这条路径;它是完成代码阶段的格式合同,不是已经默认启用的时序行为变更。
面向使用者的选择
如果当前需要安装并使用已公开版本,应从 v5.0.0 的发布物和对应文档开始;如果需要评估 Web 管理体验,应把 4.5.0-preview.1.12 视为限定 Windows R1 Web 的预览。若关注 KV-LSM、全文预算或 Point WAL 的后续演进,则应以 main 的设计、变更记录和专门验证证据为准,并在生产前自行完成版本、迁移、备份恢复和环境资格评估。
源码仓库(Gitee):https://gitee.com/IoTSharp/SonnetDB
GitHub Release: v5.0.0
Web Preview: 4.5.0-preview.1.12
完整变更和边界请查看:CHANGELOG、KV-LSM 设计与路线图。欢迎用真实业务场景反馈迁移、恢复、查询预算和宿主体验中的问题。