Melhores práticas para controle de versão de banco de dados com Prisma Migrate

Introdução

O versionamento de banco de dados é um dos maiores desafios em projetos que evoluem rapidamente. Com equipes trabalhando simultaneamente em diferentes features, manter o estado do banco de dados sincronizado com o código é fundamental para evitar erros e perda de dados. Neste artigo, você vai aprender como usar o Prisma Migrate para aplicar as melhores práticas de versionamento de banco de dados em projetos Node.js, com foco especial em ambientes de produção.

Por que versionar o banco de dados?

Assim como controlamos o versionamento do código-fonte com Git, também precisamos aplicar esse princípio aos bancos de dados. O versionamento:

• Garante consistência entre ambientes (dev, staging e produção);
• Facilita o rollback de mudanças problemáticas;
• Permite a rastreabilidade de alterações no schema;
• Melhora a colaboração entre times.

Introdução ao Prisma Migrate

Prisma Migrate é a ferramenta oficial de migração de banco de dados do Prisma. Ele permite criar e aplicar migrações baseadas em arquivos que refletem mudanças no schema definido em código.

Vantagens do Prisma Migrate

• Sincronização entre o schema .prisma e o banco de dados.
• Migrações versionadas em arquivos, versionáveis com Git.
• Facilidade de criação e aplicação de migrações.
• Controle de execução com histórico em tabela _prisma_migrations.

Ciclo de vida de uma migração com Prisma

Etapa	Comando	Descrição
Criação	npx prisma migrate dev --name nome-da-migracao	Gera e aplica a migração no ambiente local.
Revisão	npx prisma migrate resolve --applied	Marca uma migração como aplicada sem executá-la (casos específicos).
Produção	npx prisma migrate deploy	Aplica migrações pendentes no ambiente de produção.

Boas práticas ao usar Prisma Migrate

1. Versione tudo com Git

Cada nova migração gera uma pasta com SQL e metadados. Versione tudo, inclusive os arquivos dentro de /prisma/migrations, para que o time compartilhe o mesmo histórico.

2. Nomeie as migrações com significado

Evite nomes genéricos como init ou migration1. Prefira nomes como create-users-table ou add-is-admin-column-to-users, que deixam claro o propósito.

3. Mantenha um ambiente de staging

Antes de aplicar a migração em produção, teste em um ambiente o mais próximo possível da realidade. Isso ajuda a prever falhas e conflitos.

4. Nunca edite uma migração já aplicada

Em vez de editar uma migração existente, gere uma nova migração com as alterações. Isso mantém o histórico intacto e evita inconsistências entre ambientes.

5. Automatize o deploy com CI/CD

Inclua os comandos npx prisma migrate deploy no seu pipeline de CI/CD. Isso garante que todas as migrações sejam aplicadas antes do deploy do app.

6. Sincronize com o schema

Se precisar aplicar o schema atual diretamente sem migrações (casos muito específicos), use npx prisma db push. Mas evite esse comando em produção.

Estudo de caso: API com Node.js e Prisma

Imagine que você está desenvolvendo uma API de gestão de tarefas com Node.js e Prisma. Ao criar o primeiro model Task:

model Task {
  id        Int      @id @default(autoincrement())
  title     String
  completed Boolean  @default(false)
  createdAt DateTime @default(now())
}

Você executaria:

npx prisma migrate dev --name create-task-table

Isso criaria a tabela Task no banco e a primeira migração versionada. Sempre que você alterar esse model (por exemplo, adicionar uma coluna priority), uma nova migração deve ser criada.

Conclusão

Controlar o versionamento do banco de dados com Prisma Migrate é uma prática essencial para manter a estabilidade e a escalabilidade do seu projeto Node.js. Com comandos simples e um fluxo bem definido, você evita retrabalho, melhora a colaboração e garante a integridade dos dados entre ambientes.

Ao aplicar essas boas práticas no seu dia a dia, seu banco de dados se tornará tão versionável e confiável quanto seu código-fonte.

Quer aplicar essas práticas no seu projeto?

Nossa equipe pode ajudá-lo a estruturar seu banco com Prisma Migrate de forma segura e eficiente.

Solicite um orçamento