Como migrar do Prisma para o Drizzle

Guia passo a passo para uma transição tranquila e sem sofrimentos.

Escrito por Victor Mesquita

Recentemente realizei uma migração de uma codebase de um projeto que utilizava o Prisma para o Drizzle, e resolvi compartilhar algumas experiências que (eu sofri mas você não precisa) talvez possam ser úteis para você.

Antes de comerçar, o Drizzle ORM (ou somente Drizzle) é um Object Relational Mapper (ORM) leve, rápido e typesafe. Ele permite que você escreva suas queries no formato similar ao SQL e oferece suporte nativo a serverless.

Principais vantagens do Drizzle

Vamos falar um pouco sobre as principais vantagens do Drizzle em relação à outros ORMs e entender o porquê de migrar para ele.

Escrevendo SQL com segurança

O Drizzle permite que você escreva consultas que se assemelham muito ao SQL, porém são escritas utilizando typescript, que permite a verificação de tipagem estática. Isso significa que você pode aproveitar o "autocomplete" do seu editor e também evitar erros comuns de sintaxe.

Um exemplo simples de uma query para buscar um usuário pelo ID:

import { eq } from 'drizzle-orm';
import { users } from './schema';

const user = await db.select().from(users).where(eq(users.id, 1));
SELECT * FROM users WHERE id = 1;

Performático

Ele foi projetado para ser rápido e eficiente, minimizando a sobrecarga que alguns ORMs tradicionais podem introduzir. Isso é especialmente benéfico em ambientes serverless ou de alto impacto, onde a performance é crucial.

Ainda não está convencido? Da uma olhada nesse benchmark 👇

Comunidade crescente e ativa

Apesar de ser relativamente novo, o Drizzle tem uma comunidade ativa e em crescimento. Isso significa que você pode encontrar suporte, tutoriais e exemplos que serão de grande ajuda na hora de aprender e resolver problemas.

• Discord
• Twitter

Passo a passo para migrar

model User {
  id    Int     @id @default(autoincrement())
  name  String
  email String  @unique
  posts Post[]
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  authorId  Int
  author    User     @relation(fields: [authorId], references: [id])
}

import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()

export default prisma

const user = await prisma.user.findUnique({
  where: { id: 1 },
   include: {
    posts: true,
  },
});

Conclusão

Migrar para o Drizzle pode parecer uma tarefa desafiadora, mas, seguindo um passo a passo estruturado se torna um processo tranquilo!

Então para começar, eu recomendo iniciar com um projeto pequeno para se familiarizar com o processo e, aos poucos, entender como o ORM funciona antes de migrar projetos maiores!

Obrigado por ler até aqui!