Prisma ORM 6.0/7.0: Революція у компіляторі запитів — 3,4 рази
Prisma ORM 6 та 7 замінюють двигун запитів на Rust на компілятор запитів на TypeScript: чому Rust був повільним, нова архітектура та економія розміру пакета.
Використовуйте цей документ як оновлену версію ідей з книги „Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture“, призначену для операторів: чіткі етапи, впорядковані блоки коду та примітки щодо відновлення, які зберігаються під час передачі обов’язків. Етап Огляду найкраще функціонує, якщо його розглядати як вимірювану поверхню. Запишіть один ідеальний зразок роботи, один випадок збою та примітки щодо скасування змін перед розширенням обсягу роботи. Записуйте час виконання та витрати на токени або запити поруч із функціональними результатами. Візуалізація витрат заздалегідь запобігає несподіваним рахункам під час переходу від демо-середовища до спільних середовищ.
Частина 1: Архітектура компілятора запитів
На етапі «Запит» частини 1 необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Конфігурацію слід тримати окремо від коду додатку. Файли середовища, сховища конфіденційних даних та флаги функціоналу мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код. Коли це дозволяє бюджет, слід додавати тест на базову роботу, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API.
Чому Rust був повільним (попри свою швидкість)
Для етапу «Чому Rust був повільним» необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори мають мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Необхідно документувати як шлях успішного виконання, так і шлях відновлення одночасно. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Коли дозволяє бюджет, слід додати тест на базову функціональність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних 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)
Нова архітектура: Компілятор запитів (TypeScript + WASM)
Для етапу Компілятора запитів нової архітектури необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Краще використовувати невеликі, тестовані одиниці замість об’ємних скриптів. Коли крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану систему обробки. Якщо дозволяє бюджет, додайте тест на базову функціональність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API. Для етапу Компілятора запитів нової архітектури необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Відображення витрат на ранньому етапі запобігає несподіваним рахункам, коли процес переходить від демо-режиму до спільного середовища.
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
Зменшення розміру пакета: знижка на 85–90%
Під час виконання 85-го етапу зменшення розміру пакета спочатку запишіть умови контракту: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допоможе зберегти чесність подальших змін у коді. Зберігайте конфігурацію окремо від коду додатку. Файли середовища, сховища секретів та флаги функцій мають знаходитися в одному місці, яке оператори можуть перевірити, не читаючи весь код. Напишіть короткий посібник: як оновлювати ключі, як спорожнювати чергу та як скасовувати останнє завантаження даних.
Частина 2: Стабільність Prisma 6.0/7.0 та зміни, що порушують сумісність
Під час роботи над етапом 2 Prisma 6 спочатку запишіть контракт: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Одночасно задокументуйте шлях успішного виконання та шлях відновлення. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу та як скасовувати останнє введення даних.
Міграція з v5: зміни схеми PostgreSQL
Під час роботи над етапом міграції з PostgreSQL версії v5 спочатку складіть опис вимог: необхідні вхідні дані, сигнал про успіх та наслідки часткової невдачі. Такий перелік допомагає зберігати чесність у подальших змінах коду. Віддавайте перевагу невеликим, тестованим одиницям коду перед об’ємними скриптами. Якщо якийсь крок зазнає невдачі, причина має вказувати на конкретну функцію, а не на складну послідовність операцій. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу, як скасовувати останнє завантаження даних. Під час роботи над етапом міграції з PostgreSQL версії v5 спочатку складіть опис вимог: необхідні вхідні дані, сигнал про успіх та наслідки часткової невдачі. Такий перелік допомагає зберігати чесність у подальших змінах коду. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Чітке бачення витрат заздалегідь запобігає несподіваним рахункам під час переходу від демо-середовищ до спільних.
-- 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");
Обробка помилок: усунення NotFoundError
Етап усунення помилки NotFoundError ефективніше працює, якщо його розглядати як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Тримайте конфігурацію поза кодом додатку. Файли середовища, сховища секретів та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код. Фіксуйте версії залежностей та записуйте дайджест зображення, яке використовувалося під час демонстрації. Відтворюваність краща за „племінні“ знання.
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)) { ... }
Зарезервовані ключові слова: async, await, using
Ключові слова reserved async await stage працюють найкраще, коли їх розглядають як вимірювану характеристику. Збережіть один ідеальний запис, один випадок збою та примітки щодо скасування змін перед розширенням обсягу. Документуйте як успішний, так і відновлювальний сценарії роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося для демонстрації. Відтворюваність краща за „колективні знання“.
// ❌ Will not compile in v6+
model async {
id Int @id
}
// ✅ Renamed
model AsyncTask {
id Int @id
}
Частина 3: Нові функції в v6 та v7
Етап «Нові функції, частина 3» найкраще працює, якщо його розглядати як вимірювану поверхню. Зафіксуйте один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Віддавайте перевагу невеликим, тестованим одиницям перед об’ємними скриптами. Коли якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану послідовність дій. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося під час демонстрації. Відтворюваність краща за індивідуальні знання.
Пошук у повному тексті: перехід від прев’ю
Пошук повного тексту на етапі завершення працює найкраще, коли його розглядають як вимірювану поверхню. Зафіксуйте один ідеальний результат, один випадок невдачі та примітку про скасування змін перед розширенням обсягу роботи. Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Позначте всі елементи, визначте критерії успіху та не допускайте мовчазного часткового виконання завдань. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося під час демонстрації. Відтворюваність краща за індивідуальні знання.
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-перегляди з взаємозв’язками (v6+)
Етап SQL Views with Relationships працює найкраще, якщо його розглядати як вимірювану поверхню. Зафіксуйте один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Візуальний контроль витрат заздалегідь запобігає несподіваним рахункам під час переходу від демо-середовища до спільних середовищ. Визначте версії залежностей та зафіксуйте дайджест зображення, яке використовувалося для демонстрації. Відтворюваність краща за індивідуальні знання.
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 (ранній доступ у версії v6.6+)
Етап раннього доступу до підтримки pgvector найкраще функціонує, якщо його розглядати як вимірювану поверхню. Зафіксуйте один ідеальний приклад роботи, один випадок збою та примітки щодо скасування змін перед розширенням обсягу. Тримайте конфігурацію окремо від коду додатку. Файли середовища, сховища конфіденційних даних та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код. Встановіть фіксовані версії залежностей та зафіксуйте хеш образу, на якому працювала демонстрація. Відтворюваність краща за „колективні знання“.
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+)
Конфігурація Prisma Config TS v6 у режимі stage працює найкраще, якщо її розглядати як вимірювану поверхню. Зафіксуйте один ідеальний варіант роботи, один випадок збою та примітки щодо скасування змін перед розширенням обсягу. Документуйте як успішний, так і відновлювальний сценарії роботи разом. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Фіксуйте версії залежностей та записуйте хеш-значення образу, який використовувався для демонстрації. Відтворюваність краща за „колективні знання“.
// 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
}
});
Переробка Prisma Studio (v7+)
Етап Prisma Studio Redesign v7 працює найкраще, якщо його розглядати як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Віддавайте перевагу невеликим, тестованим одиницям перед об’ємними скриптами. Коли якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану послідовність дій. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося для демонстрації. Відтворюваність краща за „колективні знання“. Етап Prisma Studio Redesign v7 працює найкраще, якщо його розглядати як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Записуйте час виконання та витрати на токени чи запити разом із функціональними результатами. Чітке бачення витрат заздалегідь запобігає несподіваним рахункам під час переходу від демонстрації до спільних середовищ.
Частина 4: Стратегія міграції v5 → v7
На етапі стратегії міграції частини 4 необхідно визначити вхідні дані, відповідальну особу за кожен крок та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Конфігурацію слід тримати окремо від коду додатку. Файли середовища, сховища конфіденційних даних та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код. Коли це дозволяє бюджет, слід додати тест на базову функціональність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API.
Поетапне оновлення
На етапі поетапного оновлення необхідно визначити вхідні дані, відповідальну особу за кожен крок та критерії завершення перед зміною коду. Оператори мають мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Необхідно документувати як успішний, так і відновлювальний сценарії роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Коли це дозволяють бюджетні обмеження, слід додати тест на базову функціональність, який перевіряє критичний шлях у процесі інтеграційного тестування за допомогою фікстур, а не реальних платних 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
Стратегія скасування змін
На етапі стратегії відкату необхідно визначити вхідні дані, відповідальну особу за крок та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Краще використовувати невеликі, тестирувані одиниці коду замість об’ємних скриптів. Коли крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на складну структуру процесу. Коли дозволяє бюджет, слід додавати тест на базову функціональність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних 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
Частина 5: Вплив на продуктивність у реальних умовах
Serverless Cold Start: приклад 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)
Пошук товарів у е-комерції
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)