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/ SqlServerCONVERT([bit], 0)/ Npgsqlfalse)——文案逐线验证随容器腿实跑。
复现
# 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'