Skip to Content

db

Client Drizzle cho database SQLite riêng của app, import từ app/db cùng các hàm dựng bảng và toán tử truy vấn.

Cách dùng

app/orders/repository.ts
import { db, eq, desc } from "app/db"; import { orders } from "./orders.table"; export async function recentOrders(customerId: number) { return db.select().from(orders) .where(eq(orders.customerId, customerId)) .orderBy(desc(orders.createdAt)) .limit(10); } export async function markPaid(id: number) { const [row] = await db.update(orders).set({ status: "paid" }).where(eq(orders.id, id)).returning(); return row; }

Đặt truy vấn trong repository.ts; handler gọi hàm của repository.

Chữ ký

app/db.ts
export const db; // client Drizzle, tạo ở lần dùng đầu // Dựng bảng (dùng trong *.table.ts) export { sqliteTable, integer, text, real, blob, index, uniqueIndex, primaryKey, foreignKey, unique, alias }; // Toán tử và hàm gộp export { eq, ne, lt, lte, gt, gte, like, ilike, notLike, notIlike, and, or, not, isNull, isNotNull, inArray, notInArray, between, notBetween, exists, notExists, asc, desc, sql, count, countDistinct, sum, sumDistinct, avg, avgDistinct, min, max }; // Của Manh export function schemaOf(table); export function listSchema(opts?); export function listOf(table, query, opts?); export function insertMany(table, rows); export function scopeBy(user, rules);

app/db.ts do manh.run sinh mỗi lần deploy. Không viết file này. Import một tên khác ngoài danh sách trên thì check báo lỗi, vì build sẽ hỏng; cần gì khác thì viết bằng template sql.

Tham số

Không có. db là một object, không phải hàm.

Trả về

db có đủ API truy vấn của Drizzle: select, insert, update, delete, transaction. Kết quả là các dòng của bảng, kiểu lấy từ khai báo trong *.table.ts.

Ví dụ

Ghi rồi lấy lại dòng vừa ghi bằng .returning():

app/orders/repository.ts
const [created] = await db.insert(orders).values({ customerName, total }).returning();

Nhiều lệnh ghi phải xong cùng nhau hoặc không lệnh nào xong: callback đồng bộ, không async, không await, kết thúc mỗi lệnh bằng .run(), .get() hoặc .all().

app/orders/repository.ts
let order!: typeof orders.$inferSelect; db.transaction((tx) => { order = tx.insert(orders).values(row).returning().get(); tx.insert(items).values(lines.map((l) => ({ ...l, orderId: order.id }))).run(); }); return order;
  • Không viết db.transaction(async (tx) => …): lệnh sau await đầu tiên chạy ngoài giao dịch, và khi có lỗi thì các lệnh đã ghi không được huỷ.
  • db.transaction(...) luôn trả {}. Đưa kết quả ra ngoài qua biến, như trên.
  • Request của một app chạy lần lượt. Đọc, kiểm, ghi liền nhau thì không cần giao dịch. Nhưng trong lúc chờ một lệnh ra ngoài app (fetch, email, AI, kho file), request khác được chạy xen vào: gửi email và gọi AI sau khi ghi xong.
  • Một câu lệnh nhận tối đa 100 giá trị gắn (?). db.insert(t).values([...]) nhiều dòng được manh.run tự chia thành nhiều câu trong một giao dịch, nên không cần tự chia lô. insertMany(table, rows) làm cùng việc và trả mọi dòng đã chèn.
  • SQLite không có kiểu boolean: dùng integer 0/1.

Bước tiếp theo

  • Database: khai báo bảng, đổi schema khi deploy.
  • schemaOf: schema zod cho body tạo và sửa, lấy từ bảng.
  • listSchema, listOf: API danh sách có trang, tìm, lọc trong một lời gọi.
Cập nhật