0

Supabase hay Neon, Prisma hay Drizzle: chọn database và ORM cho app Next.js và Remix

Mỗi lần mở một project mới, mình lại tự hỏi đúng hai câu: database để đâu, ORM nào. Nhìn lại máy thì thấy mình đã trả lời khác nhau ở gần như mỗi project: một app Next.js dùng Supabase với Prisma, một app Next.js khác dùng Supabase mà không có ORM nào, một web bán hàng dùng Supabase với Drizzle, một app Shopify viết bằng Remix dùng Prisma, một app POS desktop dùng Drizzle.

Không phải vì mình thích đổi. Mỗi lần, câu trả lời phụ thuộc vào một hai điều rất cụ thể về app đó. Bài này gom lại những điều đó: Supabase và Neon khác nhau ở đâu, nối từ Next.js và Remix thế nào cho khỏi cạn kết nối, Prisma và Drizzle khác nhau ra sao khi đặt cùng một query cạnh nhau, và bốn cái bẫy chỉ lộ ra khi lên production. Code Prisma và Drizzle trong bài mình đã chạy thử trên cùng một Postgres với Prisma 7.10 và Drizzle ORM 0.45. Neon thì mình chưa dùng trong project thật, phần đó viết theo tài liệu chính thức.

Supabase và Neon: bạn cần gì ngoài một database?

Cả hai đều cho bạn PostgreSQL thật, nối bằng chuỗi kết nối Postgres bình thường, dùng Prisma hay Drizzle đều được. Khác nhau ở chỗ cái gì đi kèm database:

Supabase Neon
Bản chất Cả một backend xây quanh Postgres Postgres serverless, chỉ tập trung vào database
Đi kèm Auth (đăng nhập), Storage (file), Realtime, API tự sinh từ bảng, Row Level Security, Edge Functions Branching: tạo nhánh database như nhánh Git; tự tắt khi không dùng; driver kết nối qua HTTP
Kết nối từ app serverless Pooler Supavisor (cổng 6543, chế độ transaction) Chuỗi kết nối có -pooler trong tên host (PgBouncer, chế độ transaction)
Hợp nhất khi Cần đăng nhập, upload file, realtime mà không muốn tự dựng Đã có auth và storage ở chỗ khác, cần một Postgres rẻ, mỗi nhánh code một database để test

Câu hỏi để chọn rất đơn giản: ngoài bảng dữ liệu, app của bạn còn cần gì? Cần đăng nhập, lưu ảnh đại diện, file đính kèm thì Supabase cho bạn những thứ đó trong cùng một chỗ. Ví dụ một app Next.js có upload file của mình dùng Supabase Storage để lưu file và chỉ ghi đường dẫn vào bảng. Còn nếu auth đã có (Entra ID, Clerk, Auth.js) và bạn chỉ cần Postgres, Neon gọn hơn, và tính năng branching rất hợp với kiểu làm mỗi pull request một bản preview.

Nối từ Next.js và Remix: một URL cho app, một URL cho migration

Đây là phần nhiều người làm sai đầu tiên. Next.js trên Vercel hay Remix trên một nền tảng serverless có thể chạy hàng chục instance cùng lúc, mỗi instance mở vài kết nối. Postgres chỉ chịu được một số kết nối có hạn, vượt là lỗi remaining connection slots are reserved.

Giải pháp là đi qua pooler: một tầng đứng trước Postgres, gom hàng trăm kết nối của app vào vài chục kết nối thật. Nhưng pooler ở chế độ transaction không hợp với những lệnh cần giữ phiên làm việc, mà migration lại cần đúng những thứ đó. Nên cần hai URL:

# App đọc ghi qua pooler (Supabase: cổng 6543)
DATABASE_URL="postgres://postgres.<project>:<mật-khẩu>@aws-0-<vùng>.pooler.supabase.com:6543/postgres?pgbouncer=true"

# CLI migrate đi thẳng, không qua pooler
DIRECT_URL="postgresql://postgres:<mật-khẩu>@db.<project>.supabase.co:5432/postgres"

Với Neon, hai URL chỉ khác nhau ở chữ -pooler trong tên host: ep-xxx-pooler.<vùng>.aws.neon.tech cho app, ep-xxx.<vùng>.aws.neon.tech cho migration.

Một chi tiết với Supabase: kết nối trực tiếp db.<project>.supabase.co mặc định đi bằng IPv6. Máy dev hay máy CI không có IPv6 thì không nối được, lỗi rất khó hiểu. Khi đó dùng session pooler (cùng host pooler, cổng 5432) làm DIRECT_URL.

Nếu app chạy trên edge (Vercel Edge, Cloudflare Workers như ở bài trước), kết nối TCP kiểu Postgres truyền thống không phải lúc nào cũng dùng được. Neon có driver serverless nói chuyện qua HTTP hoặc WebSocket; Cloudflare có Hyperdrive đứng giữa làm pooler. Chạy Node thông thường thì không cần quan tâm phần này.

Prisma và Drizzle: đặt cạnh nhau

Cùng một bài toán: bảng người dùng, bảng bài viết, lấy 10 bài đã đăng mới nhất kèm tên tác giả.

Khai báo schema

Prisma dùng ngôn ngữ schema riêng (file .prisma):

generator client {
  provider = "prisma-client"
  output   = "../generated/prisma"
}

datasource db {
  provider = "postgresql"
}

model User {
  id    Int    @id @default(autoincrement())
  email String @unique
  name  String
  posts Post[]
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  published Boolean  @default(false)
  createdAt DateTime @default(now()) @map("created_at")
  author    User     @relation(fields: [authorId], references: [id])
  authorId  Int      @map("author_id")

  @@index([authorId])
}

Drizzle viết schema bằng TypeScript:

import { relations } from "drizzle-orm";
import { boolean, index, integer, pgTable, serial, text, timestamp } from "drizzle-orm/pg-core";

export const users = pgTable("users", {
  id: serial("id").primaryKey(),
  email: text("email").notNull().unique(),
  name: text("name").notNull(),
});

export const posts = pgTable(
  "posts",
  {
    id: serial("id").primaryKey(),
    title: text("title").notNull(),
    published: boolean("published").notNull().default(false),
    createdAt: timestamp("created_at").notNull().defaultNow(),
    authorId: integer("author_id").notNull().references(() => users.id),
  },
  (t) => [index("posts_author_idx").on(t.authorId)],
);

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, { fields: [posts.authorId], references: [users.id] }),
}));

Prisma đọc dễ hơn với người mới, nhất là phần quan hệ. Drizzle dài hơn nhưng là TypeScript thật: dùng lại hằng số, tách file, viết hàm sinh cột chung cho nhiều bảng đều được, và trông rất gần với SQL bạn sẽ chạy.

Kết nối

Prisma 7 tách hẳn hai việc: CLI đọc URL trong prisma.config.ts, app tạo client với một driver adapter.

// prisma.config.ts: CLI (migrate) dùng URL trực tiếp
import "dotenv/config";
import { defineConfig, env } from "prisma/config";

export default defineConfig({
  schema: "prisma/schema.prisma",
  datasource: { url: env("DIRECT_URL") },
});
// lib/db.ts: app dùng URL qua pooler
import { PrismaPg } from "@prisma/adapter-pg";
import { PrismaClient } from "../generated/prisma/client";

export const prisma = new PrismaClient({
  adapter: new PrismaPg({ connectionString: process.env.DATABASE_URL }),
});

Drizzle chỉ bọc lấy một driver Postgres có sẵn:

// lib/db.ts
import { drizzle } from "drizzle-orm/postgres-js";
import postgres from "postgres";
import * as schema from "./schema";

// prepare: false để chạy được qua pooler chế độ transaction
const client = postgres(process.env.DATABASE_URL!, { prepare: false });
export const db = drizzle(client, { schema });

Query

// Prisma
const latest = await prisma.post.findMany({
  where: { published: true },
  orderBy: { createdAt: "desc" },
  take: 10,
  select: { id: true, title: true, author: { select: { name: true } } },
});
// [{ id: 2, title: "Bài đã đăng", author: { name: "An" } }]
// Drizzle, cách 1: query builder, viết gần như SQL
const latest = await db
  .select({ id: posts.id, title: posts.title, author: users.name })
  .from(posts)
  .innerJoin(users, eq(posts.authorId, users.id))
  .where(eq(posts.published, true))
  .orderBy(desc(posts.createdAt))
  .limit(10);
// [{ id: 2, title: "Bài đã đăng", author: "An" }]

// Drizzle, cách 2: relational query, viết gần như Prisma
const latest2 = await db.query.posts.findMany({
  where: eq(posts.published, true),
  orderBy: desc(posts.createdAt),
  limit: 10,
  columns: { id: true, title: true },
  with: { author: { columns: { name: true } } },
});
// [{ id: 2, title: "Bài đã đăng", author: { name: "An" } }]

Kết quả trong comment là kết quả thật khi mình chạy thử. Cả ba cách đều có kiểu TypeScript đầy đủ: gõ nhầm tên cột là editor báo đỏ ngay.

Migration

Prisma Drizzle
Sinh migration từ schema prisma migrate dev --name init drizzle-kit generate --name init
Áp lên database production prisma migrate deploy drizzle-kit migrate
Đẩy schema thẳng, không file migration (chỉ nên dùng khi dev) prisma db push drizzle-kit push
Kết quả File SQL trong prisma/migrations File SQL trong thư mục drizzle

Cả hai đều sinh file SQL thường, đọc và sửa tay được trước khi áp. Một chuyện mình gặp khi chạy thử: drizzle-kit push hỏi tương tác khi gặp thay đổi chưa rõ (ví dụ có bảng lạ trong database), nên chạy trong CI hay script là lỗi "Interactive prompts require a TTY". Luồng generate rồi migrate không hỏi gì, và đó cũng là luồng nên dùng cho production.

Bảng so sánh

Prisma Drizzle
Viết schema Ngôn ngữ schema riêng, ngắn, dễ đọc TypeScript, dài hơn, linh hoạt hơn
Viết query API riêng (findMany, include, select) Hai cách: gần SQL hoặc gần Prisma
Cần bước sinh code Có: prisma generate sau mỗi lần sửa schema Không: kiểu suy ra thẳng từ schema TypeScript
Khi cần SQL phức tạp Xuống raw SQL ($queryRaw, TypedSQL) Query builder viết được gần hết, còn lại dùng sql
Edge, Workers Prisma 7 đã bỏ engine viết bằng Rust, chạy qua driver adapter nên nhẹ hơn trước nhiều Mỏng sẵn, chạy được ở hầu hết runtime có driver
Hệ sinh thái Prisma Studio, template có sẵn (template app Shopify chọn Prisma) Drizzle Studio, cộng đồng nhỏ hơn nhưng lớn nhanh
Hợp với Team đông, nhiều người mới, muốn mọi query trông giống nhau Người quen SQL, muốn thấy rõ SQL sẽ chạy, cần mỏng

Nhận xét thật của mình sau mấy project: Prisma dễ cho người mới vào team và dễ đọc khi review. Drizzle dễ chịu hơn khi query bắt đầu phức tạp (gom nhóm, join nhiều bảng, subquery), vì bạn viết gần như SQL mà vẫn có kiểu.

Bốn tổ hợp, chọn cái nào

Tổ hợp Hợp với Ở máy mình
Supabase, không ORM (supabase-js) App mà trình duyệt đọc ghi trực tiếp, bảo vệ dữ liệu bằng Row Level Security; ít logic phía server App hỏi đáp AI viết bằng Next.js
Supabase + Prisma Cần Auth, Storage của Supabase, logic nằm ở server, team quen Prisma App Next.js có upload file
Supabase + Drizzle Như trên, nhưng query phức tạp, muốn gần SQL Web bán hàng
Neon + Prisma hoặc Drizzle Đã có auth chỗ khác, cần Postgres thuần, muốn mỗi nhánh code một database Chưa dùng trong project thật

Với Remix (giờ là React Router), mọi thứ trên giữ nguyên: loader và action chạy trên server, gọi prisma hay db như gọi trong Route Handler của Next.js.

Bốn cái bẫy

1. ORM nối thẳng vào Supabase là bỏ qua Row Level Security

Row Level Security (RLS) là luật trong Postgres kiểu "người dùng chỉ thấy dòng của chính mình". Supabase dựa vào nó để trình duyệt gọi thẳng database mà vẫn an toàn. Nhưng RLS chỉ có tác dụng khi request đi vào bằng role của người dùng (key anon hay authenticated qua supabase-js).

Prisma và Drizzle thường nối bằng chuỗi kết nối của role postgres, mà role này có quyền bỏ qua RLS. Nghĩa là: bạn viết chính sách RLS cẩn thận, rồi một route API dùng Prisma quên lọc where: { userId }, và người dùng A đọc được dữ liệu của B. Chính sách RLS không chặn gì cả.

Quy tắc mình giữ: đã đọc ghi qua ORM ở server thì kiểm quyền ở code server, coi RLS là lớp bảo vệ cho các đường đi qua supabase-js, không phải cho ORM.

2. Pooler chế độ transaction và prepared statement

Pooler chế độ transaction trả kết nối về pool sau mỗi transaction, nên request sau có thể rơi vào một kết nối thật khác. Những thứ gắn với một phiên làm việc (SET, LISTEN/NOTIFY, advisory lock theo phiên, prepared statement ở mức SQL) sẽ hỏng ngẫu nhiên.

  • Drizzle với driver postgres: đặt prepare: false, như web bán hàng của mình đang làm.
  • Prisma với Supabase: thêm ?pgbouncer=true vào DATABASE_URL theo hướng dẫn của Prisma.
  • Migration luôn đi DIRECT_URL.

3. Neon tự tắt khi không dùng

Database Neon tự tắt sau 5 phút không có truy vấn, và dậy lại trong vài trăm mili giây khi có truy vấn mới. Với môi trường dev và preview, đây là thứ giúp tiết kiệm tiền. Với một API cần phản hồi đều đặn, request đầu tiên sau lúc yên ắng sẽ chậm hơn hẳn các request sau. Biết trước để đừng đi debug một "lỗi chậm ngẫu nhiên".

4. Chuỗi kết nối lọt sang trình duyệt

Một file kết nối database mình từng đọc lấy chuỗi kết nối theo thứ tự DATABASE_URL, rồi tới VITE_DATABASE_URL. Biến có tiền tố VITE_ (hay NEXT_PUBLIC_ với Next.js) là biến được phép nhúng vào code chạy trên trình duyệt. Chỉ cần một module phía client import nhầm file đó, chuỗi kết nối kèm mật khẩu database nằm trong file JavaScript ai cũng tải được.

Quy tắc: chuỗi kết nối database không bao giờ mang tiền tố public, và file kết nối đặt ở chỗ chỉ server import được (Remix: tên file .server.ts; Next.js: thêm import "server-only" ở đầu file).

Thêm một bẫy nhỏ dành riêng cho Next.js khi dev: mỗi lần lưu file, hot reload tạo lại module và tạo thêm một client mới, sau một lúc cạn kết nối. Giữ client trong globalThis khi ở môi trường dev:

const globalForDb = globalThis as unknown as { prisma?: PrismaClient };
export const prisma = globalForDb.prisma ?? new PrismaClient({ adapter });
if (process.env.NODE_ENV !== "production") globalForDb.prisma = prisma;

Checklist

[ ] Chọn Supabase nếu cần Auth, Storage, Realtime; Neon nếu chỉ cần Postgres và muốn branching
[ ] DATABASE_URL đi qua pooler; DIRECT_URL (không qua pooler) cho migration
[ ] Supabase: thiếu IPv6 thì dùng session pooler cổng 5432 làm DIRECT_URL
[ ] Drizzle qua pooler transaction: prepare: false; Prisma với Supabase: ?pgbouncer=true
[ ] Migration bằng generate/migrate dev + deploy; push chỉ dùng khi dev
[ ] ORM nối bằng role postgres thì kiểm quyền ở code server, đừng trông vào RLS
[ ] Chuỗi kết nối không có tiền tố VITE_ hay NEXT_PUBLIC_; file kết nối chỉ server import được
[ ] Next.js dev: giữ client trong globalThis
[ ] Dev và production dùng hai database khác nhau

Thử ngay: mở file kết nối database trong project của bạn, tìm xem chuỗi kết nối đang lấy từ biến nào, và file đó có bị một component phía client import không. Rồi mở bảng điều khiển Supabase, xem có bảng nào bật RLS mà dữ liệu vẫn được đọc qua ORM không.

Bài trước trong series: đưa một app Remix full-stack lên Cloudflare Workers. Bạn đang dùng tổ hợp nào, và vì sao? Comment cho mình biết với.

P.S. Cái bẫy RLS ở trên là thứ mình muốn ai đó nhắc trước khi viết route đầu tiên. Giờ mỗi khi làm phần dữ liệu trên Supabase, mình mở skill supabase-development trong PrimeKit, bộ skill mình tự làm. Skill bao quát auth, RLS, Data API, migration của Supabase, và kiểm theo đúng phiên bản project đang dùng. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:supabase-development kèm phần đang làm. Quyết định dữ liệu nào ai được thấy vẫn là việc của bạn.

Tài liệu để đọc thêm


Series khác của mình


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí