如何提升EF.Property操作SQL Server时态表代码的可读性？

针对SQL Server时态表的PeriodStart/PeriodEnd属性查询冗余问题，推荐以下几种简洁且EF Core可解析的实现方式：

1. 基于表达式树的通用扩展方法 #

直接封装时态条件为IQueryable扩展，无需修改实体类，EF Core能完美解析表达式树：

public static class TemporalQueryExtensions
{
    public static IQueryable<T> FilterRecentChanges<T>(this IQueryable<T> queryable, DateTime lastSyncTime, DateTime currentUtcTime)
    {
        var param = Expression.Parameter(typeof(T), "e");
        var periodStart = Expression.Property(param, "PeriodStart");
        var periodEnd = Expression.Property(param, "PeriodEnd");

        var startCondition = Expression.GreaterThan(periodStart, Expression.Constant(lastSyncTime));
        var endCondition = Expression.LessThan(periodEnd, Expression.Constant(currentUtcTime));
        var combined = Expression.AndAlso(startCondition, endCondition);

        return queryable.Where(Expression.Lambda<Func<T, bool>>(combined, param));
    }
}

调用时只需传入时间参数，代码极度简洁：

queryable.FilterRecentChanges(lastSyncTimestamp, utcNow);

2. 强类型接口+实体映射方案 #

通过定义统一接口规范时态属性，结合EF Core Fluent API映射数据库字段，实现完全强类型的查询：

第一步：定义时态实体接口 #

public interface ITemporalEntity
{
    DateTime PeriodStart { get; }
    DateTime PeriodEnd { get; }
}

第二步：在实体类实现接口（无需手动赋值，由SQL Server维护） #

public class YourEntity : ITemporalEntity
{
    public int Id { get; set; }
    // 其他业务属性...
    
    // 显式声明时态属性，由数据库自动维护
    public DateTime PeriodStart { get; private set; }
    public DateTime PeriodEnd { get; private set; }
}

第三步：在DbContext中映射时态字段 #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<YourEntity>(entity =>
    {
        // 标记为时态表的起始/结束字段
        entity.Property(e => e.PeriodStart)
              .HasColumnName("PeriodStart") // 匹配数据库列名
              .Metadata.IsTemporalPeriodStart = true;
        
        entity.Property(e => e.PeriodEnd)
              .HasColumnName("PeriodEnd")
              .Metadata.IsTemporalPeriodEnd = true;
        
        // 启用时态表（如果未通过数据库脚本启用）
        entity.ToTable(tb => tb.IsTemporal(temporal =>
        {
            temporal.UseHistoryTable($"YourEntityHistory");
            temporal.HasPeriodStart("PeriodStart");
            temporal.HasPeriodEnd("PeriodEnd");
        }));
    });
}

第四步：编写强类型扩展方法 #

public static IQueryable<T> FilterRecentChanges<T>(this IQueryable<T> queryable, DateTime lastSyncTime, DateTime currentUtcTime)
    where T : ITemporalEntity
{
    return queryable.Where(e => e.PeriodStart > lastSyncTime && e.PeriodEnd < currentUtcTime);
}

此方案兼顾类型安全与可读性，适合长期维护的项目。

3. 利用EF Core原生时态查询API（EF Core 6+） #

如果使用EF Core 6及以上版本，可直接使用原生时态查询API简化变更查询：

// 查询lastSyncTimestamp到utcNow之间发生过变更的实体历史记录
var changedRecords = queryable
    .TemporalBetween(lastSyncTimestamp, utcNow)
    .Select(e => new { e.Id, e.PeriodStart, e.PeriodEnd });

若需关联当前实体，可结合历史表查询实现需求，原生API性能更优。

内容的提问来源于stack exchange，提问作者Jakube