EF6 Database-First模式下Identity Insert的数据迁移问题

看起来你在做带主键保留的数据库迁移，这事儿确实得仔细处理——毕竟主键关联着整个数据的一致性，错不得。结合你给出的代码片段，我给你几个关键的优化和注意点：

1. 确保主键值被强制保留 #

EF默认会对自增主键自动生成值，这会直接覆盖你迁移过来的旧主键，所以第一步必须关闭主键的自动生成：

• 用数据注解在实体类上标记：

  public class TableName
  {
      [DatabaseGenerated(DatabaseGeneratedOption.None)]
      public int Id { get; set; }
      // 其他属性...
  }
  

• 或者用Fluent API在NewContext的OnModelCreating里配置：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<TableName>()
          .Property(t => t.Id)
          .ValueGeneratedNever();
  }
  

2. 优化批量插入性能 #

如果迁移的数据量不小，循环逐个Add会让EF的变更追踪压力很大，换成AddRange能大幅提升效率：

// 先批量转换所有需要迁移的项
var convertedItems = GetConversionItems().Select(item => Convert(item)).ToList();
// 一次性添加到上下文
newContext.TableName.AddRange(convertedItems);

3. 完善事务流程 #

你已经开启了事务，但要确保完整的提交/回滚逻辑，避免出现事务悬空的情况：

using (var oldContext = new OldContext())
using (var newContext = new NewContext())
using (var transaction = newContext.Database.BeginTransaction())
{
    try
    {
        // 可选：如果需要清空目标表（注意TRUNCATE会重置自增计数器，按需选择）
        // newContext.Database.ExecuteSqlRaw("TRUNCATE TABLE TableName;");
        
        var convertedItems = GetConversionItems().Select(Convert).ToList();
        newContext.TableName.AddRange(convertedItems);
        newContext.SaveChanges();

        // 如果有额外的SQL操作（比如更新关联数据），在这里执行
        // newContext.Database.ExecuteSqlRaw("UPDATE TableName SET ... WHERE ...");

        // 确认所有操作无误后提交事务
        transaction.Commit();
        Console.WriteLine("迁移完成，主键已成功保留！");
    }
    catch (Exception ex)
    {
        // 出错时回滚所有操作
        transaction.Rollback();
        Console.WriteLine($"迁移失败：{ex.Message}");
        throw; // 按需决定是否抛出异常，方便上层处理
    }
}

4. 处理主键冲突问题 #

如果新表中已经存在部分主键数据，提前处理冲突避免插入失败：

• 过滤重复项：先查询新表已有的主键，迁移时跳过这些项：

  var existingIds = newContext.TableName.Select(t => t.Id).ToList();
  var convertedItems = GetConversionItems()
      .Where(item => !existingIds.Contains(item.Id))
      .Select(Convert)
      .ToList();
  

• 批量合并（插入/更新）：如果需要覆盖已有数据，用SQL的MERGE语句（以SQL Server为例），避免循环判断：

  // 构造MERGE语句（注意参数化避免SQL注入）
  var mergeSql = @"
      MERGE INTO TableName AS Target
      USING (VALUES ({0})) AS Source (Id, Column1, Column2)
      ON Target.Id = Source.Id
      WHEN NOT MATCHED THEN INSERT (Id, Column1, Column2) VALUES (Source.Id, Source.Column1, Source.Column2)
      WHEN MATCHED THEN UPDATE SET Column1 = Source.Column1, Column2 = Source.Column2;";
  // 这里需要将转换后的项拼接成参数化的VALUES子句，或者用Table-Valued Parameter更安全
  

5. 其他注意事项 #

• 禁用变更追踪：如果不需要后续操作迁移后的实体，在添加时用AsNoTracking减少内存占用：newContext.TableName.AsNoTracking().AddRange(convertedItems);
• 先测小批量数据：先用少量数据验证迁移逻辑，确认主键保留正确、数据转换无误后再跑全量；
• 暂停旧库写入：如果旧库在迁移期间还有业务写入，建议先暂停写入，或者用快照隔离读取旧库数据，避免读取到不一致的数据。

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