後端、資料與安全 核心 C · 業界慣例 平台: 網頁

Offset Pagination

位移分頁

位移分頁會先略過排序後的指定筆數,再回傳下一頁,筆數不超過設定上限。

看看怎麼運作
也有人這樣說 Offset PaginationLimit/Offset 分頁頁碼分頁

看看怎麼運作

原創情境範例位移分頁

另一個例子

管理員在每天夜間產生的穩定客戶快照中,用 `limit=50&offset=100` 跳到第 3 頁。排序會用 `customer_id` 固定處理同順位資料。即時新增資料可能讓頁面位移,所以即時活動串流改用游標。

主要部分

  1. 01穩定排序
  2. 02位移與上限
  3. 03頁面中繼資料

什麼時候用

資料量不大、內容穩定,而且頁碼和任意跳頁很重要時,可以使用。也要量測查詢成本。

什麼時候不要用

避免很大的偏移量或快速變動的清單,因為掃描可能變慢,資料也可能在不同頁重複或消失。

程式裡的名稱

deterministic ORDER BY + LIMIT page_size + OFFSET n

上線前要檢查

檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。

可以直接複製的需求

預期成果:為這套系統設計或檢查 位移分頁 (Offset Pagination),並讓資料保持正確、安全且容易維護。 使用者情境:管理員在每天夜間產生的穩定客戶快照中,用 `limit=50&offset=100` 跳到第 3 頁。排序會用 `customer_id` 固定處理同順位資料。即時新增資料可能讓頁面位移,所以即時活動串流改用游標。 技術概念或控制措施:位移分頁 (Offset Pagination)。 適用理由:資料量不大、內容穩定,而且頁碼和任意跳頁很重要時,可以使用。也要量測查詢成本。 不應使用的情況:避免很大的偏移量或快速變動的清單,因為掃描可能變慢,資料也可能在不同頁重複或消失。 工程要求:定義輸入、輸出、介面約定,以及任何情況都不能破壞的規則。說明授權與輸入檢查範圍。定義失敗、逾時、重試和重複執行只生效一次的規則。也要定義資料搬移與相容限制。 營運要求:加入監控訊號與隱藏敏感資料的記錄。設定容量上限並寫好操作手冊。測試復原與回復上一版的流程。 驗收條件:介面約定與失敗路徑測試通過。重試或部分失敗時,資料與授權規則仍正確。效能上限、監控、復原與回復上一版的方法都已驗證。 證據與限制(證據邊界):沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。 待確認:程式執行環境、資料位置、流量形態、資料一致需求和安全邊界。也要確認相容期間、服務目標(SLO)與回復上一版的限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 位移分頁 (Offset Pagination)。 定義:位移分頁會先略過排序後的指定筆數,再回傳下一頁,筆數不超過設定上限。 正式環境檢查:檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

C
這個術語有多正式?

業界慣例

工作上常會用到這個術語。列出的來源可能說明用法或限制,但不會定義全部內容。

沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。

適用範圍
只包含來源有說明的內容:正式名稱、定義、平台 API、實作、使用指南
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · PostgreSQL Global Development Group · 穩定 LIMIT and OFFSET 適用範圍: 正式名稱、定義、平台 API、實作、使用指南 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 平台 API, 實作, 使用指南

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。