FreeSql + SonnetDB:Provider 进入上游

FreeSql 的 SonnetDB Provider 已通过上游 PR #2234 合并。本文核对合并提交、接入范围和仍需独立验收的发布边界。

FreeSql 的 SonnetDB Provider 已经进入上游仓库。上游 PR #2234 的标题是 feat: add SonnetDB provider support,2026 年 11 月 1 日合并,merge commit 为 05997ef16f0d6a12f051f9a50794a2c21dcd4dc5。这篇文章记录的是源码接入和上游合并,不把它延伸成新的稳定包或完整远程验收结论。

先把两个提交身份分开

IoTSharp/FreeSql 的 master 当前包含提交 c66610d7d8be54e6fb3d9a2a0d33a2b2e6018982,提交说明为 feat(sonnetdb): complete relational provider follow-up。上游 PR 的 merge commit 则是 05997ef16f0d6a12f051f9a50794a2c21dcd4dc5。前者用于定位 IoTSharp fork 的源码快照,后者用于证明上游合并;二者各自保留,不能用一个 SHA 替代另一个来源。

FreeSql SonnetDB Provider 从独立实现进入上游仓库的合并桥接示意

图1:从 Provider、SonnetDB 数据库到上游 FreeSql 仓库的接入路径。AI 主题示意图,并非真实仓库截图。

PR 的改动集中在 Providers/FreeSql.Provider.SonnetDB、Provider 测试项目,以及 FreeSql 核心对 Provider 加载和识别的有限适配。上游文件清单可以直接在 PR files 中核对。这样的合并方式把 SonnetDB 特有的 SQL、类型和 ADO 行为留在 Provider 边界内,减少对 FreeSql 通用表达式和读取算法的改动。

Provider 覆盖的是什么

当前接入把 FreeSql 已有接口映射到 SonnetDB 的关系表和时序 measurement 两类模型。关系表路径包括参数化 CRUD、CodeFirst/DbFirst、ADO、索引和部分结构迁移;锁定读路径可以表达 FOR UPDATE、FOR UPDATE NOWAIT 和 FOR UPDATE SKIP LOCKED。时序模型仍按 TAG、FIELD 和内置 time 的独立合同处理。

FreeSql SonnetDB Provider 的关系表与时序测量边界示意

图2:FreeSql API、SonnetDB 关系表和独立 measurement 路径的边界。AI 主题示意图,并非能力全量矩阵。

这一区分很重要。关系表的 JOIN、事务和 CodeFirst 结构映射不能直接推出 measurement 具备相同的更新语义;measurement 的 VECTOR、时序窗口和追加写入也不能被包装成关系表 Provider 的通用能力。Provider 文档把这两条路径分开描述,避免用一个“支持 SonnetDB”标签掩盖模型差异。

合并之后仍然要逐层验收

源码已经合并到上游,仍有几层事实需要分别记录:匹配的 SonnetDB 包或源码身份、Provider 测试、嵌入式消费者、远程 REST/Frame 组合、正式 FreeSql 包以及现场或生产环境。上游 PR 的合并只关闭了源码集成这一个层级。

当前 Provider 文档仍把以下内容保留为边界:正式 SonnetDB 4.5 包身份、远程连接端到端、远程 DDL 事务、结构化 schema/table 元数据、StoredProcedure 消费者、FOR SHARE 以及关系表 VECTOR/GEOPOINT。这些项目需要各自的源码、包、Server 或消费者证据,不能从 PR 已合并推导为 PASS。

对接路径

FreeSql 现有接口仍是调用入口,Provider 负责把它们翻译为 SonnetDB 能够核验的 SQL、类型和 ADO 行为。建议从 Provider README 开始,再按自己的目标选择关系表或 measurement,并保留实际使用的源码/包版本。

不要把上游仓库的 master 当成已发布稳定包,也不要把 Provider 文档中的能力清单当成远程或生产验收。对于文章、示例和发布渠道,原文以本文的 IoTPaper 地址为准:https://iotpaper.net/articles/freesql/sonnetdb-provider-upstream/。

结语

这次合并的价值在于,SonnetDB Provider 不再只是一个孤立的外部适配分支,而是进入了 FreeSql 上游的可见源码路径。下一步仍应沿着源码、测试、包、Server、消费者和真实环境逐层补证;把边界写清楚,才不会让一次合并承担超出证据范围的承诺。

原文地址:https://iotpaper.net/articles/freesql/sonnetdb-provider-upstream/

本文对应的源码

  • IoTSharp/FreeSql · c66610d7d8be54e6fb3d9a2a0d33a2b2e6018982

    SonnetDB Provider 上游合并、关系表/ADO/CodeFirst/DbFirst 接入和当前 Provider 文档。

  • dotnetcore/FreeSql · 05997ef16f0d6a12f051f9a50794a2c21dcd4dc5

    上游 PR