N+1クエリ問題
えぬぷらすわんくえり

N+1クエリ問題とは、一覧データを1回のクエリで取得した後、各レコードの関連データを1件ずつ個別にクエリする結果、合計 N+1 回のデータベースアクセスが発生してしまうパフォーマンス上のアンチパターンである。
N+1 の「N」と「1」
ORM(Object-Relational Mapping)やクエリビルダを使っていると、意識しないうちにこの問題を踏むことが多い。流れはこうだ。
- 親テーブルから一覧を取得する — これが「1」にあたるクエリ
- 取得した N 件それぞれについて、子テーブルへ関連データを問い合わせる — これが「N」回のクエリ
たとえば用語集の一覧ページを表示するケースを考える。まず 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 を未然に防げる。
この用語を扱う記事
関連用語

E2Eテスト
E2E テスト(End-to-End テスト)とは、ユーザーの操作を起点にブラウザや API を通じてシステム全体を通過させ、期待どおりの結果が得られるかを検証するテスト手法である。

受け入れテスト
受け入れテスト(アクセプタンステスト)とは、開発した機能がビジネス要件やユーザーストーリーを満たしているかを、プロダクトオーナーやステークホルダーの視点で検証するテスト手法である。

SSM(AWS Systems Manager)
AWS Systems Manager(SSM)とは、EC2 インスタンスやオンプレミスサーバーをまとめて運用・管理するための AWS マネージドサービスである。パッチ適用、コマンド実行、パラメータ管

ATDD
ATDD(Acceptance Test-Driven Development)とは、開発着手前に受け入れテストの基準をチーム全体で定義し、そのテストを自動化してから実装を進める開発手法である。

