re:re:actable
Урок 093 минуты чтения

Как работают связи, JOIN, индексы и N плюс 1

На этой странице
Кратко

Связи описывают отношения записей. JOIN объединяет связанные данные запросом, индекс помогает найти строки, а проблема N+1 возникает при множестве дополнительных запросов для уже загруженного списка.

Вопрос

Как получить задачи с данными владельца и почему запросы в цикле могут тормозить?

Основная идея

У одного пользователя много задач: это связь «один ко многим». В таблице tasks она представлена owner_id, который ссылается на "user".id.

Представь запрос двадцати задач, за которым следуют двадцать отдельных запросов пользователя. Всего получится 21 обращение — N+1. Даже быстрые запросы накапливают сетевые задержки.

Наглядно: N+1

N+1 (21 запрос к БД):                         JOIN (1 запрос):
SELECT * FROM tasks LIMIT 20;                 SELECT t.*, u.name
for task in tasks:                            FROM tasks t
  SELECT * FROM "user" WHERE id = ?   ×20     JOIN "user" u ON u.id = t.owner_id
                                              LIMIT 20;
время ≈ 21 × (сеть + запрос)                  время ≈ 1 × (сеть + запрос)

Как N+1 появляется в React/Next незаметно:

// Каждый TaskRow — отдельный серверный компонент со своим запросом
async function TaskRow({ task }) {
  const owner = await db.user.findById(task.ownerId); // × N
  return <li>{task.title} — {owner.name}</li>;
}
РешениеКогда
JOIN / include в ORMДанные нужны вместе всегда
Один запрос WHERE id IN (...) + сопоставление в памятиСписок id известен заранее
DataLoader / cache() с батчингомКомпоненты независимо запрашивают одни и те же сущности
Индекс на внешнем ключе (tasks.owner_id)Чтобы JOIN и фильтры не сканировали всю таблицу

Пример: один JOIN вместо цикла

// lib/task-details.ts
import "server-only";
import { pool } from "./db";
import { requireUser } from "./session";
 
export async function listTaskDetails() {
  const user = await requireUser();
  const result = await pool.query<{
    id: string; title: string; owner_name: string;
  }>(
    `SELECT t.id, t.title, u.name AS owner_name
     FROM tasks t JOIN "user" u ON u.id = t.owner_id
     WHERE t.owner_id = $1
     ORDER BY t.created_at DESC, t.id DESC LIMIT 20`,
    [user.id],
  );
  return result.rows;
}

Результат содержит название задачи и имя ее владельца. Поля email, пароль и служебные сведения не выбираются. В нашем приложении владелец у всех строк один: JOIN здесь показывает механизм, а на практике его имя можно получить из проверенной сессии без повторных запросов.

Что важно помнить

Индекс (owner_id, created_at DESC, id DESC) из миграции помогает фильтрации и сортировке списка. Индекс ускоряет не любой запрос: поиск ILIKE '%слово%' обычно требует отдельного решения, например триграммного индекса.

Индексы занимают место и замедляют запись. Добавляй их по плану запроса, а не на каждое поле. EXPLAIN показывает план; EXPLAIN ANALYZE действительно выполняет команду, поэтому его осторожно используют с изменяющими запросами.

ORM тоже может создать N+1. Использование ORM не заменяет понимание SQL, числа обращений и объема ответа.

Мини-шпаргалка

  • Внешний ключ защищает связь.
  • JOIN объединяет данные без запросов в цикле.
  • Индекс выбирают под фильтр и порядок.
  • Измеряй число запросов и план выполнения.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам