awesome-everything EN
↑ Обратно к восхождению

Производительность

Семейства фиксов: JOIN, IN, preload и DataLoader

Суть Четыре структурных способа исправить N+1 — JOIN, батчинг через IN, ORM eager loading и DataLoader — и как выбрать нужный по кардинальности связи и источнику данных.
Высота — путь к senior
НольJuniorMiddleSenior
Ты на middle-высоте — в небе
◷ 14 min

В query-логе подтверждён N+1: 50 запросов к customers на одной странице заказов. Есть четыре способа исправить это, и у каждого свои tradeoff’ы. Выбрать неподходящий для вашей формы данных — значит сделать хуже.

Четыре семейства фиксов

1. JOIN — один запрос, один round-trip

Получить родителя и потомков в одном SQL-запросе через JOIN:

SELECT o.*, c.name AS customer_name
FROM orders o
JOIN customers c ON o.customer_id = c.id
WHERE o.user_id = 42
LIMIT 50;

Один round-trip. База данных возвращает всё слитым в один результирующий набор.

Tradeoff: для связей один-ко-многим результирующий набор дублирует колонки родителя для каждой строки-потомка. Пятьдесят заказов с пятью позициями каждый дают 250 строк, где 200 повторяют одни и те же колонки заказа. Сетевой трафик и стоимость парсинга в ORM могут перекрыть экономию на round-trip. JOIN лучше всего работает для один-к-одному или небольшого один-ко-многим (1–5 потомков на родителя).

2. IN — два запроса, без дублирования

Два round-trip’а: сначала получить родителей, затем получить всех потомков через WHERE id IN (...):

-- Запрос 1: получить все заказы
SELECT * FROM orders WHERE user_id = 42 LIMIT 50;

-- Запрос 2: получить всех customers для этих заказов
SELECT * FROM customers WHERE id IN (1, 2, 3, ..., 50);

Никакого дублирования строк. Родительский результат — 50 строк; результат потомков — до 50 строк. Каждая строка данных появляется ровно один раз.

Tradeoff: IN-список имеет практические ограничения. Postgres обрабатывает 10 000+ элементов с растущей стоимостью планировщика; MySQL имеет жёсткое ограничение по max_allowed_packet. Для большинства пагинаций (10–1000 элементов) IN — правильный выбор по умолчанию для один-ко-многим.

3. Preload / eager loading — директива ORM

Все крупные ORM предоставляют директиву, которая заранее объявляет, какие связи загружать. ORM сам выбирает JOIN или IN внутри:

# Rails — .includes выбирает стратегию
Order.where(user_id: current_user).includes(:customer).limit(50)

# Django
Order.objects.filter(user=request.user).select_related('customer')[:50]

# SQLAlchemy
session.query(Order).options(selectinload(Order.customer)).filter_by(...).limit(50)

# Prisma
prisma.order.findMany({ where: {...}, include: { customer: true } })

Все эти варианты дают 2 запроса вместо 51. Вы объявляете намерение; ORM оптимизирует тактику.

Tradeoff: если объявлять preload слишком агрессивно — загружать связи, которые запрос никогда не использует — вы тратите I/O впустую. Объявляйте только то, что нужно текущему запросу.

4. DataLoader — батчинг в рамках запроса

DataLoader (Facebook, 2015) накапливает ID-шники в очереди на протяжении всего запроса и выполняет один батч-запрос, когда event loop переходит к следующему тику:

// Создаётся один раз на запрос
const userLoader = new DataLoader(async (ids) => {
  const users = await db.user.findMany({ where: { id: { in: ids } } });
  return ids.map(id => users.find(u => u.id === id));
});

// Вызвать из любого места в запросе — каждый вызов ставит id в очередь
const user = await userLoader.load(orderId);

DataLoader даёт три свойства: (1) автоматический батчинг — множество вызовов load(id) становятся одним запросом, (2) автоматическое кэширование — повторный load(id) в том же запросе возвращает кэшированный результат без повторного запроса, (3) request scope — кэш ограничен запросом, поэтому устаревшие данные не утекают между запросами.

Tradeoff: DataLoader требует async / event-loop runtime. Добавляет сложность кэширования и небольшую latency batch-window (обычно менее 1 мс). Это правильный инструмент, когда потребности в данных разбросаны по множеству несвязанных путей в одном запросе — канонический пример — GraphQL-резолверы.

ФиксЗапросыЛучше дляTradeoff
JOIN1Один-к-одному, небольшой один-ко-многимКолонки родителя дублируются на каждую строку потомка
IN2Один-ко-многим с большим fan-outОграничения IN-списка (~10 k на Postgres)
Preload2–3Известная форма в точке запросаИзбыточная загрузка если не используется
DataLoader1 на типMulti-source, GraphQL-резолверыТребует async runtime; сложность кэша

Выбор по кардинальности

Правило большого пальца:

  • Один-к-одному → JOIN. Нет дублирования. Один trip.
  • Один-ко-многим (небольшой fan-out) → preload. ORM выбирает JOIN внутри. Просто в написании.
  • Один-ко-многим (большой fan-out) → IN-based selectinload. Избегает раздувания result set.
  • Multi-source или GraphQL → DataLoader. Батчит из несвязанных путей кода.
Почему это работает

Почему IN обходит JOIN для один-ко-многим с большим fan-out? Запрос, возвращающий 50 заказов с 20 позициями каждый через JOIN, вернёт 1 000 строк, где 950 повторяют одни и те же данные заказа. Сетевой трафик и стоимость парсинга ORM могут перекрыть экономию от одного saved round-trip. Подход через IN отправляет 2 запроса, но без дублирования: 50 строк заказов и 1 000 строк позиций, каждая появляется ровно один раз.

Практический пример: вложенный eager load

# Rails вложенный eager load:
User.find(42).projects.includes(tasks: :comments).limit(50)
# Даёт:
#   SELECT * FROM projects WHERE user_id = 42 LIMIT 50
#   SELECT * FROM tasks WHERE project_id IN (1, 2, ..., 50)
#   SELECT * FROM comments WHERE task_id IN (...)
# 3 запроса вместо 1 + 50 + 250 = 301
# Эквивалент на Django:
Project.objects.filter(user=user).prefetch_related('tasks__comments')[:50]
# SQLAlchemy:
session.query(Project).options(
    selectinload(Project.tasks).selectinload(Task.comments)
).filter_by(user_id=42).limit(50)
Викторина

Страница загружает 50 постов в блоге, у каждого список тегов (в среднем 10 тегов на пост). Какая стратегия фикса избегает дублирования в result set при минимальном количестве запросов?

Викторина

GraphQL-запрос 'me { posts { author { name } } }' для 50 постов запускает 1 + 50 запросов к авторам. Что является каноническим фиксом?

Расставь шаги по порядку

Упорядочите шаги диагностики и исправления N+1 по-сеньорски:

  1. 1 Включить DB query log или APM trace, посчитать запросы на запрос
  2. 2 Определить место вызова — часто цикл по родителям с lazy-доступом к дочерней связи
  3. 3 Выбрать семейство фикса по кардинальности: один-к-одному → JOIN; один-ко-многим → IN/selectinload; multi-source → DataLoader
  4. 4 Применить ORM-директиву или batch loader
  5. 5 Проверить, перечитав query log: количество должно упасть до 2–5 с N+1
  6. 6 Перемерить p99 — ожидать улучшения в 5–20x для типичного фикса N+1 на странице-списке
  7. 7 Добавить CI gate: бюджет количества запросов на запрос, провальные PR при регрессии
Вспомните перед уходом
  1. 01
    Пройдитесь по четырём семействам фиксов N+1 с примером, когда каждый является правильным выбором.
  2. 02
    Почему IN-based fetching часто обходит JOIN для связей один-ко-многим?
Итог

Четыре семейства фиксов N+1: JOIN (один trip, лучше для один-к-одному), IN-based батчинг (два trip’а, без дублирования, лучше для один-ко-многим fan-out), ORM preload (объявляет намерение в точке запроса) и DataLoader (батчинг в рамках запроса по множеству путей кода, канонический для GraphQL). Кардинальность определяет выбор: один-к-одному предпочитает JOIN; тяжёлый один-ко-многим предпочитает IN или selectinload; multi-source резолверы предпочитают DataLoader. После применения любого фикса проверяйте через query log — количество должно упасть с N+1 до 2–5, и p99 должен следовать по закону Амдала на доле round-trip.

Связанные уроки
встречается в159
Продолжить восхождение ↑Обнаружение N+1: query logs, APM traces и CI gates
хоткеи развернуть
поиск
K
пред. пьеса
k
след. пьеса
j
тиры
t
это меню
?
sources3
expand
  1. 01
  2. 02
  3. 03

Trademarks belong to their respective owners. Editorial reference only.