実行計画とは何か（なぜ DB が計画を立てるのか）

SQL は「何が欲しいか」しか書いていない

SQL にはどうやって取るかが書かれていません。 「この条件に合う行が欲しい」としか言っていないので、取り方はデータベースが決めます。

SELECT * FROM members WHERE city = 'city-7';

この 1 行に対して、少なくとも次の取り方があります。

• テーブルを先頭から最後まで読んで、条件に合う行だけ拾う
• city のインデックスを辿って、該当する行だけ取りに行く
• インデックスで該当行の位置を全部集めてから、ページ順にまとめて読む

どれも同じ結果を返します。違うのは速さだけです。 そして「どれが速いか」は、テーブルの行数や条件に合う行の割合で変わります。 だからデータベースは毎回見積もって選んでいます。

この「選んだ結果」が実行計画です。 選ぶ担当をオプティマイザ（プランナ）と呼びます。

EXPLAIN で見る

クエリの先頭に EXPLAIN を付けると、選ばれた計画が返ってきます。

ただし EXPLAIN だけだと見積りしか返りません。実測値も欲しいので、最初から EXPLAIN (ANALYZE) で打ちます。 こちらは実際にクエリを実行して、かかった時間と返った行数も返します。

EXPLAIN (ANALYZE)
SELECT m.name, o.amount
FROM members m
JOIN orders_s o ON o.member_id = m.id
WHERE m.id = 42;

 Nested Loop  (cost=0.85..28.26 rows=4 width=17) (actual time=0.041..0.051 rows=4.00 loops=1)
   ->  Index Scan using members_pkey on members m  (cost=0.42..8.44 rows=1 width=17) (actual time=0.022..0.022 rows=1.00 loops=1)
         Index Cond: (id = 42)
         Index Searches: 1
   ->  Index Scan using orders_s_member_idx on orders_s o  (cost=0.43..19.78 rows=4 width=8) (actual time=0.017..0.024 rows=4.00 loops=1)
         Index Cond: (member_id = 42)
         Index Searches: 1
 Planning Time: 0.311 ms
 Execution Time: 0.099 ms

いまはまだ読めなくて構いません。読む順番とcost と rows の意味を押さえれば読めます。

どこで打つか

psql（コマンドライン）

そのまま打てます。長い計画は折り返されて読みにくいので、\pset pager off にしておくと扱いやすくなります。

GUI クライアント（pgAdmin / DBeaver / TablePlus など）

クエリの実行ボタンとは別に「実行計画」のボタンがあることが多いです。テキストで見たい場合は、素直に EXPLAIN を付けて普通に実行するのが 確実です。ツールの独自ビューは見やすい代わりに、 この先で扱う loops や Rows Removed by Filter が 隠れていることがあります。

ORM 経由

• まず生成された SQL を出す。ログ出力やデバッグモードで確認できます
• その SQL をクライアントに貼って EXPLAIN を付ける
• プレースホルダ（$1 など）が残っている場合は、実際の値を入れて打ちます。値によって計画が変わることがあるので、 本番で問題になっている値をそのまま使うのが大事です

次に読むもの

計画の読む順番から始めるのが最短です。 木構造だと知らないまま数字を追っても、どこから見ればいいのか分からないためです。