N+1クエリ問題とは、一覧データを1回のクエリで取得した後、各レコードの関連データを1件ずつ個別にクエリする結果、合計 N+1 回のデータベースアクセスが発生してしまうパフォーマンス上のアンチパターンである。
ORM(Object-Relational Mapping)やクエリビルダを使っていると、意識しないうちにこの問題を踏むことが多い。流れはこうだ。
たとえば用語集の一覧ページを表示するケースを考える。まず glossaries テーブルから 50 件を SELECT し、続いて各用語の翻訳データを translations テーブルから 1 件ずつ取得すると、合計 51 回のクエリが走る。件数が 500 になれば 501 回だ。
1 回あたりのクエリが数ミリ秒で返るとしても、回数が線形に増えるため、データ量に比例してレスポンスタイムが悪化する。ローカル開発では数十件しかないテーブルが本番では数千件に膨らみ、そこで初めて遅延が顕在化する——という事故は珍しくない。
さらに、DB サーバーとアプリケーションサーバーがネットワーク越しに分離されている環境では、ラウンドトリップのオーバーヘッドが回数分だけ積み重なる。クエリ自体は軽くても、ネットワークレイテンシが支配的になるパターンだ。
代表的な解決策は eager loading(事前読み込み)と JOIN の 2 つに大別できる。
| 手法 | フレームワーク例 | 概要 |
|---|---|---|
| eager loading | Rails の includes / Django の select_related / Prisma の include | ORM が関連データをまとめて取得するクエリを自動生成する |
| 明示的 JOIN | 生 SQL / Supabase の .select("*, children(*)") | 1 回のクエリで親子を結合して返す |
| DataLoader パターン | GraphQL の DataLoader / Next.js の cache() | リクエスト内でキーを集約し、バッチクエリに変換する |
Supabase を使う場合、PostgREST の埋め込みクエリ(select("*, translations(*)"))を活用すれば、アプリ側でループを書かずに 1 リクエストで関連データまで取得できる。
開発段階で N+1 を見つけるには、クエリログの監視が有効だ。PostgreSQL なら log_min_duration_statement を 0 に設定して全クエリをログに出し、同一パターンのクエリが連続していないか確認する。Rails には bullet gem、Django には django-debug-toolbar といった検出ツールもある。
コードレビューの段階で「ループ内に await が入っていないか」を意識するだけでも、かなりの N+1 を未然に防げる。


PEFT(パラメータ効率型ファインチューニング)とは?AI モデルカスタマイズのコストを 90% 削減する技術
マルチステップ推論とは、LLM が1回の応答生成ではなく、複数の中間ステップ(サブ質問の生成、部分回答の検証、追加情報の取得など)を経て最終回答に到達する推論方式である。