.NET 开源 ORM mooSQL 年度复盘:补齐国产库、分表、主从自动灾切

mooSQL 一年复盘:从 SQLBuilder 工具库,升级支持国产库、分表、主从灾切的.NET 数据基础设施

时间周期:2025‑10 ~ 2026‑10,版本迭代 v8.0.0.x → v8.2.1.8,累计 457 次提交

做.NET 后端开发,ORM 组件大家接触很多。有的上手简单,但碰到国产数据库、分表、读写分离、自动灾切场景,就要到处写补丁、堆适配代码。

mooSQL 前几年定位是好用的 SQLBuilder 轻量 ORM,过去 12 个月做了一次底层大换血:外表链式 API 尽量兼容老代码,内核全面重构,目标打造成一套适配国产 / 云数据库、支持缓存分片、高可用灾切、跟进.NET 10 的数据访问基础设施。

开源仓库:
https://github.com/sailuosi/mooSQL

一年前后对比,发生了哪些质变?

表格

维度

一年前现状

当前 v8.2 版本

版本

第三代初期,迈向 8.0

8.2.1.8,SQLBuilder 内核完成纯净重写

运行时

.NET6/8

.NET Framework4.5+ / 6 /8 /10全平台支持,测试工程跟进 NET10

查询能力

SQLBuilder、Clip、仓储、Fast LINQ

原有能力 + Ext LINQ 标准 IQueryable,双 LINQ 并行可用

多数据库支持

零散独立方言

MySQL 家族、PostgreSQL 家族 + 独立方言体系,国产库深度适配

高可用能力

简易主从雏形

读写分离、健康探活、自动灾切、双写完整能力

数据分片

单表为主

时间 / 自定义分表,支持跨分片QueryRange查询

性能能力

主打比 EF 更轻量

L1/L2 步骤缓存、结果缓存、批量分桶写入,完整 ORM 基准对照

版本演进路线,三次大的技术跃迁

8.0 系列:补齐异步、导航、批处理基础底座(2026‑01~03)

SQLBuilder 从同步拼装升级完整异步体系;增加导航实体加载保存、批量命令、汇总分页、方言元数据接口,把日常业务开发的基础能力全部夯实。

8.1 系列:高可用 + 分表 + 双 LINQ 成型(2026‑04~07)

主从架构大修,引入健康检测、故障自动切换;实现自动分表组件;新增useQueryable也就是 Ext LINQ,同时保留原有 Fast LINQ,两套查询管线共存;支持 AOT 源码生成、仓储切面钩子。

8.2 系列:内核重构,方言全家桶落地(2026‑08~10)

这是变化最大的一版。SQLBuilder 不再直接拼接字符串,改用Step 步骤编排模型、延迟参数、L1/L2 脚本缓存,大幅优化动态同构查询性能;同时大规模扩充数据库方言,重点打通 PostgreSQL 及一众国产 PG 系数据库;完善富仓储、批量 Insert/Update 分桶、插入主键回填能力。

提交峰值出现在 6、8、10 三个月,合计 300 + 提交,分别对应分表 LINQ 融合、SQLBuilder 内核重写、国产数据库方言适配三大攻坚阶段。

五大核心演进方向,解决真实项目痛点


 

1、方言家族化,国产、云数据库不再打补丁

早期每个数据库一套独立方言,很多适配逻辑重复。现在重新做家族分类:

  • MySQL Family:MySQL、MariaDB、TiDB、OceanBase MySQL、PolarDB‑MySQL 等
  • PostgreSQL Family:PostgreSQL、openGauss、GaussDB、人大金仓、CrateDB
  • 独立方言:SQL Server、Oracle、达梦、DuckDB、ClickHouse、GBase8a、Oscar 等
  • provides 扩展包:小众云数据库通过UseXxx()按需注册,不会让核心包无限膨胀

实战提示:新项目不要笼统写 MySQL,尽量指定精确数据库类型(PolarDBMySQL/MariaDB),规避方言兼容坑。

PG 系做了深度适配:建表语句、字段注释、标识符大小写、枚举、实体物化全部链路打通,PG、人大金仓这类项目建议升级到8.2.1.5 以上版本。

2、SQLBuilder 内核大改:外表不变,内部换成步骤缓存

8.2.0.1 是里程碑版本。

  • 链式调用不再直接拼接 SQL 字符串,记录为可哈希 Step 步骤对象
  • 延迟参数,whereIn这类动态条件模板可以反复复用
  • L1/L2 脚本缓存,大量重复动态条件场景减少 SQL 渲染开销

对外 API 尽量向下兼容,老的select / where / setPage写法不用大面积改,性能收益主要释放给大量动态条件、多 Join、重复模板查询业务场景。同时补齐递归 CTE、结果一级缓存等能力。

3、双 LINQ 策略:Fast LINQ 和 Ext LINQ,按需选择,互不替代

很多.NET 开发者纠结 ORM:想要灵活控制 SQL,又希望能平滑迁移 EF 的 IQueryable 写法。mooSQL 给出双路线:

表格

查询入口

定位场景

Fast LINQ(useDbBus)

mooSQL 原生特色,强掌控感,Bus Join、DoUpdate 直接执行

Ext LINQ(useQueryable)

标准 IQueryable,熟悉 EF 的开发者可以直接上手,支持 Include、Merge

官方立场很明确:Ext LINQ 不会取代 Fast LINQ。追求精细 SQL 控制选 Builder/Fast LINQ;从 EF 迁移、习惯标准 Queryable 就用 Ext,两套心智不要混用。

4、仓储、分表、批量写入:面向大数据量业务

  • 自动分表:通过[SooTable]特性配置分片模式,仓储支持ForShard、跨片QueryRange,自动 DDL 批量建表,适合日志、流水、审批实例这类需要冷热分表业务(比如前面 SailFlow 工作流就依赖这套分表能力)。
  • 富仓储:实体导航加载保存、变更跟踪、Upsert、库表结构自动校验。
  • 批量能力升级:批量插入、分桶多行批量 Update、各方言适配插入主键 Returning 回填,大批量数据操作性能显著提升。
  • AOT 与切面钩子:实体转换切面OnInsertField,支持源码生成,适配原生 AOT 部署场景。

5、运行时韧性:从工具库走向中台级可用

以前很多 ORM 只管好单库单连接,线上碰到主从故障、并发抢占连接就容易踩坑。

mooSQL 8.1‑8.2 补齐运维韧性能力:

  1. 主从集群:健康探活、读写分离、故障自动灾切、双写防护;
  2. 读写软闸门:方法级标记连接可读 / 可写,不需要解析 SQL 文本;
  3. 执行器串行闸:避免同一个 Executor 被并发抢占污染连接;
  4. SQL 运行监听:可以监听慢 SQL、按表 / 语句类型审计日志;
  5. 实例池配置全部去除静态变量,支持多实例共存,适合模块化宿主程序。

写在最后

mooSQL 并没有丢掉自己 “SQL 语义优先” 的初心。写代码依旧接近手写 SQL 的阅读体验,不会强迫你学习一套全新的抽象语法。

这一年的变化藏在底层:同样一行链式代码背后,现在拥有步骤缓存、故障灾切、分表分片、规模化方言家族、两套 LINQ 管线。

简单总结三个版本定位:

8.0 让日常开发好用;8.1 让系统可运维、支持分片;8.2 完成内核可扩展,国产 / 云数据库方言规模化落地。

后续版本重点会打磨批量写入 Staging 能力、扩充更多国产库适配、完善性能基准复现、完善文档体系。

欢迎正在做.NET 后端、OA、业务中台、国产数据库适配的同学,前往仓库体验、提 Issue、PR 一起打磨。

仓库地址:
https://github.com/sailuosi/mooSQL

相关文档指引(仓库内部)

  • 更新日志:doc/docs/SQL/configs/updatelog.md
  • 数据库支持矩阵:doc/design/features/方言/数据库支持清单.md
  • 批量写入优化设计文档:doc/design/features/仓储/批量写入性能优化.md
posted @ 2026-11-14 21:58  sleveen  阅读(30)  评论(0)    收藏  举报