Skip to Content

<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.ts

Vai 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 check cảnh báo perf.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ọn onDelete có chủ ý.
  • SQLite không có kiểu boolean: dùng integer 0/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.ts thì manh.run sinh app/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