
خب بریم سر اصل مطلب
سناریویی را در نظر بگیرید که میخواهید لیست Blogها به همراه Post هایشان که شامل کلمه خاصی است را کلاینت باز گردانید. در این احتمالا چنین کدی به نظرتان خواهد آمد.
var list = dbContext.Blogs .AsNoTracking() .Include(p => p.Posts.Where(p => p.Title.Contains("test title"))) .ToList(); return Json(list);
این کد تا قبل از EFCore 5.0 پیش نمایش 3 به خطای زیر منجر میشود چرا که EFCore از شرط گذاری روی Includeها پشتیبانی نمیکند.
System.InvalidOperationException: 'Lambda expression used inside Include is not valid.'
پس مجبوریم همه رکوردهای Include را از دیتابیس خوانده و سپس آنها را در حافظه فیلتر کنیم.
var list = dbContext.Blogs .AsNoTracking() .Include(e => e.Posts) .ToList(); list.ForEach(p => p.Posts = p.Posts.Where(p => p.Title.Contains("test title")).ToList());
1- توسط یک تایپ دلخواه (anonymous یا dto) واکشی را به صورت Projection انجام دهیم و Postها را فیلتر کنیم.
var list = dbContext.Blogs .AsNoTracking() .Select(p => new { p.Id, p.Name, Posts = p.Posts.Where(p => p.Title.Contains("test title")).ToList() }).ToList();
این دستور، کوئری SQL زیر را تولید میکند.
SELECT [b].[Id], [b].[Name], [t].[Id], [t].[BlogId], [t].[Description], [t].[Title] FROM [Blogs] AS [ LEFT JOIN ( SELECT [p].[Id], [p].[BlogId], [p].[Description], [p].[Title] FROM [Posts] AS [p] WHERE CHARINDEX(N'test title', [p].[Title]) > 0 ) AS [t] ON [b].[Id] = [t].[BlogId] ORDER BY [b].[Id], [t].[Id]
معایب این روش:
برای جلوگیری از این کثیف شدن میتوان از قابلیت Projection کتابخانه AutoMapper استفاده کرد. کوئری تولید شده و عملکرد آن عینا مشابه همین روش است ولی کد تمیزتری را موجب میشود. ( از نظر سرعت مقدار کمی کندتر است - انتهای مقاله بنچمارک آن را میتوانید مشاهده کنید)
2- از قابلیت IncludeFilter کتابخانه Z.EntityFramework.Plus.EFCore استفاده کنیم
این کتابخانه امکانات بسیار مفیدی را ارائه میدهد و شخصا برای پروژههای واقعی و بزرگ آن را پیشنهاد میدهم. اگر از امکانات آن به جا استفاده شود تاثیر بسیار زیادی روی پرفرمنس پروژه خواهد گذاشت (توصیه میکنم حتما داکیومنت آن را مطالعه کنید)
این کتابخانه کاملا رایگان است و از EFCore و EF6 (در یک پکیج جداگانه) پشتیبانی میکند. شرکت مالک آن (ZZZ) یک کتابخانه دیگر به نام Z.EntityFramework.Extensions.EFCore نیز دارد که امکانات بیشتری ارائه میدهد ولی رایگان نیست.
در این روش خواهیم داشت
var list = dbContext.Blogs .AsNoTracking() .IncludeFilter(e => e.Posts.Where(p => p.Title.Contains("test tile"))) .ToList();
این دستور کوئری SQL زیر را تولید میکند
-- EF+ Query Future: 1 of 2 SELECT [b].[Id], [b].[Name] FROM [Blogs] AS [b] ; -- EF+ Query Future: 2 of 2 SELECT [t].[Id], [t].[BlogId], [t].[Description], [t].[Title] FROM [Blogs] AS [b] INNER JOIN ( SELECT [p].[Id], [p].[BlogId], [p].[Description], [p].[Title] FROM [Posts] AS [p] WHERE CHARINDEX(N'test title', [p].[Title]) > 0 ) AS [t] ON [b].[Id] = [t].[BlogId] ;
3- کمبود این قابلیت در EFCore بسیار حس میشد (در NHibernate از قدیم این امکان وجود داشت) تا اینکه نهایتا در EFCore 5.0 پیش نمایش 3 (آخرین نسخه در حال حاضر) این قابلیت به EFCore اضافه شد.
برای استفاده از آن نیاز به هیچ کد اضافه ای نیست و به صورت معمول میتوان از متد Include همراه با شرط استفاده کرد.
var list = dbContext.Blogs .AsNoTracking() .Include(p => p.Posts.Where(p => p.Title.Contains("test title"))) .ToList();
این دستور کوئری SQL زیر را تولید میکند.
SELECT [b].[Id], [b].[Name], [t].[Id], [t].[BlogId], [t].[Description], [t].[Title] FROM [Blogs] AS [b] LEFT JOIN ( SELECT [p].[Id], [p].[BlogId], [p].[Description], [p].[Title] FROM [Posts] AS [p] WHERE CHARINDEX(N'test title', [p].[Title]) > 0 ) AS [t] ON [b].[Id] = [t].[BlogId] ORDER BY [b].[Id], [t].[Id]
بنچمارک مقایسه این روشها را میتوانید از ریپازیتوری گیتهاب زیر دریافت کنید.
https://github.com/mjebrahimi/EFCore-Include-Filtering-Benchmark
تصویر زیر نتایج آن را نشان میدهد. این شاخصها بر اساس تعداد رکورد ها، ستونها و حجم دیتای واکشی شده از دیتابیس میتواند متفاوت باشد ولی نتیجه آن از لحاظ مقایسه ای مشابه همین خواهد بود.

? کانال دات نت زوم