C# EF Core时态表查询方法 C#如何查询数据的历史版本

ef core 6+需手动启用时态表查询，调用astemporalall()或astemporalasof()等扩展方法，前提是sql server时态表已配置、实体映射正确且引用microsoft.entityframeworkcore.sqlserver v6.0+。

EF Core 6+ 如何启用时态表查询

EF Core 6 开始原生支持 SQL Server 时态表（Temporal tables），但必须手动开启查询历史版本的能力。默认 DbContext 只查当前数据，不自动感知 for SYSTEM_TIME。关键一步是调用 AsTemporalAll()、AsTemporalAsOf() 等扩展方法——它们来自 Microsoft.EntityFrameworkCore.SqlServer 包，且仅对映射了时态表的实体有效。

确保以下三点已满足：

• 数据库中该表已启用系统版本控制（含 ValidFrom/ValidTo 列，且有历史表）
• 实体类用 [TemporalTable] 特性或 Fluent API 配置了时态元数据
• 项目已引用 Microsoft.EntityFrameworkCore.SqlServer v6.0+

AsTemporalAsOf() 查询指定时间点快照

这是最常用的历史查询方式，对应 SQL 的 FOR SYSTEM_TIME AS OF @pointInTime。它返回该时间点“逻辑上存在”的那条记录（可能为当前行，也可能为历史行）。

注意：AsTemporalAsOf() 返回的是单个结果集（不是集合），且只适用于主键查询场景；若想查多个时间点或范围，需换用其他方法。

• 参数必须是 DateTime 或 DateTimeOffset，且精度需匹配数据库列（SQL Server 默认为 100ns，建议用 DateTime.UtcNow 避免时区歧义）
• 如果指定时间早于表最早历史记录，结果为空；晚于当前时间，则返回当前行
• 不能链式调用 .Where() 或 .OrderBy() —— EF 会报错：该方法只能用于最终查询

var user = await context.Users     .AsTemporalAsOf(DateTime.Parse("2023-05-10 14:30:00"))     .FirstOrDefaultAsync(u => u.Id == 123);

AsTemporalAll() 查所有历史版本（含当前）

对应 SQL 的 FOR SYSTEM_TIME ALL，会把当前行 + 所有历史行合并成一个结果集返回。适合做版本对比、审计日志导出等场景。

它返回 IQueryable<t></t>，可继续过滤、排序，但要注意性能：

• 历史数据量大时，AsTemporalAll() 会扫描整个历史表 + 当前表，务必加 .Where() 限定主键或时间范围
• 结果中每条记录都带 ValidFrom 和 ValidTo 字段（需在实体中映射这两列，否则值为 NULL）
• 不能与 AsNoTracking() 同时使用（EF Core 报 NotSupportedException）

var history = await context.Users     .AsTemporalAll()     .Where(u => u.Id == 123)     .OrderByDescending(u => u.ValidFrom)     .ToListAsync();

常见错误：查询无结果或抛异常

时态查询失败通常不是代码写错，而是环境或配置没到位：

• 忘记在迁移中启用时态：执行 ALTER TABLE [Users] SET (SYSTEM_VERSIONING = ON (HISTORY_TABLE = [dbo].[UsersHistory])) 后才生效
• 实体未映射 ValidFrom/ValidTo 列 → 查询能跑但字段值全为默认值，导致 AsOf 时间判断失效
• 用 AsTemporalFromTo() 时传入的 to 时间 ≤ from → 直接抛 ArgumentException
• 在 sqlite 或 postgresql 上调用这些方法 → 运行时报 NotSupportedException，因为仅 SQL Server 支持

真正容易被忽略的是：时态查询生成的 SQL 不走 EF 的常规变更跟踪，即使你查到的是历史行，修改后 SaveChanges() 也不会更新数据库——历史行本就不该被改。