【入門編】 pg_stat_statementsモジュール – PostgreSQL

PostgreSQLの「裏方さん」pg_stat_statementsで、データベースの「隠れた才能」を見つけよう！

皆さん、こんにちは！ PostgreSQLの世界へようこそ。普段、データベースを触っていると「このクエリ、なんでこんなに遅いんだろう？」とか「もっと効率よくできないかな？」って、ふと疑問に思うこと、ありますよね。

今日は、そんな悩みを解決してくれる、PostgreSQLの「縁の下の力持ち」とも言える、とっても便利な拡張機能「pg_stat_statements」について、IT初心者の方にも分かりやすく、日常の出来事に例えながらお話ししていきたいと思います。

pg_stat_statementsって、一体何者？

例えるなら、pg_stat_statementsは、お店の「レジ」や「キッチン」で、どんな注文がどれくらいの頻度で来て、どれくらいの時間がかかっているかを、こっそり記録している「記録係」さんみたいなものです。

お店で、

「このメニュー、最近よく注文されるな！」
「あの料理、作るのにいつも時間がかかってるな…」
「あ、このお客さん、いつも同じものを頼むな！」

なんてことが分かると、お店側も「このメニューを特におすすめしよう！」とか「あの料理の作り方を工夫しよう！」とか、改善策を考えられますよね。

pg_stat_statementsも、これと同じなんです。PostgreSQLの中で、実行されたすべてのSQL文（データベースへの命令）を、まるで「注文」のように、その数がどれくらいか、どれくらいの時間がかかっているか、といった詳細な情報を記録してくれるんです。

なんでpg_stat_statementsがそんなに便利なの？

「ふーん、記録してくれるのは分かったけど、それがどうしたの？」って思われたかもしれませんね。でも、この「記録」が、実はデータベースのパフォーマンスを改善する上で、とっても強力な武器になるんです！

具体的に、どんな情報が記録されるか見てみましょう。

実行回数 (calls): そのSQL文が、どれだけたくさん実行されたか。
例えるなら、「このメニューは、1日に何回注文されたか」という記録。よく出るメニューは、人気がある証拠ですよね。
合計実行時間 (total_time): そのSQL文が、実行されるのにかかった時間の合計。
例えるなら、「このメニューは、注文されてから提供されるまでの合計時間がどれくらいか」という記録。時間がかかりすぎているメニューは、改善の余地がありそうです。
平均実行時間 (mean_time): 合計実行時間を実行回数で割ったもの。
例えるなら、「このメニューは、平均してどれくらいの時間で提供されるか」という記録。
共有バッファヒット率 (shared_blks_hit_ratio): データベースがデータを読み込む際に、すでにメモリ（キャッシュ）に載っているデータ（ヒット）をどれだけ利用できたかを示す割合。
これはちょっと専門的になりますが、例えるなら、「冷蔵庫からすぐに取り出せる食材（ヒット）と、わざわざ買い出しに行かなければならない食材（ミス）の割合」みたいなイメージです。冷蔵庫からすぐ出せるものが多いほど、効率が良いですよね！

これらの情報を見ることで、

「このSQL文、ものすごくたくさん実行されているのに、一つ一つの実行に時間がかかってる…」
「このSQL文は、そんなに実行されていないけど、実行されるたびにすごく時間がかかってる…」
「このSQL文、ほとんどキャッシュに当たってないな…」

といった、データベースの「隠れた才能」や「改善すべき点」が、まるで宝探しのように見つけ出せるんです！

どうやってpg_stat_statementsを使ってみるの？

使い方は、実はとっても簡単なんです。

1. まず、拡張機能を有効にする:
PostgreSQLの設定ファイル（`postgresql.conf`）に、いくつか設定を追加して、PostgreSQLを再起動するだけでOK！

shared_preload_libraries = ‘pg_stat_statements’
pg_stat_statements.track = all

（※これはあくまで例です。詳しい設定方法は、公式ドキュメントなどを参考にしてくださいね！）

2. データベースにpg_stat_statementsのテーブルを作る:
SQLで簡単なコマンドを実行するだけで、統計情報を記録するための「棚」が用意されます。

CREATE EXTENSION pg_stat_statements;

これで準備は完了！あとは、普段通りにデータベースを使っていれば、pg_stat_statementsが自動的にSQL文の実行情報を記録し始めてくれます。

記録された情報を見てみよう！

では、記録された情報はどこで見られるのでしょうか？それは、`pg_stat_statements` という名前の「ビュー」で確認できます。ビューというのは、実際のデータが保存されているわけではなく、必要な時に他のテーブルから情報を引っ張ってきて見せてくれる、便利な「窓」のようなものです。

例えば、こんなSQL文で、実行回数が多い順にSQL文を見てみることができます。

SELECT
query,
calls,
total_time,
round(total_time / calls, 2) AS mean_time,
round(shared_blks_hit::numeric / nullif(shared_blks_hit + shared_blks_read, 0) 100, 2) AS shared_blks_hit_ratio
FROM
pg_stat_statements
ORDER BY
calls DESC
LIMIT 10;

この結果を見れば、「あれ？このSQL、こんなにたくさん実行されてるんだ。ちょっと見直してみようかな」とか、「このSQL、意外と時間がかかってるな。インデックスとか見直してみようか」といった、具体的な改善のヒントがきっと見つかるはずです。

まとめ：pg_stat_statementsは、あなたのデータベースの「賢い秘書」！

pg_stat_statementsは、データベースのパフォーマンスチューニングにおいて、まるで「賢い秘書」のように、隠れた問題点や改善のチャンスを教えてくれます。

「SQL文の実行時間」や「バッファヒット率」といった専門用語に少し戸惑うかもしれませんが、まずは「記録係さん」や「冷蔵庫の食材」といった例えを思い出しながら、どんな情報が記録されているのか、そしてそれがどう役立つのかをイメージしてみてください。

この「pg_stat_statements」、ぜひ皆さんのPostgreSQL環境でも試してみてくださいね。きっと、データベースの「隠れた才能」を発見するお手伝いをしてくれるはずです！

もし、「ここがよく分からないな」「もっと詳しく知りたいな」という点があれば、気軽にコメントなどで教えてくださいね。皆さんと一緒に、PostgreSQLの世界をさらに楽しんでいけたら嬉しいです！