‫چالش بهینه‌سازی کارایی در Entity Framework Core: کاهش زمان پاسخ از ۴۸۲۰ به ۲۰ میلی‌ثانیه

«پایگاه‌داده شما کند نیست؛ نگاشت‌کننده رابطه‌ای-شیء (ORM) شما در حال برقراری مکالمه‌ای با آن است که هیچ‌کس درخواست نکرده بود.»

چکیده: ابزار نگاشت شیء به رابطه مایکروسافت (Entity Framework Core)، یکی از محبوب‌ترین بسترهای دسترسی به داده در بوم‌سازگان دات‌نت به شمار می‌رود. با این وجود، عدم درک ساختار ترجمه عبارت‌های LINQ به عبارات SQL، مکانیسم‌های رهگیری تغییرات (Change Tracking) و نحوه بارگذاری مجموعه‌ها، می‌تواند به افول شدید کارایی در محیط‌های عملیاتی منجر شود. در این مقاله، به بررسی عملی و مرحله‌به‌مرحله بهینه‌سازی یک کوئری واقعی می‌پردازیم که زمان اجرای آن به کمک ابزار سنجش استاندارد BenchmarkDotNet بر بستر پایگاه‌داده SQL Server، از ۴,۸۲۰ میلی‌ثانیه به ۲۰ میلی‌ثانیه (حدود ۲۴۰ برابر بهبود) کاهش یافته است. این مقاله تکنیک‌های متعددی نظیر حذف سربار N+1، بهره‌گیری از سناریوهای No-Tracking، نگاشت دقیق مشخصه‌ها (Projections)، کوئری‌های از پیش کامپایل‌شده (Compiled Queries)، تفکیک کوئری‌ها (Split Queries) و نگاشت پایش شاخص‌ها را تحلیل کرده و در پایان یک درخت تصمیم‌گیری جامع برای معماران و توسعه‌دهندگان دات‌نت ارائه می‌دهد.

// اجرای فاجعه‌بار: زمان تقریبی ۴۸۲۰ میلی‌ثانیه
public async Task<List<AuthorDto>> GetAuthorsWithBooksAsync()
{
    var authors = await _context.Authors.ToListAsync();

    foreach (var author in authors)
    {
        var books = await _context.Books
            .Where(b => b.AuthorId == author.Id)
            .ToListAsync();

        author.Books = books;
    }

    return authors.Select(a => new AuthorDto
    {
        Id = a.Id,
        Name = a.Name,
        Books = a.Books.Select(b => new BookDto
        {
            Id = b.Id,
            Title = b.Title,
            PublishedDate = b.PublishedDate
        }).ToList()
    }).ToList();
}

• بروز مشکل معروف N+1: اجرای یک کوئری اولیه برای واکشی والدین و متعاقباً اجرای N کوئری مجزا در بدنه حلقه foreach جهت واکشی فرزندان.
• سربار رفت‌وبرگشت شبکه (Network Round-trips): برای ۱۰۰ نویسنده، ۱۰۱ بار تراکنش مستقل رفت و برگشت به سمت سرور دیتابیس ثبت می‌شود.
• فعال بودن رهگیری تغییرات (Change Tracking): موتور EF Core برای تک‌تک موجودیت‌های واکشی‌شده در حافظه، وضعیت Snapshot ایجاد می‌کند؛ در حالی که اندپوینت مورد بحث صرفاً خواندنی (Read-only) است.
• تخصیص حافظه و مادی‌سازی کامل (Over-Materialization): تمامی ستون‌های جداول Authors و Books وارد حافظه رم می‌شوند، صرفاً برای اینکه بعداً به DTO تبدیل گردند.
• فیلتر و تبدیل در حافظه اپلیکیشن (In-Memory Processing): حجم زیادی داده بدون ضرورت از خط لوله شبکه عبور داده می‌شود.

// تبدیل ۱۰۱ رفت‌وبرگشت به یک رفت‌وبرگشت شبکه
var authors = await _context.Authors
    .Include(a => a.Books)
    .ToListAsync();

var authors = await _context.Authors
    .Include(a => a.Books)
    .AsNoTracking()
    .ToListAsync();

نکته معماری: در سرویس‌های مبتنی بر معماری تمیز (Clean Architecture) یا CQRS، پیشنهاد می‌شود در کلاس کانتکست رفتار پیش‌فرض را روی No-Tracking تنظیم کنید و صرفاً در مسیرهای نیازمند نوشتن، از AsTracking() بهره ببرید:

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking);
}

• عبارت SELECT * به SELECT Id, Name, ... محدود می‌شود.
• سربار خواندن از دیسک، بسته‌بندی در شبکه و Deserialization به‌شدت افت می‌کند.
• مزیت خودکار: نگاشت مستقیم به DTO یا Anonymous Types به‌طور ضمنی رهگیری تغییرات (Change Tracking) را غیرفعال می‌کند.

var authors = await _context.Authors
    .Select(a => new AuthorSummaryDto
    {
        Id = a.Id,
        Name = a.Name,
        BookCount = a.Books.Count,
        LatestBook = a.Books
            .OrderByDescending(b => b.PublishedDate)
            .Select(b => b.Title)
            .FirstOrDefault()
    })
    .ToListAsync();

var authors = await _context.Authors
    .Include(a => a.Books)
    .Include(a => a.Awards)
    .AsSplitQuery()
    .AsNoTracking()
    .ToListAsync();

var authors = await _context.Authors
    .Include(a => a.Books.Where(b => b.IsPublished))
    .AsNoTracking()
    .ToListAsync();

private static readonly Func<AppDbContext, int, Task<AuthorSummaryDto?>> GetAuthorByIdCompiled =
    EF.CompileAsyncQuery((AppDbContext ctx, int id) =>
        ctx.Authors
            .AsNoTracking()
            .Where(a => a.Id == id)
            .Select(a => new AuthorSummaryDto 
            { 
                Id = a.Id, 
                Name = a.Name 
            })
            .FirstOrDefault());

public async Task<AuthorSummaryDto?> GetAuthorByIdAsync(int id)
{
    return await GetAuthorByIdCompiled(_context, id);
}

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // ایندکس کلید خارجی جهت تسریع در عملیات JOIN
    modelBuilder.Entity<Book>()
        .HasIndex(b => b.AuthorId)
        .HasDatabaseName("IX_Books_AuthorId");

    // ایندکس ترکیبی بر اساس نرخ انتخاب‌پذیری (Selectivity)
    modelBuilder.Entity<Book>()
        .HasIndex(b => new { b.IsPublished, b.PublishedDate })
        .HasDatabaseName("IX_Books_Published_Filter");

    modelBuilder.Entity<Author>()
        .HasIndex(a => a.Name)
        .HasDatabaseName("IX_Authors_Name");
}

اصل چیدمان ایندکس‌های ترکیبی (Composite Indexes): همواره ستونی را که انتخاب‌پذیری (Selectivity) بالاتری دارد و بخش عمده سطرها را در گام اول حذف می‌کند، در سمت چپ ایندکس قرار دهید.

public async Task<List<AuthorSummaryDto>> GetAuthorsWithBooksOptimizedAsync(
    int pageSize,
    DateTime? lastSeenDate,
    CancellationToken ct = default)
{
    return await _context.Authors
        .AsNoTracking()                                      // گام ۲: حذف رهگیری تغییرات
        .Where(a => !lastSeenDate.HasValue || a.CreatedAt > lastSeenDate)
        .OrderByDescending(a => a.CreatedAt)
        .Select(a => new AuthorSummaryDto                   // گام ۳: گزینش محدود و بهینه ستون‌ها
        {
            Id = a.Id,
            Name = a.Name,
            BookCount = a.Books.Count(b => b.IsPublished),   // محاسبه بدون لود کل ردیف‌ها
            LatestBookTitle = a.Books
                .Where(b => b.IsPublished)
                .OrderByDescending(b => b.PublishedDate)
                .Select(b => b.Title)
                .FirstOrDefault(),
            TotalPageCount = a.Books
                .Where(b => b.IsPublished)
                .Sum(b => (int?)b.PageCount) ?? 0
        })
        .Take(pageSize)                                     // کنترل حجم بسته داده در SQL
        .ToListAsync(ct);
}