प्रिज्मा या ड्रिज़ल: योजना, माइग्रेशन, प्रकार और काल्पनिक बेंचमार्क के बिना सर्वर रहित
अन्य लोगों के बेंचमार्क से संख्याओं के बिना
इंटरनेट पर ओआरएम तुलना आमतौर पर किसी और के हार्डवेयर, किसी और के सर्किट और किसी और के संस्करण पर ली गई क्वेरी और कोल्ड स्टार्ट समय दिखाती है। आप उन्हें अपने प्रोजेक्ट में स्थानांतरित नहीं कर सकते: दोनों लाइब्रेरी सक्रिय रूप से बदल रही हैं, और वास्तविक कार्यभार में समय आमतौर पर डेटाबेस के प्रश्नों द्वारा निर्धारित किया जाता है, ओआरएम से नहीं। इसलिए, नीचे डिवाइस और वर्कफ़्लो की तुलना और घर पर कोल्ड स्टार्ट को मापने का एक तरीका दिया गया है।
योजना
प्रिज्मा schema.prisma फ़ाइल में एक अलग डीएसएल है जिससे क्लाइंट जेनरेट होता है:
model User {
id Int @id @default(autoincrement())
email String @unique
posts Post[]
createdAt DateTime @default(now()) @map("created_at")
@@map("users")
}
model Post {
id Int @id @default(autoincrement())
title String
authorId Int @map("author_id")
author User @relation(fields: [authorId], references: [id])
@@index([authorId])
@@map("posts")
}ड्रिज़ल एक टाइपस्क्रिप्ट स्कीमा है, प्रकार बिना किसी पीढ़ी चरण के सीधे इससे प्राप्त होते हैं:
// src/db/schema.ts
import { pgTable, serial, text, integer, timestamp, index } from "drizzle-orm/pg-core";
export const users = pgTable("users", {
id: serial("id").primaryKey(),
email: text("email").notNull().unique(),
createdAt: timestamp("created_at").defaultNow().notNull(),
});
export const posts = pgTable("posts", {
id: serial("id").primaryKey(),
title: text("title").notNull(),
authorId: integer("author_id").notNull().references(() => users.id),
}, (t) => [index("posts_author_idx").on(t.authorId)]);
export type User = typeof users.$inferSelect;व्यवहार में अंतर: प्रिज्मा में, किसी भी स्कीमा परिवर्तन के बाद आपको prisma generate की आवश्यकता होती है (आमतौर पर postinstall और CI में), अन्यथा क्लाइंट प्रकार स्कीमा से मेल नहीं खाएंगे। ड्रिज़ल में, प्रकार को कोड के साथ अद्यतन किया जाता है, लेकिन स्कीमा अधिक क्रियात्मक है।
अनुरोध
// Prisma
const user = await prisma.user.findUnique({
where: { email },
include: { posts: { select: { id: true, title: true } } },
});
// Drizzle, SQL-подобный стиль
import { eq } from "drizzle-orm";
const rows = await db.select().from(users).where(eq(users.email, email));
// Drizzle, реляционный API (нужно описать relations для схемы)
const withPosts = await db.query.users.findFirst({
where: eq(users.email, email),
with: { posts: true },
});प्रिज्मा एसक्यूएल को अपने स्वयं के एपीआई के पीछे छुपाता है - बिना एसक्यूएल अनुभव वाली टीम के लिए आसान है, लेकिन एक जटिल क्वेरी (विंडो फ़ंक्शंस, सीटीई) $queryRaw में जाती है। ड्रिज़ल एसक्यूएल के करीब है: जो लिखा गया है उसे निष्पादित किया जाएगा, और कच्चे टुकड़ों के लिए एक टाइप किया हुआ टेम्पलेट sql है।
प्रवास
प्रिज्मा: prisma migrate dev स्कीमा की तुलना विकास आधार से करता है और prisma/migrations में SQL माइग्रेशन बनाता है, prisma migrate deploy इसे उत्पादन में लागू करता है।
ड्रिज़ल: drizzle-kit generate स्कीमा और पिछले स्नैपशॉट के बीच अंतर के आधार पर एक SQL फ़ाइल बनाता है, drizzle-kit migrate लागू होता है। प्रोटोटाइप के लिए drizzle-kit push है - माइग्रेशन फ़ाइलों के बिना सीधे योजना लागू करता है; इसका उपयोग उत्पादन में नहीं किया जाता है.
// drizzle.config.ts
import { defineConfig } from "drizzle-kit";
export default defineConfig({
schema: "./src/db/schema.ts",
out: "./drizzle",
dialect: "postgresql",
dbCredentials: { url: process.env.DATABASE_URL! },
});दोनों के लिए सामान्य नियम: उपयोग करने से पहले जेनरेट की गई SQL को पढ़ें। जनरेटर किसी कॉलम का नाम बदलने को हटाने और निर्माण, यानी डेटा हानि में बदल सकता है। ऐसे मामलों में ड्रिज़ल किट अंतःक्रियात्मक रूप से पूछती है कि क्या यह नाम बदला गया है या नया कॉलम है; प्रिज्मा में, माइग्रेशन फ़ाइल में नाम बदलना मैन्युअल रूप से किया जाता है।
सर्वर रहित और ठंडी शुरुआत
किसी फ़ंक्शन की कोल्ड स्टार्ट बंडल के आकार, क्लाइंट के आरंभीकरण और डेटाबेस से कनेक्शन की स्थापना से प्रभावित होती है।
- प्रिज्मा ने ऐतिहासिक रूप से रस्ट के लिए एक अलग क्वेरी इंजन का उपयोग किया, जिससे तैनाती का आकार बढ़ गया और प्लेटफ़ॉर्म के लिए सही बाइनरी की आवश्यकता हुई। नवीनतम संस्करणों में, प्रिज्मा रस्ट इंजन के बिना, ड्राइवर एडेप्टर के साथ टाइपस्क्रिप्ट पर कार्यान्वयन पर स्विच करता है। जांचें कि आपके संस्करण में कौन सा मोड है - एज के लिए आकार और समर्थन दोनों इस पर निर्भर करेंगे।
- ड्रिज़ल - चयनित ड्राइवर (
pg,postgres, नियॉन सर्वर रहित ड्राइवर और अन्य) के ऊपर एक पतली परत, बिना किसी अलग इंजन के।
ORM से अधिक महत्वपूर्ण हैं कनेक्शन. प्रत्येक फ़ंक्शन इंस्टेंस अपना स्वयं का कनेक्शन खोलता है, और जब ट्रैफ़िक में वृद्धि होती है, तो पोस्टग्रेज़ max_connections में चलता है। लेन-देन मोड या प्रदाता HTTP ड्राइवरों में एक पूलर (PgBouncer, प्रदाता पूलर) का उपयोग करें। लेनदेन मोड में PgBouncer के साथ प्रिज्मा को उन संस्करणों में कनेक्शन स्ट्रिंग में pgbouncer=true पैरामीटर की आवश्यकता होती है जो तैयार अभिव्यक्तियों का उपयोग करते हैं - दस्तावेज़ की जांच करें।
अपने आप को कैसे मापें
- 1.एक ही अनुरोध के साथ दो न्यूनतम फ़ंक्शन तैनात करें: एक प्रिज्मा पर, एक ड्रिज़ल पर, एक ही प्रदाता और क्षेत्र पर, एक ही डेटाबेस पर।
- 2.निष्क्रियता की अवधि के बाद प्रत्येक को 20-30 बार कॉल करके एक अच्छी शुरुआत करें।
- 3.प्लेटफ़ॉर्म मेट्रिक्स को देखें: AWS लैम्ब्डा पर, लॉग में
REPORTलाइन मेंInit Durationहोता है; अन्य प्लेटफ़ॉर्म की अपनी अवधि मेट्रिक्स होती हैं। - 4.केवल एक अच्छे माप की नहीं, बल्कि माध्यिका और सबसे खराब मूल्यों की तुलना करें।
यह काम का एक घंटा है, और परिणाम आपके स्टैक के बारे में होगा, किसी और के बारे में नहीं।
सामान्य गलतियाँ
next devमें प्रत्येक हॉट रीलोड के साथ नयाPrismaClient- सैकड़ों कनेक्शन। इंस्टेंस को डेवलपमेंट मोड मेंglobalThisमें सेव करें।drizzle-kit pushउत्पादन आधार के विरुद्ध।- सीआई में भूल गए
prisma generate: असेंबली एक प्रकार की त्रुटि के साथ क्रैश हो जाती है जो स्थानीय रूप से मौजूद नहीं है।
क्या चुनना है
प्रिज्मा - जब परिपक्व उपकरण महत्वपूर्ण होते हैं (स्टूडियो, स्पष्ट माइग्रेशन), विभिन्न स्तरों और अनुरोधों की एक टीम मुख्य रूप से सीआरयूडी होती है। बूंदा बांदी - जब कोई टीम आत्मविश्वास से एसक्यूएल लिखती है, तो आप हर अनुरोध को देखना चाहते हैं और कोई पीढ़ी कदम नहीं रखते हैं, और प्रोजेक्ट सर्वर रहित या एज पर रहता है। लाइव प्रोजेक्ट में ओआरएम बदलना महंगा है, इसलिए टीम की सुविधा के अनुसार चुनाव करना बेहतर है, न कि किसी और के माप के अनुसार।