TOOLS BOX/ガイド/skip

API / Option

skip

Prisma クエリで先頭から N 件をスキップするオプション。take と組み合わせてページネーションを実現する。

prismapaginationqueryoffset

所属:Prisma Client

代表的な値 / 使い方

skip: 0
skip: (page - 1) * PAGE_SIZE
skip: 20

注意点 / Pitfalls

·大量データで skip 値が大きくなるとパフォーマンスが低下する（DB がスキップ分も読む）
·データの追加・削除が並行して起きている場合、skip/take ではページ境界がずれる
·高速なページネーションが必要な場合は cursor ベースの方式を検討する

一緒に使う項目

take order-by where

補足

offset ベースのページネーションでは skip = (page - 1) * pageSize が基本式。大量データ（数万件以上）を扱う場合は cursor ベースへの移行を検討する。

関連ドキュメント

take order-by cursor where

関連サンプル

同じテーマや技術スタックを使った実装例

Prisma で skip / take を使ったページネーションクエリを実装する
Prisma の skip / take / orderBy を使ったオフセットページネーションと、cursor ベースのページネーションのパターン、Route Handler との組み合わせ例。