CommunityCodierung & Entwicklunggithub.com

prisma/prisma-mongodb-upgrade

Entscheidungs- und Migrationsleitfaden für Prisma-ORM-MongoDB-Projekte auf v6, die keinen Upgrade-Pfad zu v7 haben. Verwenden, wenn ein MongoDB-Projekt nach einem Upgrade von Prisma fragt, wenn „Upgrade auf Prisma 7“ in einem Projekt mit provider = „mongodb“ auftaucht, oder bei der Bewertung eines Wechsels zu Prisma Next. Wird ausgelöst durch „upgrade prisma mongodb“, „prisma 7 mongodb“, „mongodb prisma migration“, „prisma next mongodb“.

Was ist prisma-mongodb-upgrade?

Dieses Skill beschreibt den Upgrade-Pfad für Prisma ORM MongoDB-Projekte, die derzeit auf v6 laufen. Da Prisma v7 keinen MongoDB-Connector mehr enthält, ist v6 die letzte klassische ORM-Hauptversion für MongoDB. Der empfohlene Nachfolger ist Prisma Next, das MongoDB bereits im Early Access (EA) unterstützt. Der Skill hilft Entwicklern, die richtige Entscheidung zu treffen: entweder zu Prisma Next migrieren (empfohlener Pfad) oder bewusst auf v6 bleiben, wenn Hürden wie fehlende Transaktionsunterstützung im Next-Fassaden-Wrapper bestehen. Er enthält Entscheidungstabellen, Referenzdateien für Schema-Mapping, Client-API-Mapping und Migrationsmechaniken sowie eine Verifizierungshinweis, um sicherzustellen, dass alle Aussagen mit der tatsächlich installierten Prisma Next Version übereinstimmen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/prisma/skills/tree/main/prisma-mongodb-upgrade

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Prisma MongoDB Upgrade-Pfad

MongoDB-Projekte sind die einzige Prisma-Kohorte, für die es keinen Weg zu Prisma 7 gibt: v6 ist die letzte klassische ORM-Hauptversion für MongoDB, und v7 wird niemals einen MongoDB-Connector ausliefern. Der Nachfolgepfad ist Prisma Next, wo die MongoDB-Unterstützung im Early Access ist, mit GA nach Postgres geplant. Dieses Skill stellt die eigentliche Entscheidung dar — migrieren zu Prisma Next (der empfohlene Pfad) oder auf v6 bleiben, wenn ein harter Block besteht — und enthält die Migrationsmechaniken.

Tue niemals Folgendes:

  • Rate einem MongoDB-Projekt niemals, auf „Prisma 7 upzugraden“. Der Connector existiert dort nicht. Der prisma-upgrade-v7-Leitfaden gilt nicht für MongoDB-Projekte.
  • Löse die Versionsfrage niemals, indem du die App auf eine SQL-Datenbank umstellst. Der Wechsel der Datenbank-Engine ist eine separate, viel größere Entscheidung, die du nicht implizit treffen darfst.

Die Versionslandschaft

VersionMongoDB-Status
Prisma ORM v6Voll unterstützt (mongodb-Provider); neueste 6.x ist der aktuelle stabile Pfad; Wartungslinie
Prisma ORM v7Kein MongoDB-Connector – keine Option, niemals
Prisma NextMongoDB-Unterstützung im Early Access, aktiv entwickelt, GA nach Postgres geplant – der Nachfolgepfad für MongoDB-Projekte

Die Entscheidung, vorweg

Die Migration zu Prisma Next ist der empfohlene Pfad. Die MongoDB-Unterstützung in Prisma Next ist im Early Access: funktionsfähig und entwickelt sich schnell, mit GA nach Postgres geplant – und das Prisma-Team möchte, dass MongoDB-Benutzer früh migrieren und Feedback teilen. Die Migrationsmechaniken sind in den Referenzen detailliert beschrieben.

Auf dem neuesten v6 zu bleiben, bleibt eine legitime Wahl, wenn ein harter Block vorliegt – klar gesagt: Der Next-Mongo-Fassaden-Wrapper kapselt noch keine Transaktionen (der zugrunde liegende Treiber ist direkt verfügbar; dies wird sich voraussichtlich bald ändern), und Vor-1.0-Minor-Versionen können breaking changes mit veröffentlichten Upgrade-Rezepten enthalten.

Entscheidungstabelle

SignalRichtung
Keine der unten genannten Hürden trifft zuZu Next migrieren; die verify-cutover-checklist ausführen und Feedback mit dem Prisma-Team teilen
Neuland / Prototyp / internes ToolZu Next migrieren
Codebase verwendet Multi-Dokument-Transaktionen ($transaction) – mit grep prüfen, nicht fragenZuerst Raw-Treiber-Session-Äquivalente planen (siehe client-api-mapping) oder auf v6 bleiben, bis der Fassaden-Wrapper verfügbar ist
Team kann keine Pre-1.0-Breaking-Upgrades zwischen Minor-Versionen absorbierenBis GA auf v6 bleiben
Risikoavers, aber interessiertEinen gestaffelten Next-Roundtrip auf einer Kopie durchführen (siehe verify-cutover-checklist), dann migrieren

Anmerkung: Die Transaktionslücke wird voraussichtlich bald geschlossen – dieser Abschnitt wird aktualisiert, sobald Fassaden-Transaktionen in Prisma Next zusammengeführt werden.

Bei Verbleib auf v6: Hygiene (ein bewusster Verbleib, keine Vernachlässigung)

  • Die Prisma-Pakete auf der neuesten 6.x-Linie fixieren und weiterhin 6.x-Patch-Releases einspielen.
  • Die Prisma-Release-Notes und Sicherheitshinweise für die 6.x-Linie verfolgen.
  • Das klassische v6-MongoDB-Setup beibehalten: url = env("DATABASE_URL") im Schema, db push-Workflow, keine SQL-Treiber-Adapter (siehe prisma-database-setup für die v6-MongoDB-Form).
  • Neu bewerten, wenn Prisma Nexts MongoDB GA erreicht hat oder wenn Hürden für den EA-Test gelöst sind.

Referenzdateien

ReferenzWas sie abdeckt
references/decision-stay-or-migrate.mdDie vollständige Entscheidungsframing, Hürdenprüfungen und Details zum Verbleib mit Hygiene
references/schema-contract-mapping.mdv6-Schema (mongodb-Provider, @db.ObjectId, zusammengesetzte Typen) → Next-Konzeptverträge
references/client-api-mapping.mdv6-Client-Aufrufe → Next-Äquivalente, inkl. Raw-Escape-Hatches und Transaktionen – Namen passen, Parität nicht
references/migrations-mapping.mdv6 db push-only-Geschichte → Nexts plan/migrate/verify/sign-Ablauf
references/verify-cutover-checklist.mdDatenverschiebungsfreie Verifizierung: gleiche DB, Index-Parität, gestaffelter Roundtrip vor dem Cutover

Verifizierung

Verhaltensbehauptungen über Prisma Next in diesem Skill wurden gegen prisma/prisma-next zum Commit a2791c5dd59d579b4b3052942ae7f8fe5e2ee852 (pre-1.0, ~v0.14/0.15-Linie) verifiziert. Prisma Next entwickelt sich im Early Access schnell: Bevor du auf eine Next-seitige Behauptung handelst, verifiziere sie gegen die tatsächlich installierte Version (prüfe die @prisma-next/*-Versionen des Projekts und die damit installierten Prisma-Next-Skills). Nexts Mongo-Ziel erfordert MongoDB 8.0+ und erwartet mongodb@^7 als benutzerbereitgestellte Peer-Abhängigkeit.

Übergaberegel

Dieses Skill ist die Entdeckungsbrücke, kein Ersatz für die eigene Dokumentation von Prisma Next. Nachdem ein Projekt auf Prisma Next umgestiegen ist, führe die init/Skill-Installation von Prisma Next aus und folge dessen eigenen Skills (Quickstart, Contract, Queries, Migrations, Runtime) für die tägliche Arbeit – arbeite nicht weiterhin mit den Zusammenfassungen dieses Skills.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

prisma/prisma-cli

Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, studio, validate, format, debug, and mcp. Use for ORM/database CLI workflows, not Prisma Compute app deployment. For Prisma Compute, `@prisma/cli app deploy`, `compute:deploy`, `create-prisma --deploy`, apps, deployments, logs, or domains, use the `prisma-compute` skill instead. Triggers on "prisma init", "prisma generate", "prisma migrate", "prisma db", "prisma studio", "prisma mcp".

prisma/prisma-client-api

Prisma Client API reference covering model queries, filters, operators, and client methods. Use when writing database queries, using CRUD operations, filtering data, or configuring Prisma Client. Triggers on "prisma query", "findMany", "create", "update", "delete", "$transaction".

prisma/prisma-compute

Prisma Compute deployment and hosting guide. Use whenever the user mentions Prisma Compute, `prisma.compute.ts`, `defineComputeConfig`, deploying or hosting a Prisma app, `@prisma/cli app deploy`, `compute:deploy`, `create-prisma --deploy`, `PRISMA_SERVICE_TOKEN`, Compute auth/workspaces, apps/deployments/build logs/domains, localhost vs `0.0.0.0`, deploy port binding, or framework deploy readiness for Hono, Elysia, Next.js, TanStack Start, Astro, Nuxt, Svelte, Nest, Turborepo, or custom/prebuilt artifacts.

prisma/prisma-database-setup

Guides for configuring Prisma with different database providers (PostgreSQL, MySQL, SQLite, MongoDB, etc.). Use when setting up a new project, changing databases, or troubleshooting connection issues. Triggers on "configure postgres", "connect to mysql", "setup mongodb", "sqlite setup".

prisma/prisma-driver-adapter-implementation

Required reference for Prisma v7 driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter/Transaction interfaces. Contains critical contract details not inferable from code examples — including the transaction lifecycle protocol, error mapping requirements, and verification checklist. Existing implementations do not replace this skill.

prisma/prisma-postgres

Prisma Postgres setup and operations guidance across Console, create-db CLI, Management API, and Management API SDK. Use when creating Prisma Postgres databases, working in Prisma Console, provisioning with create-db/create-pg/create-postgres, or integrating programmatic provisioning with service tokens or OAuth.

prisma/prisma-postgres-setup

Set up a new Prisma Postgres database and connect it to a local project using the Management API. Use when asked to "set up a database", "create a Prisma Postgres project", "get a connection string", "connect my app to Prisma Postgres", or "provision a database".

prisma/prisma-upgrade-v7

Complete migration guide from Prisma ORM v6 to v7 covering all breaking changes. Use when upgrading Prisma versions, encountering v7 errors, or migrating existing projects. Triggers on "upgrade to prisma 7", "prisma 7 migration", "prisma-client generator", "driver adapter required".

Verwandte Skills

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More Codierung & Entwicklung skills