EXPLAIN query は PostgreSQL がクエリに選んだ実行計画を表示します。推定のコストと行数を持つステップ (ノード) のツリーです。EXPLAIN ANALYZE query はさらにクエリを実行し、各ノードの実際の時間、行数、ループ回数を加えます。ツリーはいちばん深くインデントされたノードから外へ向かって読みます。内側のノードが上のノードに行を渡します。
email にインデックスがないので、実行計画は Seq Scan です。PostgreSQL はすべての行を読み、Filter を通る行を残します。Rows Removed by Filter が無駄になった作業を示します。時間は実行するたびに変わります。数値よりも実行計画の形のほうが大切です。
実行計画の1行を読む
各ノードは次の形の行を出力します。
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| 部分 | 意味 |
|---|---|
cost=STARTUP..TOTAL | 最初の行までの推定作業量と、全行の推定作業量。単位はプランナーの単位 (ミリ秒ではない) |
rows (1つ目) | ノードが返す推定行数 |
width | 1行の推定平均サイズ (バイト) |
actual time | 最初の行と最後の行までのミリ秒。ループ1回あたり |
rows (実際) | 返した行数。ループ1回あたり |
loops | ノードが実行された回数。時間と行数にこれを掛ける |
親のコストには子のコストが含まれます。末尾の Planning Time と Execution Time は文全体の合計です。
よく出るノードを見分ける
EXPLAIN (COSTS OFF) は数値を隠すので、実行計画の形が見やすくなります。
内側から読みます。両方のテーブルがスキャンされ、絞り込んだ顧客が Hash に入ります。Hash Join は各注文でそれを照合し、いちばん上の GroupAggregate が結果を数えます。よく出会うノードは次のとおりです。
| ノード | 何をするか |
|---|---|
Seq Scan | テーブル全体を読む |
Index Scan | インデックスで行を探し、各行をテーブルから読む |
Index Only Scan | テーブルを見に行かず、インデックスだけで答える |
Bitmap Index Scan + Bitmap Heap Scan | インデックスから一致する行の位置を集め、テーブルの順に読む |
Nested Loop | 外側の各行について内側の入力から一致を探す。外側が小さいときに向く |
Hash Join + Hash | 一方の入力からハッシュテーブルを作り、もう一方で照合する |
Merge Join | 結合キーですでに並んだ2つの入力を結合する |
Sort, Incremental Sort | ORDER BY、DISTINCT、マージ結合のために行を並べ替える |
HashAggregate, GroupAggregate | ハッシュテーブル、または並べ替えた入力による GROUP BY |
Limit | N 行で止める |
Gather | パラレルワーカーから行を集める |
行数の見積もり違いを見つける
EXPLAIN ANALYZE でいちばん役立つ確認は、同じノードの推定 rows と実際の rows の比較です。大きく離れているなら、プランナーは間違った数値で計画を選んでいます。統計情報がない、または古いことがよくある原因です。
スキャンが返す実際の行は 10 ですが、テーブルがまだ分析されていないので推定はずっと多くなります。EXPLAIN の前に ANALYZE tasks; を加えると、推定が 10 に近づきます。autovacuum はバックグラウンドでテーブルを分析しますが、大量にロードした後は自分で ANALYZE を実行します (VACUUM と autovacuum を参照)。
データの変更を残さずに EXPLAIN する
EXPLAIN ANALYZE は文を実行するので、UPDATE や DELETE は行を変更します。トランザクションで包んでロールバックします。
ロールバックの後も 1000 行すべてが残っています。
BUFFERS などのオプションで I/O を見る
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
BUFFERS は I/O を表示します。read のページが多いノードはディスクを読みに行っています。PostgreSQL 17 では SERIALIZE (出力行をテキストに変換するコスト) と MEMORY (プランナーのメモリ) が加わりました。公式の EXPLAIN ガイド でさらに多くの実行計画を解説しています。
プランナーの設定で実行計画を試す
ある方式を使わなかったら PostgreSQL がどの実行計画を選ぶかを見るには、セッションでその方式をオフにします。実験のときだけにして、本番のコードでは決して使わないでください。
100 行ではプランナーは Seq Scan を選びますが、enable_seqscan = off にすると実行計画は Index Scan using items_pkey になります。2つの EXPLAIN ANALYZE の時間を比べれば、インデックスが役立つかどうかがわかります。RESET enable_seqscan; でデフォルトに戻ります。
よくある質問
EXPLAIN と EXPLAIN ANALYZE の違いは何ですか?
EXPLAIN はクエリの計画を立てて推定値を表示するだけです。EXPLAIN ANALYZE はクエリを実際に実行し、各ノードの実際の時間、行数、ループ回数を加えます。そのため、クエリそのものと同じだけ時間がかかります。
PostgreSQL の実行計画の cost は何を意味しますか?
cost はプランナーによる推定値で、単位は任意です。1ページをシーケンシャルに読むコストが 1 (seq_page_cost) になるように調整されています。同じクエリの実行計画を比べるのに役立ちますが、ミリ秒の時間ではありません。
EXPLAIN ANALYZE はデータを変更しますか?
はい。INSERT、UPDATE、DELETE、MERGE では実際に変更を行います。結果を残さずに測るには、BEGIN と ROLLBACK の間で実行します。
インデックスがあるのに Seq Scan が選ばれるのはなぜですか?
プランナーがそのほうが安いと見積もったからです。テーブルが小さい、クエリが行の大部分を返す、条件がインデックスを使えない形になっている、などの理由があります。古い統計情報がプランナーを誤らせることもあり、その場合は ANALYZE で直ります。