‫بررسی جامع قابلیت‌ها و بهبودهای بخش Migrations در Entity Framework Core 11.0

چکیده: مدیریت تغییرات مدل پایگاه داده (Database Migrations) همواره یکی از ارکان اساسی در چرخه حیات نرم‌افزارهای مبتنی بر داده است. با انتشار نسخه پیش‌نمایش .NET 11 RC1 و در آستانه انتشار نهایی EF Core 11.0، تیم توسعه مایکروسافت مجموعه‌ای از قابلیت‌های کلیدی و بهینه‌سازی‌های زیرساختی را برای ابزار مهاجرت (Migrations) ارائه کرده است. این بهبودها بر سه محور اصلی تمرکز دارند: ارتقای انعطاف‌پذیری مدل‌سازی برای سناریوهای داده‌ای پیچیده، تسریع جریان‌های کاری توسعه و یکپارچه‌سازی در خطوط لوله CI/CD، کاهش اصطکاک و تعارضات ناشی از کار گروهی در مخازن کنترل نسخه. این مقاله با تحلیل دقیق فنی، قابلیت‌هایی نظیر تفکیک قیدهای کلید خارجی از مهاجرت، ایجاد و اِعمال تک‌مرحله‌ای مایگریشن با کامپایل درجا (Roslyn)، ثبت شناسه آخرین مهاجرت در Model Snapshot، پشتیبانی از پیکربندی سراسری ابزار CLI و اجرای دسته‌جمعی روی چند کانتکست را مورد واکاوی قرار می‌دهد.

• پایگاه‌های داده میرا (Legacy): سیستم‌هایی که روابط رابطه‌ای در آن‌ها تعریف شده، اما به دلیل داده‌های نامعتبر تاریخی، اضافه کردن قید فیزیکی کلید خارجی باعث نقض جامعیت و شکست اسکریپت می‌شود.
• همگام‌سازی و بارگذاری داده (ETL / Data Sync): فرآیندهایی که موجودیت‌های وابسته را قبل از والد بارگذاری می‌کنند یا ترتیب درج مشخصی ندارند.
• بهینه‌سازی کارایی در جداول High-throughput: حذف هزینه چک کردن قیدهای خارجی در زمان نوشتن تراکنش‌های حجیم.

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
}

public class Order
{
    public int Id { get; set; }
    public string OrderNumber { get; set; } = string.Empty;
    public int CustomerId { get; set; }
    public Customer? Customer { get; set; }
}

public class AppDbContext : DbContext
{
    public DbSet<Customer> Customers => Set<Customer>();
    public DbSet<Order> Orders => Set<Order>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Order>()
            .HasOne(o => o.Customer)
            .WithMany()
            .HasForeignKey(o => o.CustomerId)
            .ExcludeForeignKeyFromMigrations(); // غیرفعال‌سازی ساخت قید در دیتابیس
    }
}

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateTable(
        name: "Orders",
        columns: table => new
        {
            Id = table.Column<int>(type: "int", nullable: false)
                .Annotation("SqlServer:Identity", "1, 1"),
            OrderNumber = table.Column<string>(type: "nvarchar(max)", nullable: false),
            CustomerId = table.Column<int>(type: "int", nullable: false)
        },
        constraints: table =>
        {
            table.PrimaryKey("PK_Orders", x => x.Id);
        });

    // ایندکس جهت کارایی کوئری‌ها همچنان ساخته می‌شود:
    migrationBuilder.CreateIndex(
        name: "IX_Orders_CustomerId",
        table: "Orders",
        column: "CustomerId");
}

نکته تحلیلی: اگرچه قید فیزیکی حذف می‌شود، اما سیستم Change Tracking، کوئری‌های جوین (Include) و بارگذاری تنبل/حریصانه در EF Core دقیقاً مانند یک رابطه نرمال رفتار می‌کنند. در واقع مسئولیت حفظ جامعیت ارجاعی در صورت نیاز به لایه بیزنس (Application Logic) منتقل می‌شود.

• dotnet ef migrations add
• dotnet ef database update

dotnet ef database update InitialCreate --add

Update-Database -Migration InitialCreate -Add

ارزش افزوده در توسعه مدرن: در معماری‌های مبتنی بر .NET Aspire، ابزارهای تست محلی با Testcontainers، و محیط‌های توسعه در قالب کانتینر که امکان Rebuild مجدد کل پروژه بلافاصله پس از تولید فایل وجود ندارد، این قابلیت موجب تداوم اجرای سریع کانتینر و اعمال فوری طرح‌واره می‌شود.

• توسعه‌دهنده A روی شاخه feature/auth مایگریشن اضافه می‌کند.
• توسعه‌دهنده B روی شاخه feature/catalog مایگریشن دیگری اضافه می‌کند.
• پس از Merge، هر دو مهاجرت در کدهای پروژه موجودند، اما پایگاه داده یکی از شاخه‌ها دچار تداخل ترتیب اعمال (Migration History) می‌شود.

dotnet ef migrations remove --connection "Server=dev.local;Database=TestDb;User Id=sa;Password=secret;"
dotnet ef database drop --connection "Server=dev.local;Database=TestDb;..." --force

dotnet ef migrations remove --offline

قاعده طراحی: سوئیچ‌های --offline و --forceناسازگار هستند؛ زیرا --force برای عقب‌گرد (Revert) تغییرات نیازمند اتصال فعال به پایگاه داده است تا بداند وضعیت ساختار فعلی چیست.

{
  "project": "src/Infrastructure/Persistence",
  "startupProject": "src/Presentation/Web.Api",
  "framework": "net11.0",
  "configuration": "Debug",
  "context": "ApplicationDbContext",
  "runtime": "win-x64",
  "verbose": true,
  "noColor": false,
  "prefixOutput": false
}

dotnet ef migrations list --context "*"
dotnet ef database update --context "*"
dotnet ef migrations script --context "*"
dotnet ef database drop --context "*"

Add-Migration UpdateCustomerEntity -NoBuild
Update-Database -NoBuild

• جداسازی خروجی استاندارد (StdOut و StdErr): پیام‌های تشخیصی، وضعیت و لاگ‌ها به مجرای خطای استاندارد (StdErr) هدایت شده‌اند. بدین ترتیب خروجی StdOut تنها حاوی نتیجه مورد انتظار (مانند اسکریپت SQL خالص در دستور script) خواهد بود که برای اسکریپت‌های اتوماسیون (CI/CD Pipes) بسیار کارآمد است.
• آنالایزر دستوری جدید (Analyzer & CodeFix): هشدار و اصلاح خودکار برای جایگزینی کاربردهای اشتباه ToAsyncEnumerable با فرم بهینه و صحیح AsAsyncEnumerable در کوئری‌های ناهمگام.