Что такое метод Include в Entity Framework Core?

Метод Include в Entity Framework Core реализует стратегию жадной загрузки (Eager Loading) связанных данных. Он указывает EF Core загрузить указанные навигационные свойства сущности в рамках одного SQL-запроса (через JOIN), предотвращая проблему N+1 запроса.

Проблема N+1 (без Include):

var blogs = context.Blogs.ToList(); // 1 запрос: SELECT * FROM Blogs
foreach (var blog in blogs)
{
    // N запросов: SELECT * FROM Posts WHERE BlogId = @id
    var posts = blog.Posts.ToList(); // Ленивая загрузка вызывает отдельный запрос для каждого блога!
}

Решение с Include:

// Все данные загружаются одним запросом с JOIN
var blogsWithPosts = context.Blogs
    .Include(b => b.Posts) // Жадная загрузка постов
    .ToList();
// SQL: SELECT b.*, p.* FROM Blogs b LEFT JOIN Posts p ON b.Id = p.BlogId

Цепочка загрузки с ThenInclude:

// Загрузка вложенных связей (Блог -> Посты -> Авторы -> Контакты)
var detailedBlogs = context.Blogs
    .Include(b => b.Posts)
        .ThenInclude(p => p.Author) // Загрузка автора каждого поста
            .ThenInclude(a => a.ContactInfo) // Загрузка контактов автора
    .Include(b => b.Owner) // Можно добавить несколько независимых ветвей Include
    .ToList();

Критические best practices:

• Избегайте чрезмерной загрузки: Включайте только те данные, которые действительно нужны для текущего сценария. Загрузка огромных графов объектов (Include(...).Include(...)) убивает производительность.
• Используйте AsSplitQuery() для сложных случаев: Начиная с EF Core 5, для запросов с множеством Include, которые приводят к декартову произведению (cartesian explosion), используйте AsSplitQuery(). Это разобьет один запрос на несколько, что может быть эффективнее.
• Альтернативы:
  • Явная загрузка (Load()): Позволяет загрузить связи позже, по требованию.
  • Проекции (Select): Самый эффективный способ — запрашивать сразу только нужные поля в анонимный тип или DTO, минуя загрузку полных сущностей.

    var blogData = context.Blogs
    .Where(b => b.Id == 1)
    .Select(b => new // Проекция
    {
        BlogTitle = b.Title,
        PostTitles = b.Posts.Select(p => p.Title).ToList()
    }).FirstOrDefault();