Table of Contents

Provider 支持矩阵

三线验证矩阵(validation-program-design §2)——本页是实测依据页,逐格更新; 结论性表述("跨 provider 一致")以本页状态为准。

状态总览

线 状态 说明
Sqlite 🟢 PR CI 常跑 行为测试全量在 PR CI;内存/文件库
SqlServer 🟢 容器实跑通过 Testcontainers 容器腿(provider-matrix workflow / LOOM_PROVIDER_MATRIX 开启)
Npgsql 🟢 容器实跑通过 同上——早期 INSERT 方言互踩已修复(见下)

三线逐格实跑为当前状态依据;容器腿由环境变量 LOOM_PROVIDER_MATRIX=SqlServer,Npgsql 开启。

方法论

  • 矩阵轴:{Sqlite, SqlServer, Npgsql} × 功能面(过滤器族/雪花键/继承三策略/ComplexType 多列/ JSON 点路径/命名策略/主从读写分离/软删唯一索引)。
  • 落地:tests/KernLab.Loom.Ef.BehaviorTests/ProviderMatrix/——语料 + 参数化理论(每线一案例); Sqlite 腿恒跑于 PR CI,容器腿由 LOOM_PROVIDER_MATRIX=SqlServer,Npgsql 环境变量开启 (provider-matrix 夜窗 workflow,D2)。
  • 容器:Testcontainers(MsSql 2022-latest 钉版 / PostgreSQL 16)。

逐格结果(三线容器实跑)

🟢 = 三线或本线真库往返通过。

功能面 Sqlite SqlServer Npgsql
审计/软删/租户过滤器族(基础往返) 🟢 🟢 🟢
软删批删(LoomDeleteAsync 租户 frame) 🟢 🟢 🟢
继承三策略(Tph/Tpt/Tpc) 🟢 🟢 🟢
ComplexType 多列 🟢 🟢 🟢
JSON 点路径 L1 🟢 🟢 🟢
软删唯一索引 filter 🟢 🟢 🟢
命名策略(SnakeCase) 🟢 🟢 🟢
主从读写分离路由 🟢 🟢 🟢

早期 Npgsql 的 INSERT 方言互踩(静态根多容器假设导致 syntax error near "[")已修复—— Runtime 解析随 context 走(RuntimeSource 容器血统捕获,选项级委托优先),FullAudited 理论 Skip 已移除。

已知边界(入档)

  • [EfRowVersion] 仅 SqlServer 语义(#84):物化 .IsRowVersion()(数据库端 rowversion/timestamp 列)。 Sqlite 不支持——rowversion 列插入即 NOT NULL 失败(无自增版本列语义),开发/测试请用 [EfEntityFeatures(Concurrency = ...)] stamp 档(应用侧版本号)。Npgsql 需 xmin 映射(自带并发令牌), .IsRowVersion() 同样不适用——改用 stamp 档。探针断言见 BehaviorTests 的 RowVersion_SqliteBoundary。
  • EF8 AOT:冻结模型覆盖查询管线;SaveChanges 影子列快照工厂上游缺口(NativeAotNoCompiledModel) ——EF10 复测批(validation-program-design 批 4;两框架口径 D7——EF9 腿不建)。
  • 软删唯一索引 filter 文案按发射期 provider 物化(Sqlite IsDeleted = 0 / SqlServer CONVERT([bit], 0) / Npgsql false)——文案逐线验证随容器腿实跑。

复现

# Sqlite 腿(PR CI 档)
dotnet test tests/KernLab.Loom.Ef.BehaviorTests -c Release --filter 'FullyQualifiedName~ProviderMatrixTests'
# 三线全跑(需 Docker;夜窗/手动同款)
LOOM_PROVIDER_MATRIX=SqlServer,Npgsql dotnet test tests/KernLab.Loom.Ef.BehaviorTests -c Release \
  --filter 'FullyQualifiedName~ProviderMatrixTests'