‫نحوه‌ی اعمال فیلتر بر روی روی داده‌های مرتبط (جوین‌شده) در Entity Framework Core

• هدف: Filtered Includes به شما اجازه می‌دهد در زمان لود داده‌های مرتبط (مثل روابط یک‌به‌چند یا چندبه‌چند) شرط‌هایی را اعمال کنید تا فقط داده‌های موردنظر بارگذاری شوند.
• مزیت: این کار باعث کاهش حجم داده‌های لودشده از دیتابیس و بهبود عملکرد کوئری می‌شود. همچنین کد را خواناتر و تمیزتر می‌کند.

var query = dbContext.Entity
    .Include(e => e.RelatedEntities.Where(condition));

• Entity: جدول یا موجودیت اصلی.
• RelatedEntities: مجموعه داده‌های مرتبط (مثل یک لیست در رابطه یک‌به‌چند).
• condition: شرط فیلتری که روی داده‌های مرتبط اعمال می‌شود.

public class Order
{
    public int Id { get; set; }
    public decimal TotalAmount { get; set; }
    public List<OrderItem> OrderItems { get; set; }
}

public class OrderItem
{
    public int Id { get; set; }
    public int OrderId { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
}

var query = dbContext.Orders
    .Select(o => new
    {
        Order = o,
        OrderItems = o.OrderItems.Where(oi => oi.Quantity > 2).ToList()
    });

• نتیجه به صورت یک شیء ناشناس (anonymous type) برگردانده می‌شود، نه خود مدل Order.
• ممکن است نیاز به پردازش اضافی در سمت کلاینت داشته باشد.

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 2));

• نتیجه: تمام سفارشات لود می‌شوند، اما فقط آیتم‌هایی که Quantity > 2 دارند در مجموعه OrderItems هر سفارش قرار می‌گیرند.
• خروجی SQL: EF Core یک کوئری SQL تولید می‌کند که جوین را با شرط فیلتر ترکیب می‌کند، بنابراین فقط داده‌های موردنظر از دیتابیس لود می‌شوند.

1. پشتیبانی از روابط یک‌به‌چند و چندبه‌چند:

• Filtered Includes در روابط یک‌به‌چند (مثل Order و OrderItems) و چندبه‌چند (با استفاده از جدول واسطه) کار می‌کند.
• برای روابط یک‌به‌یک، معمولاً نیازی به فیلتر نیست، چون فقط یک موجودیت مرتبط وجود دارد.

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 2))
    .Include(o => o.Customer);

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 2))
        .ThenInclude(oi => oi.Product);

• Filtered Includes معمولاً کوئری‌های بهینه‌تری تولید می‌کند، چون فیلتر در سطح SQL اعمال می‌شود و داده‌های غیرضروری از دیتابیس لود نمی‌شوند.
• با این حال، باید مراقب باشید که شرط‌های پیچیده در فیلتر باعث تولید کوئری‌های سنگین نشوند.

• Filtered Includes فقط روی مجموعه‌ها (collections) کار می‌کند، نه روی روابط تک‌موجودیتی (single entity).
• در برخی موارد پیچیده، ممکن است همچنان نیاز به استفاده از Select یا کوئری‌های خام SQL باشد.

• Select با پروجکشن: همان‌طور که در مثال بالا دیدیم، این روش انعطاف‌پذیر است، اما ممکن است مدل‌های اصلی را تغییر دهد یا خوانایی کد را کاهش دهد.
• Explicit Loading: لود کردن داده‌های مرتبط به صورت دستی با Load، که نیاز به چندین درخواست به دیتابیس دارد.
• کوئری‌های خام SQL: نوشتن کوئری SQL به صورت دستی، که کنترل کامل می‌دهد، اما نگهداری کد را سخت‌تر می‌کند.

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 2));

SELECT o.*, oi.*
FROM Orders o
LEFT JOIN OrderItems oi ON o.Id = oi.OrderId AND oi.Quantity > 2

public class Order
{
    public int Id { get; set; }
    public decimal TotalAmount { get; set; }
    public DateTime OrderDate { get; set; }
    public int CustomerId { get; set; }
    public Customer Customer { get; set; }
    public List<OrderItem> OrderItems { get; set; }
}

public class OrderItem
{
    public int Id { get; set; }
    public int OrderId { get; set; }
    public int ProductId { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
    public Product Product { get; set; }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int CategoryId { get; set; }
    public Category Category { get; set; }
}

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List<Order> Orders { get; set; }
}

public class Category
{
    public int Id { get; set; }
    public string Name { get; set; }
}

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 3))
        .ThenInclude(oi => oi.Product.Where(p => p.Category.Name == "Electronics"));

• Include اول فقط آیتم‌های سفارش با Quantity > 3 را لود می‌کند.
• ThenInclude روی محصولات مرتبط با آیتم‌های فیلترشده اعمال می‌شود و فقط محصولاتی که در دسته‌بندی "Electronics" هستند را شامل می‌شود.

• خروجی SQL تقریبی:

SELECT o.*, oi.*, p.*
FROM Orders o
LEFT JOIN OrderItems oi ON o.Id = oi.OrderId AND oi.Quantity > 3
LEFT JOIN Products p ON oi.ProductId = p.Id
INNER JOIN Categories c ON p.CategoryId = c.Id AND c.Name = 'Electronics'

var query = dbContext.Orders
    .Where(o => o.OrderDate.Year == 2024)
    .Include(o => o.OrderItems.Where(oi => oi.Price > 50))
    .Include(o => o.Customer);

• Where اول روی جدول اصلی (Orders) اعمال می‌شود و فقط سفارشات سال ۲۰۲۴ را انتخاب می‌کند.
• Include اول آیتم‌های سفارش با قیمت بیش از ۵۰ را لود می‌کند.
• Include دوم اطلاعات مشتری را برای هر سفارش اضافه می‌کند.

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 5 && oi.Price > 100))
    .Where(o => o.OrderItems.Any(oi => oi.Quantity > 5 && oi.Price > 100));

• Include آیتم‌هایی را لود می‌کند که هم Quantity > 5 و هم Price > 100 باشند.
• Where روی جدول اصلی تضمین می‌کند که فقط سفارشاتی برگردانده شوند که حداقل یک آیتم با این شرایط داشته باشند (بدون این شرط، سفارشات بدون آیتم هم ممکن است برگردانده شوند).

SELECT o.*, oi.*
FROM Orders o
LEFT JOIN OrderItems oi ON o.Id = oi.OrderId AND oi.Quantity > 5 AND oi.Price > 100
WHERE EXISTS (
    SELECT 1
    FROM OrderItems oi2
    WHERE oi2.OrderId = o.Id AND oi2.Quantity > 5 AND oi2.Price > 100
)

var query = dbContext.Customers
    .Include(c => c.Orders.Where(o => o.OrderDate.Year == 2024));

• Include فقط سفارشاتی را لود می‌کند که در سال ۲۰۲۴ ثبت شده‌اند.
• این کار مستقیماً روی رابطه چندبه‌چند اعمال می‌شود.

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 2))
    .Select(o => new
    {
        OrderId = o.Id,
        TotalAmount = o.TotalAmount,
        OrderItems = o.OrderItems.OrderBy(oi => oi.Price).Select(oi => new
        {
            oi.Id,
            oi.Quantity,
            oi.Price
        })
    });

• Include آیتم‌های با Quantity > 2 را لود می‌کند.
• OrderBy آیتم‌ها را بر اساس قیمت مرتب می‌کند.
• Select خروجی را به یک مدل سبک‌تر محدود می‌کند تا فقط فیلدهای موردنیاز برگردانده شوند.

var query = dbContext.Orders
    .AsNoTracking()
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 3));

var query = dbContext.Orders
    .AsSplitQuery()
    .Include(o => o.OrderItems.Where(oi => oi.Quantity > 3))
    .Include(o => o.Customer);

var query = dbContext.Orders
    .Include(o => o.OrderItems.Where(oi => oi.Product != null && oi.Product.Price > 100));