排序與分頁
最後更新
本頁說明 orderBy()、limit()、offset() 與 total() 如何組合出分頁查詢。
orderBy()
MySQLPool.table("users").orderBy("created_at", "DESC").orderBy("id");
// ... ORDER BY `created_at` DESC, `id` ASC
| 規則 | 說明 |
|---|---|
| 預設方向 | ASC |
| 大小寫 | 方向先轉成大寫，"desc" 與 "DESC" 相同 |
| 欄位名 | 不含 . 時加反引號 |
| 多次呼叫 | 依呼叫順序以逗號串接 |
limit() 與 offset()
const page = 3;
const perPage = 20;
MySQLPool
.table("users")
.limit(perPage)
.offset((page - 1) * perPage);
// ... LIMIT 20 OFFSET 40
total()
total() 把原查詢包成子查詢，以 COUNT(*) OVER() 讓每一列都帶上符合條件的總筆數（src/MySQLPool.ts:254-256），分頁時不必再發一次 COUNT(*)。
interface UserRow {
total: number;
id: number;
name: string;
}
const rows = await MySQLPool
.table("users")
.select("id", "name")
.where("status", "active")
.total()
.orderBy("id", "DESC")
.limit(10)
.offset(0)
.get<UserRow>();
const total = rows[0]?.total ?? 0;
產生的 SQL：
SELECT COUNT(*) OVER() AS total, data.*
FROM (SELECT `id`, `name` FROM `users` WHERE `status` = ?) AS data
ORDER BY `id` DESC LIMIT 10 OFFSET 0