root@construct:~/logs/prisma-vs-typeorm-vs-sql-puro-a-resposta-definitiva$
<-- voltar para /logs
2026-01-31//LOG

Prisma, TypeORM e SQL puro: o que eu uso e por quê

Já usei os três em produção. Prisma no Topo Contábil, um backend em NestJS. TypeORM em dois serviços mais antigos de uma empresa onde trabalhei. SQL puro nas queries de relatório em que a performance era crítica. Depois de anos usando os três, tenho uma preferência clara.

Prisma ganha, na maioria das vezes

O Prisma tem a melhor experiência de desenvolvimento dos três. Você define os models num arquivo de schema só e ganha tipos gerados, client de query e migrações. Os tipos seguem o schema: se um model User tem email obrigatório, um prisma.user.create sem email não compila, e uma query com select: { email: true } devolve um objeto tipado só com email, então ler user.name depois dá erro de compilação. O autocomplete na IDE funciona porque o client gerado conhece cada campo, cada relação, cada formato de query possível.

O sistema de migração é sólido. prisma migrate dev gera migrações SQL a partir das mudanças no schema. Dá pra revisar, editar, e elas ficam versionadas no repositório. Você para de se perguntar qual deveria ser o estado atual do banco.

Onde o Prisma sofre: query complexa. Qualquer coisa com subquery, window function, CTE ou filtro dinâmico fica feia rápido. A API do Prisma Client não foi feita pra query analítica, e dá pra notar.

Eu pularia o TypeORM

Não consigo recomendar TypeORM pra projeto novo. As definições de entidade com decorator parecem bonitas até você precisar debugar um type mismatch e perceber que os tipos TypeScript e o comportamento em runtime são duas coisas separadas. Nada liga a opção nullable ao tipo TypeScript da propriedade: você pode declarar name: string com nullable: true e o compilador nunca vai avisar que name pode voltar null.

O query builder é poderoso, mas a API é inconsistente. Alguns métodos retornam a entidade, outros retornam resultado raw, outros retornam um objeto wrapper. Você vive checando a documentação pra saber com qual está lidando.

O TypeORM suporta Active Record e Data Mapper, e eu não acho que ele faça bem nenhum dos dois. Escolha um e metade dos exemplos na internet usa o outro.

A migração é a pior parte. As migrações geradas automaticamente produzem SQL errado com frequência. Já vi o TypeORM gerar DROP COLUMN seguido de ADD COLUMN no lugar de ALTER COLUMN numa tabela grande.

SQL puro quando você precisa

Às vezes você só precisa escrever SQL. O Prisma tem prisma.$queryRaw pra isso. Você perde type safety, mas ganha todo o poder do PostgreSQL: window function, CTE recursiva, lateral join, agregação complexa, tudo aquilo com que ORM sofre. O TypedSQL do Prisma fecha parte dessa lacuna: você escreve a query num arquivo .sql e o Prisma gera uma função tipada pra ela.

No Topo Contábil, SQL puro é uma minoria das nossas queries, todas de relatório e analytics, em que o Prisma Client ficaria verboso demais ou não consegue expressar a query.

O que eu uso

Uso Prisma como ORM principal, porque não encontrei experiência de desenvolvimento melhor, e prisma.$queryRaw quando ele não consegue expressar o que eu preciso. Evitaria TypeORM num projeto novo. Drizzle e Kysely também valem uma olhada se você quer um query builder tipado mais perto do SQL; esta comparação cobre só os três acima.

Prisma, TypeORM e SQL puro: o que eu uso e por quê | The Broad Way