IoTSharp.EntityFrameworkCore.LiteDB 1.1.0 是面向 .NET 10 的 EF Core 10 provider,测试基线为 EF Core 10.0.14 和 LiteDB 5.0.21。本文对应正式 tag v1.1.0(提交 30cd16022b8ccf295b876cf0a50857a2949566d5),并以 GitHub Release、NuGet 包和源码实现交叉核对。
图1:先按 filter 选择行,再通过 LiteDB Bulk 写入同一事务,返回受影响行数并在失败时回滚。
ExecuteUpdate / ExecuteDelete 的有界批量合同
1.1.0 为 ExecuteUpdate 与 ExecuteDelete 提供同步和异步入口。provider 先用 LINQ filter、排序和分页确定目标,再在 LiteDB 事务中调用参数化 UpdateMany 或 DeleteMany,返回受影响行数。setter 可覆盖 scalar、shadow/FK 和复杂值叶子;唯一冲突、计算失败、取消或写入异常都会回滚整个批次。
这里的边界是合同的一部分:ChangeTracker 不会被刷新或重新物化;主键、整棵 complex、owned、继承和 join-shaped 目标会明确拒绝。它解决的是“一个集合内、可描述的批量写入”,不是把所有 EF 更新表达式都宣称成 LiteDB 原生下推。
图2:复杂值保留嵌套结构和 null 存在性,支持投影与叶子批量更新。
ComplexProperty 以嵌套 BSON 保存存在性
必需、可选和嵌套 ComplexProperty 都以嵌套 BSON 持久化。实现额外保存 null presence,因此 null、全空对象和默认值对象不会被压成同一种状态;完整投影、叶子查询、关闭后重开以及复杂叶子批量更新都有测试。ToJson 容器名是 BSON 别名,不能推导出关系数据库的 JSON 列或 SQL 合同。
复杂集合仍是 provider 缺口。LiteDB 引擎本身能存嵌套数组,不能把这个缺口归咎于引擎限制;需要集合语义时,当前路线是 owned collection 或显式 converter,并按 provider 的实际支持范围验证。
图3:已验证能力、明确缺口、运行环境和仍需单独验证的 AOT/规范套件分别记录。
生成值、重开与归档迁移
HasLiteDBDefaultExpression 与 HasLiteDBComputedExpression 使用 LiteDB 表达式,并把 store-generated 值回写到跟踪实体;Bulk 路径也会重新计算值,失败时回滚。compiled model 的生成、UseModel CRUD 和关闭重开已通过验证;这不等于预生成查询或 NativeAOT 运行时通过。
1.1.0 还提供版本化 JSONL/BSON 归档导出和显式映射导入。它要求调用者选择集合和映射,不自动原地升级,也不承诺直接读取旧 provider 文件。生产数据库迁移、完整 EF specification suite 和 NativeAOT runtime 仍是独立的验证层。
能力边界先于宣传
发行包元数据标识了测试源码提交,官方 NuGet V2 feed 的新消费者验证了 async CRUD、bulk/complex/generated values、reopen 和事务回滚。本文把这些证据与 provider 仍未支持的复杂集合、query precompile、NativeAOT runtime 分开记录。项目源码见 IoTSharp/EntityFrameworkCore.LiteDB,包见 NuGet 1.1.0,发行提交见 30cd160。