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 sauawaitđầ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
integer0/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