Bài viết này tổng hợp trọn vẹn: Prisma là gì, các tính năng cơ bản & nâng cao, kèm tips tối ưu hiệu năng và best practices.
1) Prisma là gì?
Prisma là ORM (Object–Relational Mapping) hiện đại dành cho Node.js/TypeScript. Nó cung cấp:
- Schema trung tâm mô tả dữ liệu & quan hệ.
- Prisma Client: API type-safe để truy vấn/ghi dữ liệu.
- Migrate: quản lý thay đổi cấu trúc DB (migration).
- Prisma Studio: giao diện web quản lý dữ liệu.
✅ Điểm mạnh: type-safety, DX tuyệt vời, migrations rõ ràng, hỗ trợ nhiều DB (PostgreSQL, MySQL/MariaDB, SQLite, SQL Server, MongoDB, CockroachDB, PlanetScale, Neon, Supabase...).
2) Kiến trúc nhanh
- schema.prisma: định nghĩa datasource, generator và model/enum.
- Prisma Client (được generate): truy vấn dữ liệu qua
.findMany,.create, ... - Query Engine: chạy dưới dạng binary hoặc library.
- CLI:
prisma generate,prisma migrate,prisma db push,prisma studio.
3) Cài đặt & khởi tạo
npm i prisma @prisma/client -D
npx prisma init
schema.prisma tối thiểu:
datasource db { provider = "postgresql"; url = env("DATABASE_URL") }
generator client { provider = "prisma-client-js" }
4) Data Modeling (cơ bản)
Ví dụ model & quan hệ:
model User {
id Int @id @default(autoincrement())
email String @unique
name String?
posts Post[]
createdAt DateTime @default(now())
}
model Post {
id Int @id @default(autoincrement())
title String
content String?
published Boolean @default(false)
author User @relation(fields: [authorId], references: [id])
authorId Int
categories Category[]
}
model Category {
id Int @id @default(autoincrement())
name String @unique
posts Post[]
}
Quan hệ phổ biến: 1-1, 1-n, n-n. Hỗ trợ @@unique, @@index, @@map, @db.* để map kiểu cụ thể DB.
5) Truy vấn (CRUD, filter, chọn cột)
const prisma = new PrismaClient()
// Create
await prisma.user.create({ data: { email: 'tam@example.com', name: 'Tam' } })
// Read + filter + phân trang + sắp xếp
const users = await prisma.user.findMany({
where: { email: { contains: '@example.com' } },
orderBy: { createdAt: 'desc' },
skip: 10,
take: 5,
})
// Select cột chỉ định & include quan hệ
const posts = await prisma.post.findMany({
select: {
id: true,
title: true,
author: { select: { name: true } },
categories: { select: { name: true } },
},
})
// Update / Delete
await prisma.user.update({ where: { id: 1 }, data: { name: 'Updated' } })
await prisma.user.delete({ where: { id: 1 } })
6) Aggregation & Grouping
// Tổng, đếm, trung bình
const agg = await prisma.post.aggregate({ _count: { id: true }, _sum: { /* field số */ }, _avg: { /* field số */ } })
// GroupBy
const byAuthor = await prisma.post.groupBy({
by: ['authorId'],
_count: { id: true },
orderBy: { authorId: 'asc' },
})
CASE WHEN + SUM nâng cao ➜ dùng Raw SQL (xem mục 12).
7) Transactions
// Interactive transaction
await prisma.$transaction(async (tx) => {
const user = await tx.user.create({ data: { email: 'a@b.c' } })
await tx.profile.create({ data: { userId: user.id } })
})
// Batched transaction (đảm bảo cùng connection)
await prisma.$transaction([
prisma.user.create({ data: { email: 'x@y.z' } }),
prisma.profile.create({ data: { userId: 123 } }),
])
8) Migrations & DB Sync
npx prisma migrate dev --name init→ tạo & áp migration.npx prisma migrate deploy→ áp dụng migration trên prod.npx prisma db push→ sync schema nhanh (không tạo migration, phù hợp dev/prototype).
Shadow DB: dùng shadowDatabaseUrl để migration an toàn.
9) Prisma Studio
npx prisma studio # UI quản lý dữ liệu tại http://localhost:5555
10) Middleware & Soft Delete
// Logging & đo thời gian
prisma.$use(async (params, next) => {
const start = Date.now()
const result = await next(params)
console.log(`${params.model}.${params.action} took ${Date.now() - start}ms`)
return result
})
// Soft delete
prisma.$use(async (params, next) => {
if (params.model === 'Post' && params.action === 'delete') {
params.action = 'update'
params.args.data = { deletedAt: new Date() }
}
return next(params)
})
11) Client Extensions (mở rộng API)
const xprisma = prisma.$extends({
model: {
user: {
findByEmail(email: string) {
return prisma.user.findUnique({ where: { email } })
},
},
},
})
await xprisma.user.findByEmail('tam@example.com')
12) Raw SQL (CASE WHEN, JOIN, tính toán đặc thù)
// CASE WHEN + SUM
const totals = await prisma.$queryRaw`
SELECT
SUM(CASE WHEN status = 'COMPLETED' THEN amount ELSE 0 END) AS completed_total,
SUM(CASE WHEN status <> 'COMPLETED' THEN amount ELSE 0 END) AS other_total
FROM "Order";
`
// JOIN + GROUP BY
const byUser = await prisma.$queryRaw`
SELECT u.id, u.name,
SUM(CASE WHEN o.status='COMPLETED' THEN o.amount ELSE 0 END) AS completed_total
FROM "User" u
LEFT JOIN "Order" o ON u.id = o."userId"
GROUP BY u.id, u.name;
`
Khi dùng Raw SQL: được quyền tối ưu tuỳ ý, nhưng mất type-safety, cần cẩn thận SQL injection (luôn dùng template tag ``$queryRaw... để parameterized**).
13) Chia nhỏ schema (multi-file imports)
Từ Prisma v5+ hỗ trợ import để tách file:
// schema.prisma
generator client { provider = "prisma-client-js" }
datasource db { provider = "postgresql"; url = env("DATABASE_URL") }
import "./enums/role.prisma"
import "./models/user.prisma"
import "./models/post.prisma"
Lưu ý thứ tự import: enum/type trước, rồi model dùng chúng.
14) Cấu hình nâng cao (generator & datasource)
generator client {
provider = "prisma-client-js"
output = "../src/generated/client"
engineType = "binary" // hoặc "library"
previewFeatures = ["driverAdapters", "fullTextSearch"]
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
directUrl = env("DIRECT_DATABASE_URL") // ưu tiên read/read-replica
shadowDatabaseUrl = env("SHADOW_DATABASE_URL") // migration an toàn
relationMode = "prisma" // hoặc "foreignKeys"
extensions = [citext, uuid_ossp] // PostgreSQL extensions
}
engineType: library có thể giảm độ trễ so với binary (tuỳ môi trường).
15) Serverless/Edge, Connection Pooling & Replicas
- Dùng connection pooling (PgBouncer, Neon, PlanetScale) để giảm chi phí kết nối ngắn.
- directUrl trỏ tới read-replica cho truy vấn đọc nặng;
urldùng cho ghi. - Với serverless (Vercel, Cloudflare Workers, AWS Lambda): cân nhắc Data Proxy/driver adapters, giảm cold start & connection churn.
16) Seeding & Testing
npx prisma db seed
package.json:
{
"prisma": { "seed": "ts-node prisma/seed.ts" }
}
Testing (Jest/Vitest) → dùng DB test riêng, chạy migration trước test, xoá dữ liệu sau mỗi test.
17) Logging & Debugging
const prisma = new PrismaClient({
log: [ { emit: 'stdout', level: 'query' }, 'info', 'warn', 'error' ],
})
Có thể bật env DEBUG=* hoặc PRISMA_CLIENT_ENGINE_TYPE=library để chẩn đoán.
18) Bảo mật & Vận hành
- Biến môi trường
.env, không commit credentials. - Tài khoản DB ít quyền (least privilege).
- Mã hoá trường nhạy cảm ở tầng ứng dụng (Prisma chưa mã hoá field built-in).
- CI/CD: chạy
prisma migrate deploytrong pipeline, backup trước khi deploy.
19) Tips tối ưu hiệu năng (đáng áp dụng)
- Chỉ lấy cột cần thiết → dùng
selectthay vìincludetràn lan. - Phân trang bằng
cursorthay vìskip/takesâu để tránh offset-scan nặng. - Đặt index đúng chỗ: các trường lọc/sắp xếp thường dùng (
email,createdAt, FK...). - Tránh N+1: gộp truy vấn, dùng
include/selecthợp lý hoặc DataLoader ở tầng service. - Dùng transaction hợp lý: nhóm các thao tác liên quan vào
.$transactionđể đảm bảo nhất quán & giảm round-trips. - Batch writes khi có thể; chú ý size limit.
- Sử dụng
engineType: 'library'(nếu phù hợp) để giảm latency. - Connection pooling ở prod, đặc biệt serverless.
- Cache đọc với tầng ngoài (Redis) hoặc Prisma Accelerate (nếu dùng) + TTL & invalidation đúng chuẩn.
- Đo đạc trước tối ưu: bật
log: 'query', APM (OpenTelemetry), time-to-first-byte.
20) Ví dụ nâng cao tổng hợp (join + select cột + filter)
const posts = await prisma.post.findMany({
where: {
published: true,
categories: { some: { name: 'Lập trình' } },
},
select: {
id: true,
title: true,
author: { select: { id: true, name: true } },
categories: { select: { name: true } },
_count: { select: { comments: true } },
},
orderBy: { id: 'desc' },
take: 20,
})
21) FAQ ngắn
- Prisma có
CASE WHENtrong select không? → Không trực tiếp, dùng Raw SQL. - Có tách schema ra nhiều file không? → Có từ v5 (
import). - MongoDB dùng được không? → Có (native connector), nhưng một số tính năng khác biệt.
Kết luận
Prisma cung cấp nền tảng ORM hiện đại, type-safe, DX tốt cho Node.js/TS. Hãy bắt đầu từ mô hình hoá rõ ràng, dùng select tinh gọn, index chuẩn, transaction hợp lý, pooling/cache đúng cách — bạn sẽ có một backend nhanh, ổn định và dễ bảo trì.