Prisma ORM 6.0/7.0 – Die Revolution des Abfragekompilators: 3,4-fach schneller
Prisma ORM 6 und 7 ersetzen den Rust-Abfragemotor durch einen TypeScript-Abfragekompilator: Warum Rust langsam war, die neue Architektur und die Ersparnisse bei der Dateigröße.
Nutzen Sie dies als für Operator zugängliche Neuformulierung der Ideen aus „Prisma ORM 6.0/7.0: Die Query Compiler Revolution – 3,4-mal schnellere Abfragen, 90 Prozent kleinere Pakete und eine TypeScript-first-Architektur“: klare Phasen, geordnete Codeabschnitte sowie Wiederherstellungshinweise, die auch bei Übergaben erhalten bleiben. Die Überblicksphase funktioniert am besten, wenn sie als messbarer Referenzpunkt betrachtet wird. Erfassen Sie vor der Erweiterung des Umfangs ein „goldenes“ Transkript, einen Fehlerfall sowie die Notizen zur Rücksetzung. Erhalten Sie neben den funktionalen Ergebnissen auch Aufzeichnungen zu Laufzeiten sowie Kosten pro Token oder Abfrage. Eine frühzeitige Sichtbarkeit der Kosten verhindert überraschende Rechnungen, wenn der Prozess von Demoumgebungen in gemeinsam genutzte Umgebungen übergeht.
Teil 1: Die Architektur des Query Compilers
In der ersten Phase „The Query“ sollten die Eingabedaten, der Verantwortliche für den Schritt sowie die Abbruchkriterien definiert werden, bevor der Code geändert wird. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf versteckte Zustände schließen zu müssen. Die Konfiguration sollte außerhalb des Anwendungscode gespeichert werden. Umgebungsdateien, Geheimdatenspeicher und Feature-Flags sollten an einem Ort zusammengefasst sein, den die Operator überprüfen können, ohne den gesamten Codeverlauf durchlesen zu müssen. Fügen Sie immer dann, wenn das Budget es zulässt, einen Smoke-Test hinzu, der im CI den kritischen Pfad mit Fixtures und nicht mit live genutzten, bezahlten APIs testet.
Warum Rust langsam war (trotz seiner Geschwindigkeit)
Für die Phase „Warum war Rust langsam?“ sollten vor dem Ändern des Codes die Eingaben, der Verantwortliche für den Schritt sowie die Abbruchkriterien definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf versteckten Zustände schließen zu müssen. Dokumentieren Sie gemeinsam den erfolgreichen Ablauf sowie den Notfallweg. Wiederholte Versuche, menschliche Überprüfungen und die Handhabung von Fehlern gehören zum Produkt selbst, nicht zu späteren Optimierungen. Fügen Sie so oft wie das Budget es zulässt einen Smoke-Test hinzu, der im CI mit Fixtures den kritischen Ablauf testet – und zwar anstelle von live genutzten, bezahlten APIs.
TypeScript Client
↓ (serialize to JSON)
Rust Query Engine (14MB binary)
↓ (deserialize JSON)
↓ (execute query plan)
↓ (serialize results to JSON)
TypeScript Client (deserialize)
↓ (use results)
Neue Architektur: Abfragekompilator (TypeScript + WASM)
Für die Phase des New Architecture Query Compilers sollten vor der Codeänderung Eingaben, der Verantwortliche für den Schritt sowie die Abbruchkriterien definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf verborgene Zustände schließen zu müssen. Bevorzugen Sie kleine, testbare Einheiten vor umfangreichen Skripten. Wenn ein Schritt fehlschlägt, sollte der Fehler auf eine einzige Verantwortung verweisen und nicht auf ein verworrenes Pipeline-System. Fügen Sie sofern das Budget es zulässt in CI einen Smoke Test hinzu, der den kritischen Pfad mit Fixtures und nicht mit live genutzten, bezahlten APIs testet. Für die Phase des New Architecture Query Compilers sollten vor der Codeänderung Eingaben, der Verantwortliche für den Schritt sowie die Abbruchkriterien definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf verborgene Zustände schließen zu müssen. Erhalten Sie neben den funktionalen Ergebnissen auch Angaben zu Laufzeiten sowie Kosten für Tokens oder Abfragen. Eine frühzeitige Sichtbarkeit der Kosten verhindert überraschende Rechnungen, wenn der Prozess von einer Demo-Umgebung in eine gemeinsam genutzte Umgebung übergeht.
nts.
TypeScript Client
↓ (Query Compiler compiles query plan)
↓ (execute plan in same process)
↓ (return results immediately)
TypeScript Client (no deserialization needed)
↓ (use results)
Operation: findMany with 25,000 records
Rust Query Engine: 185 ms
Query Compiler: 55 ms
Improvement: 3.4x faster (130ms serialization eliminated)
---
Operation: findMany with take=2000
Rust Query Engine: 6.6 ms
Query Compiler: 3.1 ms
Improvement: 2.1x faster
---
Operation: Complex JOINs
Rust Query Engine: 207 ms
Query Compiler: 130 ms
Improvement: 1.6x faster
Verringerung der Paketgröße: 85–90% Reduktion
Beim Arbeiten an der Stufe „Verringerung der Paketgröße um 85%“ sollten Sie zunächst den Vertrag aufschreiben: erforderliche Eingaben, Erfolgsignal sowie das Vorgehen bei teilweisen Fehlern. Diese Checkliste sorgt dafür, dass spätere Codeänderungen transparent bleiben. Bewahren Sie die Konfiguration außerhalb des Anwendungscode auf. Umgebungsdateien, Geheimdatenspeicher und Feature-Flags sollten an einem Ort gesammelt sein, den Betreiber ohne das Durchlesen des gesamten Systems überprüfen können. Verfassen Sie ein kurzes Handbuch: Wie werden Schlüssel ausgetauscht, wie wird die Warteschlange geleert und wie wird der letzte Eingriff rückgängig gemacht?
Teil 2: Stabilität von Prisma 6.0/7.0 und brisante Änderungen
Beim Arbeiten an der Phase 2 von Prisma 6 sollten Sie zunächst den Vertrag aufschreiben: die erforderlichen Eingaben, das Erfolgsignal sowie das Vorgehen bei teilweisen Fehlern. Diese Checkliste sorgt dafür, dass spätere Codeänderungen transparent bleiben. Dokumentieren Sie gleichzeitig den erfolgreichen Ablauf sowie den Notfallweg. Wiederholte Versuche, menschliche Überprüfungen und die Handhabung von Fehlern gehören zum Produkt selbst, nicht zu späteren Optimierungen. Verfassen Sie außerdem ein kurzes Handbuch: Wie rotiert man Schlüssel, wie leert man die Warteschlange und wie rollt man den letzten Eingriff rückgängig?
Migration von v5: Änderungen am PostgreSQL-Schema
Beim Durchführen der Migration von der v5 PostgreSQL-Phase sollten Sie zunächst den Vertrag aufschreiben: erforderliche Eingaben, Erfolgsignal sowie das Vorgehen bei teilweisen Fehlern. Diese Checkliste sorgt dafür, dass spätere Codeänderungen transparent bleiben. Ziehen Sie kleine, testbare Einheiten vor großen Skripten vor. Wenn ein Schritt fehlschlägt, sollte der Fehler auf eine einzige Verantwortung verweisen und nicht auf ein verworrenes Ablaufschema. Verfassen Sie ein kurzes Handbuch: Wie werden Schlüssel rotiert, wie wird die Warteschlange geleert und wie wird der letzte Import rückgängig gemacht? Beim Durchführen der Migration von der v5 PostgreSQL-Phase sollten Sie zunächst den Vertrag aufschreiben: erforderliche Eingaben, Erfolgssignal sowie das Vorgehen bei teilweisen Fehlern. Diese Checkliste sorgt dafür, dass spätere Codeänderungen transparent bleiben. Notieren Sie die Laufzeiten sowie die Kosten für Token oder Abfragen neben den funktionalen Ergebnissen. Eine frühzeitige Sichtbarkeit der Kosten verhindert überraschende Rechnungen, wenn der Prozess von Demonstrationsumgebungen in gemeinsam genutzte Umgebungen übergeht.
-- Prisma v5
CREATE TABLE "_PostToTag" (
"A" INTEGER NOT NULL,
"B" INTEGER NOT NULL
);
CREATE UNIQUE INDEX "_PostToTag_AB_unique" ON "_PostToTag"("A", "B");
-- Prisma v6+
CREATE TABLE "_PostToTag" (
"A" INTEGER NOT NULL,
"B" INTEGER NOT NULL,
CONSTRAINT "_PostToTag_AB_pkey" PRIMARY KEY ("A", "B")
);
ALTER TABLE "_PostToTag"
DROP CONSTRAINT "_PostToTag_AB_unique",
ADD CONSTRAINT "_PostToTag_AB_pkey" PRIMARY KEY ("A", "B");
Fehlerbehandlung: Beseitigung von NotFoundError
Die Phase der Beseitigung von NotFoundError im Rahmen der Fehlerbehandlung funktioniert am besten, wenn sie als messbarer Bereich betrachtet wird. Erfassen Sie ein „goldenes Transkript“, einen Fehlerfall sowie eine Notiz zur Rücksetzung, bevor Sie den Umfang erweitern. Bewahren Sie die Konfiguration außerhalb des Anwendungscode auf. Umgebungsdateien, Geheimdatenspeicher sowie Feature-Flags sollten an einem Ort gesammelt sein, den Betreuer ohne Durchsicht des gesamten Systems prüfen können. Fixieren Sie die Versionen der Abhängigkeiten und dokumentieren Sie den Image-Digest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als „stammesbezogenes Wissen“.
import { NotFoundError } from '@prisma/client';
try {
const user = await prisma.user.findUniqueOrThrow({
where: { id: 'invalid' }
});
} catch (e) {
if (e instanceof NotFoundError) {
// Handle not found
}
}
import { PrismaClientKnownRequestError } from '@prisma/client';
try {
const user = await prisma.user.findUniqueOrThrow({
where: { id: 'invalid' }
});
} catch (e) {
if (e instanceof PrismaClientKnownRequestError && e.code === 'P2025') {
// P2025 = record not found
}
}
// Codemod-friendly pattern
const isNotFound = (error: unknown) =>
error instanceof PrismaClientKnownRequestError && error.code === 'P2025';
// Old code
if (e instanceof NotFoundError) { ... }
// New code
if (isNotFound(e)) { ... }
Reservierte Schlüsselwörter: async, await, using
Die reservierten Schlüsselwörter async und await funktionieren am besten, wenn sie als messbare Größe betrachtet werden. Erfassen Sie ein perfektes Beispiel, einen Fehlerfall sowie eine Notiz zur Rücksetzung, bevor Sie den Umfang erweitern. Dokumentieren Sie sowohl den erfolgreichen Ablauf als auch den Wiederherstellungsprozess gemeinsam. Wiederholte Versuche, menschliche Überprüfungen sowie die Handhabung von Fehlern gehören zum Produkt selbst und nicht zu späteren Optimierungen. Legen Sie die Abhängigkeitsversionen fest und speichern Sie den Hash des Images, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als „stammesbezogenes Wissen“.
// ❌ Will not compile in v6+
model async {
id Int @id
}
// ✅ Renamed
model AsyncTask {
id Int @id
}
Teil 3: Neue Funktionen in v6 und v7
Die Phase „Neue Funktionen in Teil 3“ funktioniert am besten, wenn sie als messbarer Bereich betrachtet wird. Erfassen Sie vor der Erweiterung des Umfangs ein perfektes Beispiel, einen Fehlerfall sowie eine Notiz zur Rücksetzung. Ziehen Sie kleine, testbare Einheiten vor umfangreichen Skripten vor. Wenn ein Schritt fehlschlägt, sollte der Fehler auf eine einzige Verantwortung verweisen und nicht auf ein verworrenes Ablaufverfahren. Fixieren Sie die Abhängigkeitsversionen und dokumentieren Sie den Bilddigest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als kollektives Wissen.
Volltextsuche: Vom Vorabmodus zur Vollversion
Die Volltextsuche funktioniert am besten in der Abschlussphase, wenn sie als messbare Größe betrachtet wird. Erfassen Sie ein erfolgreiches Beispiel, einen Fehlfall sowie die Notizen zur Rücksetzung, bevor Sie den Umfang erweitern. Betrachten Sie diese Phase als Vertrag zwischen Eingaben und validierten Ausgaben. Benennen Sie die Ergebnisse, definieren Sie Erfolgskontrollen und lehnen Sie stille, unvollständige Abschlüsse ab. Speichern Sie die Abhängigkeitsversionen fest und dokumentieren Sie den Bilddigest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als „stammesweises Wissen“.
datasource db {
provider = "mysql"
url = env("DATABASE_URL")
}
model Post {
id Int @id @default(autoincrement())
title String
body String
@@fulltext([title, body])
}
// Query using full-text search
const results = await prisma.post.findMany({
where: {
OR: [
{ title: { search: 'database' } },
{ body: { search: 'database' } }
]
}
});
generator client {
provider = "prisma-client-js"
previewFeatures = ["fullTextSearchPostgres"]
}
SQL-Views mit Beziehungen (v6+)
Die Phase „SQL Views with Relationships“ funktioniert am besten, wenn sie als messbarer Ansatz betrachtet wird. Erfassen Sie ein optimales Beispiel, einen Fehlerfall sowie eine Notiz zur Rücksetzung, bevor Sie den Umfang erweitern. Erfassen Sie außerdem die Laufzeiten sowie die Kosten für Token oder Abfragen zusammen mit den funktionalen Ergebnissen. Eine frühzeitige Sichtbarkeit der Kosten verhindert überraschende Rechnungen, wenn der Prozess von einer Demo in gemeinsam genutzte Umgebungen übergeht. Legen Sie die Abhängigkeitsversionen fest und speichern Sie den Hashwert des Bildes, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als auf Erfahrungswerten beruhendes Wissen.
view UserStats {
id Int @id
userId Int
totalPosts Int
averageRating Float
user User @relation(fields: [userId], references: [id])
}
model User {
id Int @id
name String
stats UserStats? // Relation from model to view
}
const user = await prisma.user.findUnique({
where: { id: 1 },
include: { stats: true } // Works now!
});
pgvector-Unterstützung (Frühzugang ab v6.6+)
Die Early Access-Phase der pgvector-Unterstützung funktioniert am besten, wenn sie als messbarer Rahmen betrachtet wird. Erfassen Sie ein gelungenes Beispiel, einen Fehlerfall sowie die Notizen zur Rücksetzung, bevor Sie den Umfang erweitern. Bewahren Sie die Konfiguration außerhalb des Anwendungscode auf. Umgebungsdateien, Geheimdatenspeicher und Feature-Flags sollten an einem Ort gesammelt sein, den Betreiber ohne das Durchlesen des gesamten Systems überprüfen können. Fixieren Sie die Abhängigkeitsversionen und dokumentieren Sie den Image-Digest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als „stammesweises Wissen“.
model Embedding {
id Int @id @default(autoincrement())
text String
vector Unsupported("vector")? // pgvector type
}
// Query embeddings (requires pgvector extension)
const similar = await prisma.$queryRaw`
SELECT * FROM "Embedding"
ORDER BY vector <-> $1
LIMIT 5
`;
prisma.config.ts (v6.4+)
Die Prisma Config TS v6 Stage funktioniert am besten, wenn sie als messbare Oberfläche betrachtet wird. Erfassen Sie ein „goldenes“ Transkript, einen Fehlerfall sowie eine Notiz zur Rücksetzung, bevor Sie den Umfang erweitern. Dokumentieren Sie gemeinsam den erfolgreichen Ablauf sowie den Wiederherstellungsprozess. Wiederholversuche, menschliche Kontrollen und die Handhabung von Fehlern gehören zum Produkt selbst und nicht zu späteren Optimierungen. Fixieren Sie die Abhängigkeitsversionen und notieren Sie den Image-Digest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist wichtiger als kollektives Wissen.
// prisma.config.ts
import { defineConfig } from '@prisma/internals';
export default defineConfig({
datasources: {
db: {
url: process.env.DATABASE_URL,
directUrl: process.env.DIRECT_DATABASE_URL
}
},
client: {
skipValidation: false
},
accelerate: {
enabled: true
}
});
Neugestaltung von Prisma Studio (v7+)
Die Prisma Studio Redesign v7-Ebene funktioniert am besten, wenn sie als messbarer Bereich betrachtet wird. Erfassen Sie vor der Erweiterung des Umfangs ein „goldenes Transkript“, einen Fehlerfall sowie eine Notiz zur Rücksetzung. Ziehen Sie kleine, testbare Einheiten vor umfangreichen Skripten vor. Wenn ein Schritt fehlschlägt, sollte der Fehler auf eine einzige Verantwortung verweisen und nicht auf ein verworrenes Ablaufverfahren. Fixieren Sie die Abhängigkeitsversionen und dokumentieren Sie den Bilddigest, mit dem die Demo ausgeführt wurde. Reproduzierbarkeit ist besser als „stammesbezogenes Wissen“. Die Prisma Studio Redesign v7-Ebene funktioniert am besten, wenn sie als messbarer Bereich betrachtet wird. Erfassen Sie vor der Erweiterung des Umfangs ein „goldenes Transkript“, einen Fehlerfall sowie eine Notiz zur Rücksetzung. Dokumentieren Sie die Laufzeiten sowie die Kosten für Tokens oder Abfragen neben den funktionalen Ergebnissen. Frühzeitige Sichtbarkeit der Kosten verhindert überraschende Rechnungen, wenn der Weg von der Demo zu gemeinsamen Umgebungen wechselt.
Teil 4: Migrationsstrategie v5 → v7
In der Phase der Migrationsstrategie für Teil 4 sollten die Eingabedaten, der Verantwortliche für den jeweiligen Schritt sowie die Abbruchkriterien vor dem Ändern des Codes definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf versteckte Zustände schließen zu müssen. Die Konfiguration sollte außerhalb des Anwendungscode gespeichert werden. Umgebungsdateien, Geheimdatenspeicher sowie Feature-Flags sollten an einem Ort zusammengefasst sein, den die Operator überprüfen können, ohne den gesamten Codeverlauf durchlesen zu müssen. Fügen Sie so oft wie möglich, solange das Budget es zulässt, einen Smoke-Test hinzu, der im CI mit Fixtures den kritischen Pfad testet – und zwar nicht mit live genutzten, bezahlten APIs.
Schritt für Schritt: Aufwertung
Zur Schritt-für-Schritt-Upgrade-Phase sollten die Eingabedaten, der Verantwortliche für den jeweiligen Schritt sowie die Abbruchkriterien vor dem Ändern des Codes definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf versteckte Zustände schließen zu müssen. Dokumentieren Sie gemeinsam den erfolgreichen Ablauf sowie den Notfallplan. Wiederholungsversuche, menschliche Überprüfungen und die Handhabung von Fehlern gehören zum Produkt selbst und nicht zu späteren Optimierungen. Fügen Sie so oft wie das Budget es zulässt einen Smoke-Test hinzu, der den kritischen Ablauf in CI mit Fixtures und nicht mit live genutzten, bezahlten APIs testet.
npm install @prisma/client@latest
npm install -D prisma@latest
# Check if you use any deprecated patterns
grep -r "NotFoundError" src/ # Needs updating
grep -r "async\|await\|using" prisma/schema.prisma # Can't be model names
npx prisma migrate dev --name upgrade_to_v7
// Replace NotFoundError
- if (e instanceof NotFoundError) {
+ if (e instanceof PrismaClientKnownRequestError && e.code === 'P2025') {
npm test
npx prisma db push --preview-features # Validate schema
Rollback-Strategie
Zur Rollback-Strategiephase sollten vor der Änderung des Codes die Eingabedaten, der Verantwortliche für den Schritt sowie die Abbruchkriterien definiert werden. Die Operator sollten in der Lage sein, den Schritt von einem bekannten Checkpoint aus erneut auszuführen, ohne auf versteckte Zustände schließen zu müssen. Vorzuziehen sind kleine, testbare Einheiten statt umfangreicher Skripte. Wenn ein Schritt fehlschlägt, sollte der Fehler auf eine einzige Verantwortung verweisen und nicht auf ein verworrenes Ablaufschema. Fügen Sie sofern das Budget es zulässt in CI einen Smoke-Test hinzu, der den kritischen Pfad mit Fixtures und nicht mit live genutzten, bezahlten APIs testet.
# Revert migration
npx prisma migrate resolve --rolled-back upgrade_to_v7
# Downgrade Prisma
npm install @prisma/client@5
npm install -D prisma@5
# Regenerate Prisma Client
npx prisma generate
Teil 5: Einfluss auf die Leistung in der Praxis
Serverless Cold Start: Beispiel Lambda
Package size: 250MB
AWS Lambda cold start time: 3.2 seconds
Database query time: 450ms (serialization overhead)
Total latency per request: 3.65 seconds
Package size: 8MB
AWS Lambda cold start time: 0.8 seconds (75% faster)
Database query time: 130ms (70% faster)
Total latency per request: 0.93 seconds (75% faster)
E-Commerce-Produktsuche
Query time: 2.3 seconds
Server CPU: 45%
Memory: 580MB
Cost per request: ~$0.0008
Query time: 640ms (3.6x faster)
Server CPU: 12%
Memory: 145MB (75% reduction)
Cost per request: ~$0.0002 (75% cheaper)