障害・アンチパターン図鑑 · 基礎から応用へ

N+1問題:一覧表示で問い合わせが増える

一覧の件数に応じてDB往復が増える構造を、実行計画の遅さと区別します。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 一つの画面に何回問い合わせるか
  2. 100件の注文一覧の例
  3. 一回にまとめる副作用
  4. 実行計画と要求全体を両方見る
  5. この記事をロゲイアに質問する理解を確かめる

一つの画面に何回問い合わせるか

N+1問題は、一覧を取る一回の問い合わせに続き、各要素の関連情報を一回ずつ取得することで、問い合わせ数が要素数に応じて増える構造です。一つ一つのSQLが速くても、往復回数の多さで全体が遅くなる場合があります。

ORMを使っているかどうかだけでは判定できません。明示的なループ内のSQLでも発生します。調査単位をSQL一文だけにせず、一つの画面やAPI要求が発行したSQLのまとまりとして数えます。

100件の注文一覧の例

100件の注文を取得し、それぞれの顧客名を別SQLで取得すると、単純な例では合計101回の問い合わせになります。10件の画面では気付きにくくても、件数が増えると通信待ちが積み上がります。

関連データをJOINで一度に取る、必要な顧客IDを集めてまとめて問い合わせる、といった変更が候補です。同じ顧客が複数の注文に登場する場合は、重複した取得も減らせます。必要な列と件数を先に整理します。

一回にまとめる副作用

JOINで一対多の関連を広げると、同じ親の情報が複数行に重複することがあります。複数の一対多を同時に結合すれば、行数が大きく増える場合もあります。問い合わせ回数だけを最小化するのではなく、返る行数と通信量も測ります。

まとめ取りをする場合も、大きすぎるIDの集合や、一覧のページングとの関係に注意します。関連先の件数が偏る実データを含めて、単純な平均だけでは見えない増幅を確認します。

実行計画と要求全体を両方見る

修正前後で、同じ件数・同じデータを使い、SQL回数、合計DB時間、API全体の待ち時間を比較します。生成されたSQLの実行計画も確認し、まとめた結果として全表走査などが増えていないかを調べます。

この問題はキャッシュで一時的に隠れることもあります。温まったキャッシュだけで測らず、新しい関連データや一覧件数の増加も試します。回数の増え方そのものを検査すると、将来の機能追加での再発を見つけやすくなります。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 12

学習コースから次を選ぶ