一つの画面に何回問い合わせるか
N+1問題は、一覧を取る一回の問い合わせに続き、各要素の関連情報を一回ずつ取得することで、問い合わせ数が要素数に応じて増える構造です。一つ一つのSQLが速くても、往復回数の多さで全体が遅くなる場合があります。
ORMを使っているかどうかだけでは判定できません。明示的なループ内のSQLでも発生します。調査単位をSQL一文だけにせず、一つの画面やAPI要求が発行したSQLのまとまりとして数えます。
100件の注文一覧の例
100件の注文を取得し、それぞれの顧客名を別SQLで取得すると、単純な例では合計101回の問い合わせになります。10件の画面では気付きにくくても、件数が増えると通信待ちが積み上がります。
関連データをJOINで一度に取る、必要な顧客IDを集めてまとめて問い合わせる、といった変更が候補です。同じ顧客が複数の注文に登場する場合は、重複した取得も減らせます。必要な列と件数を先に整理します。
一回にまとめる副作用
JOINで一対多の関連を広げると、同じ親の情報が複数行に重複することがあります。複数の一対多を同時に結合すれば、行数が大きく増える場合もあります。問い合わせ回数だけを最小化するのではなく、返る行数と通信量も測ります。
まとめ取りをする場合も、大きすぎるIDの集合や、一覧のページングとの関係に注意します。関連先の件数が偏る実データを含めて、単純な平均だけでは見えない増幅を確認します。
実行計画と要求全体を両方見る
修正前後で、同じ件数・同じデータを使い、SQL回数、合計DB時間、API全体の待ち時間を比較します。生成されたSQLの実行計画も確認し、まとめた結果として全表走査などが増えていないかを調べます。
この問題はキャッシュで一時的に隠れることもあります。温まったキャッシュだけで測らず、新しい関連データや一覧件数の増加も試します。回数の増え方そのものを検査すると、将来の機能追加での再発を見つけやすくなります。