Strona główna / Artykuły

Prisma ORM 6.0/7.0: Rewolucja w kompilatorze zapytań — 3,4x

Prisma ORM 6 i 7 zastępują silnik zapytań w Rust silnikiem kompilującym zapytania w TypeScript: dlaczego Rust był wolny, nowa architektura oraz oszczędności w rozmiarze pliku.

Wydawca: REACTAPP.TOP11 min czytania2440 słów

Źródła: Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture

Niech to służy jako wersja przeznaczona dla operatorów, zawierająca zrekonstruowane idee z tekstu „Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture”: wyraźne etapy, uporządkowane sekcje kodu oraz notatki dotyczące przywracania stanu po przeniesieniu obowiązków. Etap Przeglądu działa najlepiej, gdy traktowany jest jako mierzalna powierzchnia do analizy. Zapisz jeden idealny przykład działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres pracy. Zapisuj czasy wykonywania oraz koszt tokenów lub zapytań obok wyników funkcjonalnych. Wczesna widoczność kosztów zapobiega nieoczekiwanym rachunkom, gdy przechodzi się od środowiska demonstracyjnego do wspólnych środowisk.

Część 1: Architektura kompilatora zapytań

W fazie pierwszej, „The Query”, przed zmianą kodu należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia. Operatorzy powinni móc ponownie uruchomić ten krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Konfigurację należy przechowywać poza kodem aplikacji. Pliki środowiskowe, magazyny tajnych danych oraz flagi funkcjonalne powinny znajdować się w jednym miejscu, które operatorzy mogą sprawdzić, nie musząc czytać całej struktury. Gdy budżet na to pozwala, należy dodać test sprawdzający kluczową ścieżkę w procesie CI, wykorzystując przy tym specjalne narzędzia testowe, a nie rzeczywiste, płatne API.

Dlaczego Rust był wolny (mimo że jest szybki)

W etapie „Dlaczego Rust był wolny” należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia przed zmianą kodu. Operatorzy powinni móc ponownie uruchomić ten krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Należy udokumentować zarówno prawidłowy przebieg działania, jak i ścieżkę naprawczą. Próby ponowne, kontrola przez ludzi oraz obsługa wiadomości błędnych stanowią część produktu, a nie elementy dopiero późniejszej optymalizacji. Gdy budżet na to pozwala, należy dodać test dymny, który sprawdza kluczową ścieżkę działania w CI przy użyciu fixitów, a nie rzeczywistych płatnych API.

TypeScript Client
    ↓ (serialize to JSON)
Rust Query Engine (14MB binary)
    ↓ (deserialize JSON)
    ↓ (execute query plan)
    ↓ (serialize results to JSON)
TypeScript Client (deserialize)
    ↓ (use results)

Nowa architektura: kompilator zapytań (TypeScript + WASM)

Dla etapu New Architecture Query Compiler należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia przed zmianą kodu. Operatorzy powinni móc ponownie uruchomić ten krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Należy preferować małe, łatwe do przetestowania jednostki zamiast rozbudowanych skryptów. Gdy jakiś krok zawiedzie, powinno to wskazywać na konkretną odpowiedzialność, a nie na skomplikowaną strukturę procesów. Gdy budżet na to pozwala, należy dodać test wstępny, który sprawdza kluczową ścieżkę w procesie CI przy użyciu narzędzi typu fixtures, a nie rzeczywistych, płatnych API. Dla etapu New Architecture Query Compiler należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia przed zmianą kodu. Operatorzy powinni móc ponownie uruchomić ten krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Obok wyników funkcjonalnych należy rejestrować czas wykonywania oraz koszt tokenów lub zapytań. Wczesna widoczność kosztów zapobiega nieoczekiwanym rachunkom, gdy ścieżka przechodzi z wersji demonstracyjnej do środowiska współdzielonego.

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

Zmniejszenie rozmiaru pakietu: spadek o 85–90%

Podczas przechodzenia przez etap zmniejszania rozmiaru pakietu o 85%, najpierw zapisz umowę: wymagane dane wejściowe, sygnał sukcesu oraz to, co dzieje się w przypadku częściowego niepowodzenia. Taka lista kontrolna zapewnia uczciwość późniejszych zmian w kodzie. Trzymaj konfigurację poza kodem aplikacji. Pliki środowiskowe, magazyny tajnych danych oraz flagi funkcjonalne powinny znajdować się w jednym miejscu, które operatorzy mogą sprawdzić bez konieczności czytania całej struktury. Napisz krótki przewodnik: jak rotować klucze, jak opróżnić kolejkę oraz jak cofnąć ostatnie zaimportowanie.

Część 2: Stabilność Prisma 6.0/7.0 i zmiany przełomowe

Gdy pracujesz nad etapem 2 Prisma 6, najpierw zapisz umowę: wymagane dane wejściowe, sygnał sukcesu oraz to, co dzieje się w przypadku częściowego niepowodzenia. Taka lista kontrolna zapewnia uczciwość późniejszych zmian w kodzie. Zdokumentuj zarówno ścieżkę prawidłowego działania, jak i ścieżkę naprawczą. Próby ponownych działań, kontrola przez ludzi oraz obsługa wiadomości błędowych są częścią produktu, a nie elementem późniejszej dopracowywania. Napisz krótki przewodnik: jak rotować klucze, jak opróżnić kolejkę oraz jak cofnąć ostatnie zaimportowanie.

Migracja z v5: Zmiany w schemacie PostgreSQL

Podczas przechodzenia przez etap migracji z PostgreSQL wersji v5, najpierw spisz umowę: wymagane dane wejściowe, sygnał sukcesu oraz to, co dzieje się w przypadku częściowego niepowodzenia. Taka lista kontrolna zapewnia uczciwość późniejszych zmian w kodzie. Wolno preferować małe, testowalne jednostki zamiast rozbudowanych skryptów. Gdy jakiś krok się nie powiedzie, błąd powinien wskazywać na konkretną odpowiedzialność, a nie na skomplikowany proces. Napisz krótki przewodnik: jak rotować klucze, jak opróżnić kolejkę z zadań, jak cofnąć ostatnie zaimportowanie danych. Podczas przechodzenia przez etap migracji z PostgreSQL wersji v5, najpierw spisz umowę: wymagane dane wejściowe, sygnał sukcesu oraz to, co dzieje się w przypadku częściowego niepowodzenia. Taka lista kontrolna zapewnia uczciwość późniejszych zmian w kodzie. Zapisz czasy wykonywania oraz koszt tokenów lub zapytań obok wyników funkcjonalnych. Wczesna widoczność kosztów zapobiega niespodziewanym rachunkom, gdy przechodzi się z środowiska demonstracyjnego do wspólnych środowisk.

-- 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");

Obsługa błędów: usuwanie NotFoundError

Etap usuwania błędu NotFoundError w ramach obsługi błędów działa najlepiej, gdy traktuje się go jako mierzalną powierzchnię do analizy. Zapisz jeden idealny przykład działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres analizy. Konfigurację należy przechowywać poza kodem aplikacji. Pliki środowiskowe, magazyny tajnych danych oraz flagi funkcjonalne powinny znajdować się w jednym miejscu, które operatorzy mogą sprawdzić bez konieczności czytania całej struktury. Ustal stałe wersje zależności i zapisz hash obrazu, który został użyty do uruchomienia demonstracji. Reprodukowalność jest ważniejsza od wiedzy przekazywanej ustnie.

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)) { ... }

Słowa kluczowe przeznaczone do specjalnego użycia: async, await, using

Kluczowe słowa „async await” działają najlepiej, gdy traktuje się je jako mierzalną powierzchnię do analizy. Zapisz jeden idealny przypadek działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia działań, zanim rozszerzysz zakres badania. Zdokumentuj zarówno prawidłowy przebieg operacji, jak i ścieżkę przywracania do stanu poprzedniego. Próby ponownych działań, kontrola przez ludzi oraz obsługa wiadomości nieodebranych stanowią część produktu, a nie elementy dodawane później. Ustal wersje zależności i zapisz hash obrazu, który służył do uruchomienia demonstracji. Reprodukowalność jest ważniejsza od lokalnej wiedzy zespołu.

// ❌ Will not compile in v6+
model async {
  id Int @id
}

// ✅ Renamed
model AsyncTask {
  id Int @id
}

Część 3: Nowe funkcje w wersjach v6 i v7

Faza „Nowe funkcje w części 3” działa najlepiej, gdy traktuje się ją jako mierzalną powierzchnię do analizy. Zapisz jeden idealny przykład działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres pracy. Wolno preferować małe, testowalne jednostki zamiast rozbudowanych skryptów. Gdy jakiś krok zawiedzie, awaria powinna wskazywać na konkretną odpowiedzialność, a nie na skomplikowany łańcuch operacji. Ustal wersje zależności i zapisz hash obrazu, który został użyty do uruchomienia demonstracji. Powtarzalność jest ważniejsza od lokalnej wiedzy zespołu.

Poyszukiwanie pełnego tekstu: Przejście z wersji próbnej

Poиск pełnego tekstu na etapie końcowym działa najlepiej, gdy traktuje się go jako mierzalną powierzchnię. Zapisz jeden udany przypadek, jeden przypadek niepowodzenia oraz notatkę o cofnięciu działań, zanim rozszerzysz zakres. Traktuj ten etap jako umowę pomiędzy danymi wejściowymi a zweryfikowanymi wynikami. Nazwij poszczególne elementy, zdefiniuj kryteria sukcesu i odrzuć ciche, częściowe ukończenie zadania. Zaznacz wersje zależności i zapisz hash obrazu, który został użyty do uruchomienia demonstracji. Reprodukowalność jest ważniejsza od lokalnej wiedzy eksperckiej.

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"]
}

Widoki SQL z relacjami (v6+)

Etap „SQL Views with Relationships” działa najlepiej, gdy traktuje się go jako mierzalną powierzchnię do analizy. Zapisz jeden idealny przykład działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres badania. Zapisuj czasy wykonywania oraz koszt tokenów lub zapytań obok wyników funkcjonalnych. Wczesna widoczność kosztów zapobiega niespodziewanym rachunkom, gdy przechodzi się z środowiska demonstracyjnego do współdzielonych środowisk. Zaznacz wersje zależności i zapisz digest obrazu, który uruchomił demonstrację. Reprodukowalność jest lepsza od lokalnej wiedzy specjalistów.

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!
});

Wsparcie dla pgvector (dostęp wstępny od wersji 6.6+)

Faza wczesnego dostępu do pgvector Support funkcjonuje najlepiej, gdy traktowana jest jako mierzalna powierzchnia do analizy. Zapisz jeden idealny przykład działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres pracy. Trzymaj konfigurację poza kodem aplikacji. Pliki środowiskowe, magazyny haseł oraz flagi funkcjonalne powinny znajdować się w jednym miejscu, które operatorzy mogą sprawdzić bez konieczności przeglądania całej struktury. Ustal konkretne wersje zależności i zapisz hash obrazu, który uruchomił demonstrację. Reprodukowalność jest ważniejsza od lokalnej wiedzy specjalistów.

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+)

Konfiguracja Prisma Config TS v6 w fazie testowej działa najlepiej, gdy traktuje się ją jako mierzalną powierzchnię do analizy. Zapisz jeden idealny przypadek działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres testów. Zdokumentuj zarówno prawidłowy przebieg działania, jak i ścieżkę naprawczą. Próby ponownych działań, kontrolne punkty ludzkie oraz obsługa wiadomości błędowych stanowią część produktu, a nie elementy dodawane później. Ustal stałe wersje zależności i zapisz hash obrazu, który służył do uruchomienia demonstracji. Reprodukowalność jest ważniejsza od lokalnej wiedzy zespołu.

// 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
  }
});

Przeprojektowanie Prisma Studio (v7+)

Faza Prisma Studio Redesign v7 funkcjonuje najlepiej, gdy jest traktowana jako mierzalna powierzchnia do analizy. Zapisz jeden idealny zapis działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres pracy. Wolno preferować małe, testowalne jednostki zamiast rozbudowanych skryptów. Gdy jakiś krok zawiedzie, awaria powinna wskazywać na konkretną odpowiedzialność, a nie na skomplikowany łańcuch operacji. Ustal stałe wersje zależności i zapisz hash obrazu, który uruchomił demonstrację. Reprodukowalność jest ważniejsza od lokalnej wiedzy zespołu. Faza Prisma Studio Redesign v7 funkcjonuje najlepiej, gdy jest traktowana jako mierzalna powierzchnia do analizy. Zapisz jeden idealny zapis działania, jeden przypadek awarii oraz notatkę dotyczącą cofnięcia zmian, zanim rozszerzysz zakres pracy. Zapisuj czasy wykonywania oraz koszt tokenów lub zapytań obok wyników funkcjonalnych. Wczesna widoczność kosztów zapobiega niespodziewanym rachunkom, gdy przechodzi się od demonstracji do środowisk współdzielonych.

Część 4: Strategia migracji v5 → v7

W fazie Strategii migracji części 4 należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia przed modyfikacją kodu. Operatorzy powinni móc ponownie uruchomić dany krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Konfigurację należy przechowywać oddzielnie od kodu aplikacji. Pliki środowiskowe, magazyny tajemnic oraz flagi funkcjonalne powinny znajdować się w jednym miejscu, które operatorzy mogą sprawdzić bez konieczności przeglądania całej struktury. Gdy budżet na to pozwala, należy dodać test dymny, który symuluje kluczową ścieżkę w procesie CI przy użyciu narzędzi pomocniczych, a nie rzeczywistych, płatnych API.

Etap po etapie – aktualizacja

W fazie stopniowej aktualizacji należy zdefiniować dane wejściowe, osobę odpowiedzialną za daną etap oraz kryteria zakończenia przed modyfikacją kodu. Operatorzy powinni móc ponownie uruchomić daną etap na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Należy udokumentować zarówno prawidłowy przebieg procesu, jak i ścieżkę naprawczą. Próby ponowne, kontrola przez ludzi oraz obsługa wiadomości błędowych stanowią część produktu, a nie elementy dodawane później. Gdy budżet na to pozwala, należy dodać test dymny, który sprawdza kluczową ścieżkę w procesie CI przy użyciu fixitów, a nie rzeczywistych płatnych API.

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

Strategia cofnięcia

W fazie strategii cofania należy zdefiniować dane wejściowe, osobę odpowiedzialną za dany krok oraz kryteria zakończenia przed modyfikacją kodu. Operatorzy powinni móc ponownie uruchomić ten krok na podstawie znanego punktu kontrolnego, bez konieczności zgadywania ukrytego stanu. Należy preferować małe, testowalne jednostki zamiast rozbudowanych skryptów. Gdy jakiś krok zawiedzie, powinno to wskazywać na konkretną odpowiedzialność, a nie na skomplikowany łańcuch operacji. Gdy budżet na to pozwala, należy dodać test dymny, który sprawdza kluczową ścieżkę w procesie CI przy użyciu narzędzi do konfiguracji, a nie żywych, płatnych API.

# 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

Część 5: Wpływ na wydajność w praktyce

Chłodny start bez serwera: przykład 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)

Szukanie produktów w e-commerce

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)

Wnioski

Listwa kontrolna operacyjna

Pozycje pokrewne do przeczytania