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: Архітэктура компілятора запытаў
Для першай часты — этапы запіту, пры змяне коду неабходна прадзефініравань вхідных дадзеных, адпавядаючага за крок адпаведнага спеціяліста і крэтарыяў выходу з працэсу. Аператары должны магчымае перзапускаць крок з вядомай точкі контролю, не прабуючы вычысляць захаваны стан. Конфігурацыю трэба залічыць паза кодам прыкладнення. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць, не чытаяўшы весь граф. Калі дозволяе бюджэт, трэба дадаць тэст на працясную працу, які перабірае крытычны шлях у сістэме 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
Ключавыя слова, зарэзерваваныя для выкарыстоўвання, 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 Views з асоціяцыямі (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+)
Этап раннего доступу дахопампаг_вектар работае наякраць, калі яго спрыяваць як доўгледную паверхню. Зафіксавайце адны ідэальны прыклад працы, адну справу з бягам і прыметкі па поверненню да пачатковага стану пры расшырэнні масштаба. Зберагайце настройкі праза код аплікацыі. Файлы сяродавішча, хранільнікі секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяжнага чытання всіх дадзеных. Закрэпіце версіі залежнасцей і зафіксавайце хэш адпраўленага дамажу для прадказання працы. Возможнасць перадаравання рэзультатаў лепш за традыцыйныя знаёмства.
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.
Пашаговая апгрэйдзаванне
Для этапы пошаговайго апгрэйда неабяжна ўзначыць вхідныя даны, адпаведальнага за кожны крок і крэтырыя завершэння пры зміне коду. Аперацыйныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцці і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней. Калі дозволяе бюджэт, неабяжна адключыць тэст на пераканальнісць, які працуе з крытычным шляхам у сістэме CI за дапамою фіксатыв, а не з рэальнымі платнымі 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)