<resource>.table.ts
Mỗi file <resource>.table.ts khai báo một bảng trong database SQLite riêng của app, viết bằng Drizzle, và manh.run tạo bảng khi deploy.
app/orders/
├── orders.table.ts # bảng orders
├── repository.ts # import { orders } from "./orders.table"
├── get.ts
└── post.tsVai trò
Một file một bảng, đặt cạnh handler của resource đó. Khi deploy, manh.run đọc các file .table.ts và đưa database về đúng khai báo: bảng mới được tạo, cột mới được thêm.
Export
Một bảng tạo bằng sqliteTable. Hàm dựng cột và index import từ app/db: sqliteTable, integer, text, real, blob, index, uniqueIndex, primaryKey, foreignKey, unique.
Ví dụ
app/orders/orders.table.ts
import { sqliteTable, integer, text, index } from "app/db";
import { customers } from "../customers/customers.table";
export const orders = sqliteTable("orders", {
id: integer("id").primaryKey({ autoIncrement: true }),
customerId: integer("customer_id").notNull().references(() => customers.id, { onDelete: "restrict" }),
total: integer("total").notNull(),
status: text("status").notNull().default("new"),
note: text("note"), // cho phép null
createdAt: integer("created_at").notNull(),
}, (t) => [
index("orders_created_at_idx").on(t.createdAt), // cột sắp xếp mặc định của danh sách
index("orders_status_idx").on(t.status), // cột lọc
]);Cần biết
- Cột nào danh sách sắp xếp theo thì cột đó cần index, nếu không
checkcảnh báoperf.order-unindexed. - Thay đổi chỉ thêm, không xoá: cột và bảng không bao giờ tự bị xoá hay đổi kiểu. Đổi tên cột là thêm cột mới rồi chép dữ liệu.
- Cột
.notNull()mới không có.default()được thêm dưới dạng cho phép null. Cho cột bắt buộc mới một giá trị mặc định. - Khoá ngoại được kiểm thật: xoá khách còn đơn sẽ lỗi
FOREIGN KEY constraint failed. ChọnonDeletecó chủ ý. - SQLite không có kiểu boolean: dùng
integer0/1. - Tối đa 100 cột mỗi bảng. File không lưu vào cột: dùng kho file
manh/blob. - Có
app/auth.tsthì manh.run sinhapp/users/users.table.ts. Xem File sinh sẵn.
Bước tiếp theo
- repository.ts — viết truy vấn và quy tắc nghiệp vụ trên bảng vừa khai báo.
- Database — index, thay đổi schema và giới hạn của database.
Cập nhật