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.SqlServerv6.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() 也不会更新数据库——历史行本就不该被改。
