DataGripでPostgreSQLの「Explain Analyze」を極める：SQLの「なぜ遅い？」を論理的に解き明かす極意
こんにちは。現場で泥臭くパフォーマンスチューニングを繰り返していると、「なんとなく遅いクエリ」を直感で直すことの限界に突き当たります。
PostgreSQLにおける `EXPLAIN ANALYZE` は、データベースの心臓部が見せる「本当の姿」です。しかし、テキストの羅列を見るだけで満足していませんか？今日は、最強のDBクライアント「DataGrip」を使い、実行計画をJSONとして抽出し、ボトルネックを一撃で特定するプロの作法を伝授します。
—
1. なぜ「Explain Analyze」をJSONで見るのか？
通常の `EXPLAIN ANALYZE` を実行すると、テキスト形式の結果が返ってきますよね。あれは人間が読むには少し不親切です。
一方、JSON形式で出力すると、各ノードの処理時間、メモリ使用量、行数などが構造化データとして手に入ります。DataGripの強力な分析機能は、このJSONを食わせることで、「どこで時間が溶けているか」を視覚的に浮き彫りにしてくれるのです。
—
2. 最初のセットアップ：DataGripで「魔法」の準備
まずは、PostgreSQLとDataGripを繋ぎましょう。
1. データソース接続: DataGrip右側の「Database」タブ → `+` アイコン → `Data Source` → `PostgreSQL` を選択。
2. ドライバのインストール: 画面下部に「Download missing driver files」と出たらクリック。これだけで準備完了です。
3. 動作確認 (Hello World):
適当なテーブルに対して以下のクエリを実行し、結果が返ることを確認しましょう。
— 自分の環境に合わせてテーブル名を変更してください
SELECT FROM users LIMIT 10;
これが動けば、あなたの武器は研ぎ澄まされました。
—
3. JSON形式で実行計画を叩き出す
さあ、ここからが本番です。クエリの前に `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)` を付けます。
EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)
SELECT u.name, o.amount
FROM users u
JOIN orders o ON u.id = o.user_id
WHERE u.created_at > ‘2023-01-01’
ORDER BY o.amount DESC;
- ANALYZE: 実際にクエリを実行して実測値を計測します。
- BUFFERS: ディスクI/Oだけでなく、メモリ（共有バッファ）のヒット状況まで分かります。これが「真のボトルネック」を突き止める鍵です。
- FORMAT JSON: DataGripの視覚化エンジンに渡すための必須フォーマットです。
—
4. DataGripの「視覚化」でボトルネックを特定する
実行すると、結果ウィンドウにJSONのテキストが表示されます。ここからが「伝説のエンジニア」の読み方です。
① 「Explain Plan」タブを開く
結果ウィンドウの左上にあるアイコン群の中に、「Explain Plan」（虫眼鏡のようなアイコン）があります。これをクリックしてください。
② 観察すべき「3つの鉄則」
視覚化されたツリーが表示されたら、以下のポイントを重点的に見てください。
1. 「Actual Total Time」の乖離:
親ノードと子ノードの処理時間の差が極端に大きい箇所を探します。そこが「時間を食っている犯人」です。
2. 「Rows Removed by Filter」:
フィルタリング（WHERE句）で大量の行を捨てていませんか？インデックスが効いていない証拠です。
3. 「Shared Hit/Read」の比率:
`Read` が多い箇所はディスクI/Oが発生しています。キャッシュに乗るようにインデックス戦略を見直すサインです。
—
5. 現場で震えるほど役立つ「深掘り」の極意
初心者が陥りがちなのが「実行計画を眺めるだけで満足する」ことです。私が現場で必ずやるのは、「コストの大きいノードを特定し、インデックスを貼る前後で計画を比較すること」です。
- Hash Join が重い場合: 結合キーに適切なインデックスがあるか？
- Seq Scan が発生している場合: そもそもそのテーブルにインデックスが必要か？あるいは統計情報（ANALYZEコマンド）が古くないか？
DataGripなら、実行計画を保存して、別のインデックスを貼った後の計画と比較（Compare）することも可能です。
—
まとめ：あなたは今日から「勘」でチューニングしない
「なんとなくSQLが遅い」と悩む時間は、もう終わりにしましょう。
1. JSON形式で詳細な実行計画を吐き出す。
2. DataGripの視覚化ツールで「Actual Time」が跳ねているノードを見つける。
3. Buffersを確認し、I/O負荷を特定する。
このサイクルを回すだけで、あなたのデータベース運用レベルは確実に一段上がります。ツールに頼ることは、決して「楽をすること」ではありません。「本質的な課題に集中するための賢い選択」なのです。
ぜひ次のメンテナンス作業で試してみてください。驚くほど視界がクリアになりますよ。