Как работает Entity Framework Core миграции? Чем отличается Code First от Database First подход?

📚 Entity Framework Core миграции: принцип работы

Миграции в EF Core — это система контроля версий схемы базы данных, которая позволяет синхронизировать модель данных в коде (.NET классы) с реальной структурой базы данных. Это важнейший инструмент для эволюционной разработки (evolutionary database design), когда структура БД изменяется постепенно вместе с приложением.

🔄 Как работают миграции?

Процесс состоит из нескольких ключевых этапов:

1. Создание миграции

   // После изменений в DbContext или сущностях
   dotnet ef migrations add AddCustomerTable
   

   EF Core сравнивает текущую модель с предыдущей миграцией и генерирует:

   • Класс миграции (наследник Migration) с методами Up() и Down()
   • Файл модели-снимка (ModelSnapshot) — актуальное состояние модели
   • Директория Migrations с историей всех изменений

2. Структура класса миграции

   public partial class AddCustomerTable : Migration
   {
       protected override void Up(MigrationBuilder migrationBuilder)
       {
           migrationBuilder.CreateTable(
               name: "Customers",
               columns: table => new
               {
                   Id = table.Column<int>(nullable: false)
                       .Annotation("SqlServer:Identity", "1, 1"),
                   Name = table.Column<string>(maxLength: 100, nullable: false)
               },
               constraints: table => table.PrimaryKey("PK_Customers", x => x.Id));
       }
       
       protected override void Down(MigrationBuilder migrationBuilder)
       {
           migrationBuilder.DropTable(name: "Customers");
       }
   }
   

   • Up() — применяет изменения к БД
   • Down() — откатывает изменения (для восстановления предыдущего состояния)

3. Применение миграции к БД

   // Команда в терминале
   dotnet ef database update
   
   // Или программно
   context.Database.Migrate();
   

   EF Core создает специальную таблицу __EFMigrationsHistory, где хранит информацию о примененных миграциях.

4. Откат миграции

   // Откат на одну миграцию
   dotnet ef database update PreviousMigrationName
   
   // Полное удаление
   dotnet ef database drop
   

📊 Основные команды миграций

# Создание миграции
dotnet ef migrations add <Name> --project <ProjectPath>

# Обновление БД
dotnet ef database update

# Генерация SQL скрипта (без выполнения)
dotnet ef migrations script

# Удаление последней миграции
dotnet ef migrations remove

# Сброс всех миграций (осторожно!)
dotnet ef database drop

🆚 Сравнение Code First и Database First подходов

💻 Code First (Разработка от кода)

Суть подхода: Сначала пишутся классы-сущности в C#, затем EF Core генерирует схему БД.

Преимущества:

• Полный контроль над моделью данных через код
• Версионирование через систему миграций
• Независимость от конкретной СУБД на ранних этапах
• Автоматическая генерация DDL-скриптов
• Удобство работы в команде — миграции как часть исходного кода

Недостатки:

• Сложности с унаследованными базами данных
• Нужны знания EF Core для оптимизации схемы
• Риск рассинхронизации при ручном изменении БД

Пример Code First:

// 1. Определяем сущность
public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

// 2. Создаем контекст
public class AppDbContext : DbContext
{
    public DbSet<Product> Products { get; set; }
}

// 3. EF Core создаст таблицу Products автоматически

🗄️ Database First (Разработка от базы данных)

Суть подхода: Существующая база данных используется для генерации классов-сущностей.

Преимущества:

• Идеален для legacy-систем с устоявшейся схемой
• Контроль DBA — дизайн БД остается у администраторов
• Использование сложных хранимых процедур, представлений
• Меньше абстракций — работа напрямую с существующей схемой

Недостатки:

• Сложности с миграциями — изменения в БД нужно синхронизировать вручную
• Генерация кода может создавать неидеальные классы
• Потеря некоторых возможностей EF Core (наследование, сложные mapping)

Пример Database First:

# Генерация моделей из существующей БД
dotnet ef dbcontext scaffold "Server=...;Database=..." Microsoft.EntityFrameworkCore.SqlServer -o Models

📋 Ключевые различия

🎯 Практические рекомендации

Когда выбирать Code First:

• Зеленое поле (новый проект)
• Микросервисная архитектура (каждый сервис со своей БД)
• Команда fullstack разработчиков
• Прототипирование и быстрая разработка

Когда выбирать Database First:

• Интеграция с legacy-системами
• Строгие требования DBA к дизайну БД
• Сложные схемы с оптимизированными индексами, процедурами
• Корпоративные системы с устоявшейся инфраструктурой

🔄 Гибридный подход

На практике часто используется комбинированный подход:

// Часть модели - Code First
public class NewFeatureEntity { /* ... */ }

// Часть - из существующей БД
public class LegacyEntity { /* ... */ }

// В контексте:
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // Настройка Code First сущностей
    modelBuilder.Entity<NewFeatureEntity>(...);
    
    // Игнорирование или донастройка legacy сущностей
    modelBuilder.Entity<LegacyEntity>().ToTable("old_table");
}

💡 Важные нюансы работы с миграциями

1. Конфликты миграций — решаются через ресет (dotnet ef migrations remove + пересоздание)
2. Скрипты отката — всегда проверяйте Down() методы перед продакшеном
3. Параллельная разработка — используйте dotnet ef migrations script --idempotent для безопасного деплоя
4. Семантическое версионирование — именуйте миграции осмысленно: AddEmailToUser вместо Migration2025

Миграции EF Core — это мощный инструмент, который при правильном использовании значительно упрощает жизненный цикл разработки и сопровождения базы данных в .NET приложениях. Выбор между Code First и Database First зависит от конкретного проекта, командных процессов и существующей инфраструктуры.