IoTSharp.EntityFrameworkCore.LiteDB 1.1.0:批量更新、复杂值与嵌入式持久化边界

IoTSharp.EntityFrameworkCore.LiteDB 1.1.0 在 EF Core 10 与 LiteDB 5 上加入批量更新、ComplexProperty 嵌套 BSON 和生成值回写,同时明确 provider 与 LiteDB 的边界。

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 包和源码实现交叉核对。

LiteDB provider ExecuteUpdate 与 ExecuteDelete 的事务流程

图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 原生下推。

ComplexProperty 嵌套 BSON 与 null presence 映射

图2:复杂值保留嵌套结构和 null 存在性,支持投影与叶子批量更新。

ComplexProperty 以嵌套 BSON 保存存在性

必需、可选和嵌套 ComplexProperty 都以嵌套 BSON 持久化。实现额外保存 null presence,因此 null、全空对象和默认值对象不会被压成同一种状态;完整投影、叶子查询、关闭后重开以及复杂叶子批量更新都有测试。ToJson 容器名是 BSON 别名,不能推导出关系数据库的 JSON 列或 SQL 合同。

复杂集合仍是 provider 缺口。LiteDB 引擎本身能存嵌套数组,不能把这个缺口归咎于引擎限制;需要集合语义时,当前路线是 owned collection 或显式 converter,并按 provider 的实际支持范围验证。

IoTSharp.EntityFrameworkCore.LiteDB 1.1.0 的能力边界

图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。

原文地址:https://iotpaper.net/articles/efcore-litedb/efcore-litedb-v110/

本文对应的源码

  • IoTSharp/EntityFrameworkCore.LiteDB · 30cd16022b8ccf295b876cf0a50857a2949566d5

    ExecuteUpdate/ExecuteDelete、ComplexProperty 嵌套 BSON、LiteDB 生成值和显式归档导入及边界。