EF Core 6批量开启所有实体时态表（Temporal Tables）方法咨询

核心批量配置实现 #

无需手动为每个实体单独配置，直接在OnModelCreating中遍历所有实体类型，统一启用时态表：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 保留你的其他自定义配置（如实体关系、索引等）
    // base.OnModelCreating(modelBuilder);

    // 遍历所有实体类型，批量启用时态表
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        // 跳过视图、无表映射的实体（按需调整过滤规则）
        if (entityType.IsView() || string.IsNullOrEmpty(entityType.GetTableName()))
            continue;

        // 为实体配置时态表
        modelBuilder.Entity(entityType.ClrType)
            .ToTable(entityType.GetTableName(), tableBuilder => tableBuilder.IsTemporal());
    }
}

可选：自定义历史表与周期列 #

如果需要自定义历史表命名或系统周期列名称，可在配置中扩展：

.ToTable(entityType.GetTableName(), tableBuilder => tableBuilder.IsTemporal(temporalBuilder =>
{
    // 自定义历史表名（默认格式：原表名+History）
    temporalBuilder.HistoryTable($"dbo.{entityType.GetTableName()}History");
    // 自定义周期列名（默认：SysStartTime、SysEndTime）
    temporalBuilder.StartColumn("ValidFrom");
    temporalBuilder.EndColumn("ValidTo");
}));

关键注意事项 #

• 主键要求：所有要启用时态表的实体必须定义主键，SQL Server时态表强制要求基表有主键
• 实体过滤：可通过entityType.ClrType.Namespace、entityType.Name等条件，跳过不需要启用的实体（如系统表、临时实体）
• 迁移验证：运行Add-Migration AddTemporalTables生成迁移脚本后，务必检查脚本内容（尤其是历史表命名、周期列配置），避免意外修改
• 数据与性能影响：
  • 已有数据的表启用时态表时，SQL Server会自动将现有数据作为初始状态同步到历史表
  • 时态表会增加写操作开销（每次更新/删除都会写入历史表），高并发场景需评估性能损耗
  • 历史表会占用额外磁盘空间，需根据数据量规划存储

执行步骤 #

1. 替换现有OnModelCreating中的单实体配置为上述批量代码
2. 生成迁移脚本并验证
3. 执行Update-Database完成全库时态表启用

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