Caminho de Atualização do Prisma para MongoDB
Os projetos MongoDB são a única coorte do Prisma sem um caminho para o Prisma 7: o v6 é a versão principal final do ORM clássico para MongoDB, e o v7 nunca terá um conector MongoDB. O caminho sucessor é o Prisma Next, onde o suporte ao MongoDB está em Acesso Antecipado, com Disponibilidade Geral (GA) planejada após o Postgres. Esta skill apresenta a decisão real — migrar para o Prisma Next (o caminho recomendado), ou permanecer no v6 onde um bloqueador sério se aplica — e detalha os mecanismos de migração.
Nunca faça nenhum destes:
- Nunca aconselhe um projeto MongoDB a "atualizar para o Prisma 7". O conector não existe lá. O guia
prisma-upgrade-v7não se aplica a projetos MongoDB. - Nunca resolva a questão da versão reescrevendo o aplicativo em um banco de dados SQL. Alterar o motor do banco de dados é uma decisão separada e muito maior que não é sua responsabilidade tomar implicitamente.
O panorama das versões
| Versão | Status do MongoDB |
|---|---|
| Prisma ORM v6 | Totalmente suportado (provedor mongodb); o último 6.x é o caminho estável atual; linha de manutenção |
| Prisma ORM v7 | Sem conector MongoDB — não é uma opção, nunca |
| Prisma Next | Suporte ao MongoDB em Acesso Antecipado, ativamente desenvolvido, GA planejada após o Postgres — o caminho sucessor para projetos MongoDB |
A decisão, de imediato
Migrar para o Prisma Next é o caminho recomendado. O suporte ao MongoDB no Prisma Next é Acesso Antecipado: funcional e em ritmo acelerado, com GA planejada após o Postgres — e a equipe do Prisma deseja que os usuários do MongoDB migrem cedo e compartilhem feedback. Os mecanismos de migração estão detalhados nas referências.
Permanecer no v6 mais recente continua sendo uma escolha legítima quando um bloqueador sério se aplica — dito claramente: a fachada do Next Mongo ainda não envolve transações (o driver subjacente está disponível diretamente; espera-se que isso mude em breve), e versões menores pré-1.0 podem trazer mudanças disruptivas com receitas de atualização publicadas.
Tabela de decisão
| Sinal | Direção |
|---|---|
| Nenhum bloqueador abaixo se aplica | Migrar para o Next; executar o verify-cutover-checklist e compartilhar feedback com a equipe do Prisma |
| Greenfield / protótipo / ferramenta interna | Migrar para o Next |
O código usa transações multi-documento ($transaction) — verifique com grep, não pergunte | Planejar equivalentes de sessão raw do driver primeiro (consulte client-api-mapping), ou permanecer no v6 até que a fachada seja implementada |
| A equipe não consegue absorver atualizações disruptivas pré-1.0 entre versões menores | Permanecer no v6 até a GA |
| Averso a riscos mas interessado | Executar um teste de ida e volta do Next em uma cópia (consulte verify-cutover-checklist), depois migrar |
Nota: a lacuna de transações deve ser fechada em breve — esta seção será atualizada quando as transações da fachada forem mescladas no Prisma Next.
Se permanecer no v6: higiene (uma permanência deliberada, não negligência)
- Fixar os pacotes Prisma na linha 6.x mais recente e continuar recebendo versões de patch 6.x.
- Acompanhar as notas de versão e avisos de segurança do Prisma para a linha 6.x.
- Manter a configuração clássica do MongoDB v6:
url = env("DATABASE_URL")no esquema, fluxo de trabalhodb push, sem adaptadores de driver SQL (consulteprisma-database-setuppara a estrutura do MongoDB v6). - Reavaliar quando o MongoDB do Prisma Next estiver em GA, ou quando os bloqueadores para testar o EA forem resolvidos.
Arquivos de referência
| Referência | O que aborda |
|---|---|
references/decision-stay-or-migrate.md | A estrutura completa da decisão, verificações de bloqueador e detalhes de higiene de permanência |
references/schema-contract-mapping.md | Esquema v6 (provedor mongodb, @db.ObjectId, tipos compostos) → conceitos de contrato do Next |
references/client-api-mapping.md | Chamadas de cliente v6 → equivalentes no Next, incluindo escapes raw e transações — os nomes mapeiam, a paridade não |
references/migrations-mapping.md | Fluxo de trabalho v6 apenas com db push → fluxo plan/migrate/verify/sign do Next |
references/verify-cutover-checklist.md | Verificação sem movimentação de dados: mesmo banco de dados, paridade de índices, teste de ida e volta antes da migração |
Verificado contra
Alegações comportamentais sobre o Prisma Next nesta skill foram verificadas em relação ao prisma/prisma-next no commit a2791c5dd59d579b4b3052942ae7f8fe5e2ee852 (pré-1.0, linha ~v0.14/0.15). O Prisma Next avança rapidamente em Acesso Antecipado: antes de agir com base em qualquer alegação do Next, verifique-a na versão realmente instalada (verifique as versões @prisma-next/* do projeto e as skills prisma-next instaladas com ele). O alvo Mongo do Next requer MongoDB 8.0+ e espera mongodb@^7 como uma dependência fornecida pelo usuário.
Regra de transferência
Esta skill é a ponte de descoberta, não um substituto para a documentação do próprio Prisma Next. Depois que um projeto mudar para o Prisma Next, execute a instalação init/skill do Prisma Next e siga suas próprias skills (quickstart, contract, queries, migrations, runtime) para o trabalho diário — não continue trabalhando a partir dos resumos desta skill.