Menu

PostgreSQL EXPLAIN ANALYZE:実行計画の読み方

EXPLAIN は PostgreSQL がクエリに選んだ実行計画を表示し、EXPLAIN ANALYZE はクエリを実行して各ステップの実際の行数と時間を加えます。計画ツリーの読み方とよく出るノード名を覚えましょう。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

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つ目)ノードが返す推定行数
width1行の推定平均サイズ (バイト)
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 SortORDER BY、DISTINCT、マージ結合のために行を並べ替える
HashAggregate, GroupAggregateハッシュテーブル、または並べ替えた入力による GROUP BY
LimitN 行で止める
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 で直ります。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める