Что такое IQueryable?

Развернутый ответ про IQueryable в C#

IQueryable<T> — это один из фундаментальных интерфейсов в экосистеме LINQ (Language Integrated Query), представляющий запрос, который может быть выполнен удаленно на стороне поставщика данных (например, в базе данных). В отличие от IEnumerable, который работает с данными в памяти, IQueryable формирует дерево выражений (Expression Tree), которое может быть преобразовано в специфичный для источника данных язык запросов (например, SQL).

---

Ключевые отличия IQueryable от IEnumerable

Чтобы понять суть IQueryable, полезно сравнить его с IEnumerable:

// Пример с IEnumerable - фильтрация происходит В ПАМЯТИ
IEnumerable<Product> products = dbContext.Products.ToList(); // ВСЕ данные загружаются из БД
var filtered = products.Where(p => p.Price > 100); // Фильтр выполняется в памяти приложения

// Пример с IQueryable - фильтрация происходит НА СТОРОНЕ БАЗЫ ДАННЫХ
IQueryable<Product> query = dbContext.Products; // Только формируется запрос
var filteredQuery = query.Where(p => p.Price > 100); // Выражение добавляется в дерево запроса
var result = filteredQuery.ToList(); // Выполняется SQL: SELECT * FROM Products WHERE Price > 100

---

Архитектура и основные компоненты

1. Дерево выражений (Expression Tree)

Главная техническая особенность IQueryable — он работает не с делегатами (Func<T, bool>), как IEnumerable, а с выражениями (Expression<Func<T, bool>>). Эти выражения представляют код в виде древовидной структуры данных, которую можно анализировать и преобразовывать.

// Для IQueryable - создается дерево выражений
IQueryable<Product> query = dbContext.Products;
Expression<Func<Product, bool>> expression = p => p.Price > 100;
// Это выражение можно анализировать, модифицировать и преобразовать в SQL

2. Поставщики запросов (Query Providers)

IQueryable делегирует выполнение запроса поставщику (IQueryProvider), который знает, как преобразовать дерево выражений в конкретный язык запросов:

public interface IQueryProvider
{
    IQueryable CreateQuery(Expression expression);
    IQueryable<TElement> CreateQuery<TElement>(Expression expression);
    object Execute(Expression expression);
    TResult Execute<TResult>(Expression expression);
}

Примеры популярных поставщиков:

• Entity Framework Core — преобразует в SQL
• LINQ to SQL — устаревшая технология Microsoft
• Entity Framework 6 — предыдущая версия ORM
• Сторонние провайдеры для MongoDB, ElasticSearch, Cosmos DB

---

Основные преимущества использования IQueryable

1. Отложенное выполнение (Deferred Execution)

Запрос не выполняется до тех пор, пока не потребуются результаты:

var query = dbContext.Products
    .Where(p => p.Price > 100)
    .OrderBy(p => p.Name)
    .Select(p => new { p.Name, p.Price });
    
// Запрос еще не выполнен! Только построено дерево выражений

// Выполнение происходит здесь:
var results = query.ToList(); // или ToArray(), First(), Count() и т.д.

2. Оптимизация производительности

Запрос выполняется целиком на стороне базы данных, что минимизирует передачу данных:

// Плохо: сначала загружаются все данные, затем фильтруются
var allProducts = dbContext.Products.ToList();
var expensive = allProducts.Where(p => p.Price > 1000); // Фильтр в памяти

// Хорошо: фильтрация в БД
var expensiveQuery = dbContext.Products.Where(p => p.Price > 1000).ToList();

3. Композиция запросов

Запросы можно динамически строить по частям:

IQueryable<Product> query = dbContext.Products;

if (filterByPrice)
    query = query.Where(p => p.Price > minPrice);
    
if (!string.IsNullOrEmpty(category))
    query = query.Where(p => p.Category == category);
    
if (sortByName)
    query = query.OrderBy(p => p.Name);
    
// В итоге выполнится один оптимизированный SQL-запрос
var results = query.ToList();

---

Практические примеры использования

1. Динамические фильтры в приложениях

public IQueryable<Product> BuildProductQuery(
    decimal? minPrice, 
    decimal? maxPrice, 
    string category)
{
    IQueryable<Product> query = dbContext.Products;
    
    if (minPrice.HasValue)
        query = query.Where(p => p.Price >= minPrice.Value);
        
    if (maxPrice.HasValue)
        query = query.Where(p => p.Price <= maxPrice.Value);
        
    if (!string.IsNullOrEmpty(category))
        query = query.Where(p => p.Category == category);
        
    return query.OrderBy(p => p.Name);
}

2. Пагинация с эффективными запросами

public PagedResult<Product> GetProducts(int page, int pageSize)
{
    var query = dbContext.Products.Where(p => p.IsActive);
    
    var totalCount = query.Count(); // Отдельный запрос для подсчета
    
    var items = query
        .OrderBy(p => p.Name)
        .Skip((page - 1) * pageSize)
        .Take(pageSize)
        .ToList(); // Запрос только для нужной страницы
        
    return new PagedResult<Product>(items, totalCount, page, pageSize);
}

---

Важные ограничения и предостережения

1. Не все выражения C# могут быть преобразованы

// Работает - преобразуется в SQL
var query = dbContext.Products.Where(p => p.Price > 100);

// НЕ РАБОТАЕТ - вызов метода не может быть преобразован в SQL
var badQuery = dbContext.Products.Where(p => p.Name.StartsWith("A", StringComparison.OrdinalIgnoreCase));

// Решение: использовать поддерживаемые функции
var goodQuery = dbContext.Products.Where(p => p.Name.ToLower().StartsWith("a"));

2. Проблема N+1 запросов

// Проблема: для каждого продукта выполняется отдельный запрос за категорией
var products = dbContext.Products.ToList();
foreach (var product in products)
{
    var categoryName = product.Category.Name; // Отдельный запрос здесь!
}

// Решение: использовать Include() для жадной загрузки
var productsWithCategories = dbContext.Products
    .Include(p => p.Category) // JOIN в SQL
    .ToList();

3. Материализация в неподходящий момент

// Опасный код: материализация происходит слишком рано
var products = dbContext.Products.Where(p => p.Price > 100).ToList();
var filtered = products.Where(p => p.Name.Contains("premium")); // Фильтр в памяти!

// Правильный подход: отложить материализацию
var query = dbContext.Products
    .Where(p => p.Price > 100 && p.Name.Contains("premium"))
    .ToList(); // Один эффективный запрос

---

Рекомендации по использованию

1. Используйте IQueryable для запросов к базе данных, когда нужна фильтрация/сортировка на стороне СУБД
2. Преобразуйте в IEnumerable/List когда дальнейшая обработка требует логики, которую нельзя выразить в SQL
3. Минимизируйте количество материализаций — каждая вызывает выполнение запроса
4. Используйте проекции (Select) для загрузки только нужных полей:

var lightweight = dbContext.Products
    .Where(p => p.Price > 100)
    .Select(p => new { p.Id, p.Name, p.Price }) // Только 3 поля вместо всех
    .ToList();

Заключение

IQueryable — это мощный механизм в арсенале C# разработчика, который обеспечивает типобезопасность, производительность и гибкость при работе с данными. Понимание его внутреннего устройства и правил использования критически важно для создания эффективных data-centric приложений. Главное помнить: IQueryable — это про построение запросов, а IEnumerable — про работу с результатами. Умелое сочетание этих двух подходов позволяет создавать оптимальные решения для работы с данными любой сложности.