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

Чем ORM отличается от SQL query builder

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

Это три уровня абстракции над базой. Сырой SQL через драйвер (pg, postgres.js, mysql2) — полный контроль и все возможности СУБД, но типы результатов и сборку динамических запросов приходится делать самому. Query builder (Knex, Kysely, Drizzle в SQL-подобном API) строит SQL из вызовов функций: запрос остаётся «видимым» и близким к SQL, удобно собирать динамические фильтры, а Kysely и Drizzle дают строгую типизацию. ORM (Prisma, TypeORM, MikroORM, Sequelize) отображает таблицы на сущности/модели: связи, include, миграции, валидация схемы, иногда Unit of Work и change tracking — быстрая разработка CRUD ценой меньшего контроля над SQL и риска N+1 и неэффективных запросов. На практике сочетают: ORM или builder для обычных операций и сырой SQL ($queryRaw, sql\`) для отчётов, оконных функций, ON CONFLICT`, CTE.

Вопрос

Чем отличаются ORM, query builder и сырой SQL и что выбрать?

Один запрос тремя способами

// сырой SQL (node-postgres)
const { rows } = await db.query(
  `SELECT u.id, u.email, count(o.id)::int AS orders
   FROM users u LEFT JOIN orders o ON o.user_id = u.id
   WHERE u.created_at >= $1
   GROUP BY u.id ORDER BY orders DESC LIMIT 20`,
  [since],
);
 
// query builder (Kysely)
const rows = await db
  .selectFrom("users as u")
  .leftJoin("orders as o", "o.user_id", "u.id")
  .select(["u.id", "u.email", (eb) => eb.fn.count<number>("o.id").as("orders")])
  .where("u.created_at", ">=", since)
  .groupBy("u.id")
  .orderBy("orders", "desc")
  .limit(20)
  .execute();
 
// ORM (Prisma)
const users = await prisma.user.findMany({
  where: { createdAt: { gte: since } },
  select: { id: true, email: true, _count: { select: { orders: true } } },
  orderBy: { orders: { _count: "desc" } },
  take: 20,
});

Сравнение

Сырой SQLQuery builderORM
Контроль над SQLПолныйВысокийСредний
Возможности СУБД (CTE, окна, LATERAL, ON CONFLICT)ВсеБольшинствоЧасть, остальное через raw
Типизация результатаВручную / генераторы (pgTyped, sqlc)Kysely, Drizzle — строгаяГенерируется из схемы
Динамические фильтрыНеудобноУдобноУдобно
Связи, вложенные объектыВручнуюВручнуюinclude, relations
МиграцииОтдельный инструментKnex/Drizzle KitВстроены
Риск N+1 и тяжёлых запросовНизкийНизкийВыше
Порог входаНужно знать SQLSQL + APIМожно начать без глубокого SQL

Популярные инструменты в Node.js

ИнструментТипОсобенность
PrismaORMSchema-first, генерация клиента, удобные связи
TypeORMORMДекораторы, Active Record / Data Mapper, популярен с NestJS
MikroORMORMUnit of Work, Identity Map
DrizzleORM-lite / builderTS-схема, SQL-подобный API, лёгкий
KyselyQuery builderСтрогая типизация без генерации
KnexQuery builderКлассика, миграции, слабая типизация

Ловушки ORM

// N+1 при ленивой загрузке
for (const post of posts) await post.author;
 
// загрузка всего объекта ради одного поля
const user = await prisma.user.findUnique({ where: { id } });   // SELECT все столбцы
// ✓ select: { email: true }
 
// read-modify-write вместо атомарного обновления
const p = await repo.findOneBy({ id }); p.stock -= 1; await repo.save(p);
// ✓ prisma.product.update({ where: { id }, data: { stock: { decrement: 1 } } })

Включайте логирование SQL в разработке и смотрите, что реально уходит в базу.

Как выбрать

  • CRUD-приложение, быстрый старт, команда с разным уровнем SQL → ORM (Prisma, TypeORM).
  • Много сложных и динамических запросов, важна типизация → Kysely или Drizzle.
  • Отчёты, аналитика, тонкая оптимизация → сырой SQL рядом с любым из вариантов.

Частые ошибки

  • Считать, что ORM избавляет от необходимости знать SQL и индексы.
  • Писать сложный отчёт через цепочку ORM-вызовов вместо одного SQL-запроса.
  • raw-методы с конкатенацией строк — SQL-инъекции.
  • synchronize: true в продакшене вместо миграций.

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

  • Сырой SQL — контроль, builder — SQL с типами и композицией, ORM — модели и связи.
  • ORM ускоряет CRUD, но требует контроля генерируемых запросов.
  • Комбинирование подходов — норма.

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

  • ORM: Prisma, TypeORM, MikroORM.
  • Builder: Kysely, Knex, Drizzle.
  • Raw: pg, postgres.js, $queryRaw.
  • Логи SQL в dev — всегда.

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

Prisma ORM, Kysely, Drizzle ORM, TypeORM.

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

Поиск

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