EF Core 9.0 中临时表迁移问题的分析与解决方案

问题背景

在从 EF Core 8 升级到 EF Core 9 的过程中，许多开发者遇到了与临时表（Temporal Tables）相关的迁移问题。这些问题主要出现在两种场景中：

1. 将普通表转换为临时表的迁移操作
2. 对已有临时表进行结构修改的迁移操作

这些问题导致现有的迁移脚本无法在 EF Core 9 环境下正常执行，阻碍了项目的升级进程。

问题表现

开发者报告的主要错误信息包括：

1. Period column 'PeriodStart' in a system-versioned temporal table cannot be altered
2. Cannot create generated always column when SYSTEM_TIME period is not defined
3. Column 'SysStartTime' in table 'MyDatabase.MySchema.MyTable' cannot be specified as 'GENERATED ALWAYS' in ALTER COLUMN statement

这些错误都指向了 EF Core 9 在处理临时表迁移时生成的 SQL 语句与 SQL Server 的临时表约束条件之间的不兼容问题。

问题根源

经过分析，这些问题源于 EF Core 9 在生成迁移脚本时对临时表处理方式的改变：

1. EF Core 9 在创建或修改临时表列时，会显式添加 GENERATED ALWAYS AS ROW START/END HIDDEN 子句
2. SQL Server 要求临时表的系统时间周期（SYSTEM_TIME period）必须与生成列的定义同时进行
3. EF Core 9 的迁移生成器将这些操作分开执行，违反了 SQL Server 的约束条件

解决方案

临时解决方案（适用于 EF Core 9.0.0 和 9.0.1）

对于需要立即升级的项目，可以手动修改迁移文件：

1. 对于 AlterColumn 操作：

   • 移除所有与临时表相关的注解（SqlServer:IsTemporal 等）
   • 如果新旧属性值相同，则完全移除该 AlterColumn 操作

2. 对于 CreateColumn 操作：

   • 移除临时表相关注解
   • 对于周期开始列，添加 Annotation("SqlServer:TemporalIsPeriodStartColumn", true)
   • 对于周期结束列，添加 Annotation("SqlServer:TemporalIsPeriodEndColumn", true)

3. 对于 CreateTable 操作：

   • 保留表级别的临时表注解
   • 移除列级别的临时表注解
   • 为周期开始和结束列分别添加相应的特殊注解

永久解决方案

EF Core 团队已经确认将在 9.0.2 版本中修复此问题。建议受影响的开发者：

1. 如果项目可以等待，建议推迟升级至 9.0.2 发布
2. 如果必须立即升级，采用上述手动修改迁移文件的方法
3. 对于新项目，可以直接使用 EF Core 9 生成新的迁移，避免此问题

最佳实践

1. 在升级前，始终在测试环境中验证所有迁移脚本
2. 考虑为关键表创建备份迁移点
3. 对于复杂的临时表变更，考虑拆分为多个简单迁移
4. 关注 EF Core 的发布说明，了解已知问题和修复情况

总结

EF Core 9 对临时表的处理方式有所改变，导致部分从早期版本升级的迁移脚本无法正常工作。开发者可以通过手动调整迁移文件暂时解决问题，或等待即将发布的 9.0.2 版本获取官方修复。理解临时表的工作原理和 SQL Server 的约束条件，有助于更好地处理这类迁移问题。