VACUUM は、UPDATE と DELETE がテーブルに残す古いコピー、つまり不要な行バージョンを取り除き、その領域を新しい行のための空き領域として記録します。VACUUM ANALYZE はさらにプランナーが使う統計情報を更新します。VACUUM FULL はテーブル全体を書き直し、領域をオペレーティングシステムに返します。デフォルトで有効な autovacuum が、VACUUM と ANALYZE をバックグラウンドで実行してくれます。
DELETE の後、テーブルには有効な行が 700、不要な行が 300 あります。VACUUM の後は不要な行が 0 です。統計ビューは少し遅れて更新されるので、このデモでは pg_stat_force_next_flush() (PostgreSQL 15 以降) ですぐに更新させています。
PostgreSQL が不要な行を残す理由
PostgreSQL は、すべてのトランザクションが一貫したスナップショットを見られるように、古い行バージョンを残しておきます (MVCC)。UPDATE は行の新しいバージョンを書き込み、古いものを期限切れとして印を付けます。DELETE は印を付けるだけです。古いバージョンは、実行中のどのトランザクションも必要としなくなるまで残り、そうなると VACUUM が取り除けます。行の物理的な位置を示す ctid を見ると、移動がわかります。
行 1 は最初 (0,1) (ページ 0、スロット 1) にあり、更新後は (0,3) に移ります。スロット 1 には、片付けられるまで古いバージョンが残っています。頻繁に更新されるテーブルは不要な行を生み続けるので、autovacuum は何度もそのテーブルに戻ってきます。
VACUUM と VACUUM FULL の違い
通常の VACUUM ではファイルのサイズは変わりません。空き領域は今後の挿入のためにテーブルの中に残ります。VACUUM FULL は詰めた新しいコピーを書き込み、古いファイルを捨てます。
VACUUM | VACUUM FULL | |
|---|---|---|
| ロック | 読み書きを許す | すべてのアクセスをブロックする |
| 領域 | 同じテーブルで再利用する | オペレーティングシステムに返す |
| 追加のディスク | 不要 | テーブル全体のコピー分が必要 |
| 使う場面 | 日常的に (autovacuum が実行する) | まれに。大きなテーブルの大半を削除した後 |
オプションは括弧の中に書きます。
VACUUM (VERBOSE, ANALYZE) items;は実行内容を表示し、統計情報を更新します。VACUUM (PARALLEL 4)(PostgreSQL 13 以降) はパラレルワーカーでインデックスを VACUUM します。VACUUM (SKIP_LOCKED)はすぐにロックできないテーブルを飛ばします。
autovacuum が実行のタイミングを決める仕組み
autovacuum は autovacuum_naptime ごとに各テーブルを確認します。不要な行が autovacuum_vacuum_threshold + autovacuum_vacuum_scale_factor * table rows を超えると、そのテーブルを VACUUM します。デフォルトでは 50 行とテーブルの 20 パーセントです。前回の分析以降に変わった行が 50 行と 10 パーセントを超えると、テーブルを分析します。PostgreSQL 13 以降は、挿入だけでも VACUUM のきっかけになります。postgresql.conf のデフォルト値は次のとおりです。
autovacuum = on
autovacuum_naptime = 1min
autovacuum_max_workers = 3
autovacuum_vacuum_threshold = 50
autovacuum_vacuum_scale_factor = 0.2
autovacuum_vacuum_insert_threshold = 1000
autovacuum_vacuum_insert_scale_factor = 0.2
autovacuum_analyze_threshold = 50
autovacuum_analyze_scale_factor = 0.1
1億行のテーブルでは、20 パーセントは VACUUM が始まるまでに不要な行が2000万行たまることを意味します。大きく更新の多いテーブルに限って、scale factor を下げます。
ALTER TABLE events RESET (autovacuum_vacuum_scale_factor); でテーブルをサーバー全体の設定に戻せます。残りの設定は 定常的な VACUUM の章 で解説されています。
autovacuum の実行状況を確認する
pg_stat_user_tables は、各テーブルの不要な行と、最後の手動および自動の VACUUM を表示します。
SELECT relname, n_live_tup, n_dead_tup, last_vacuum, last_autovacuum, last_autoanalyze
FROM pg_stat_user_tables
ORDER BY n_dead_tup DESC
LIMIT 10;
autovacuum が動いているのに不要な行が増え続けるなら、古い開いたままのトランザクションを探します。そうしたトランザクションがあると、そのスナップショットより新しいものは何も取り除けなくなります。
SELECT pid, state, xact_start, query
FROM pg_stat_activity
WHERE xact_start < now() - interval '10 minutes'
ORDER BY xact_start;
凍結とトランザクション ID の周回
トランザクション ID は 32 ビットのカウンターで、一周すると元に戻ります。古い行を見えるままにしておくため、VACUUM はそれらの行を凍結し、どのトランザクションよりも古いという印を付けます。テーブルの凍結されていない最も古い ID が autovacuum_freeze_max_age (デフォルトで2億トランザクション) を超えると、autovacuum がオフでもそのテーブルに対して実行されます。
それでも凍結が大きく遅れると、PostgreSQL は新しいトランザクション ID の割り当てをやめ、VACUUM が追いつくまで書き込みが失敗します。次のクエリで、各データベースがどれだけそこに近いかがわかります。
SELECT datname, age(datfrozenxid) FROM pg_database ORDER BY 2 DESC;
よくある質問
VACUUM はテーブルをロックしますか?
通常の VACUUM が取るロックは、SELECT、INSERT、UPDATE、DELETE を妨げません。衝突するのはスキーマの変更、インデックスの作成、ANALYZE、ほかの VACUUM だけです。VACUUM FULL は ACCESS EXCLUSIVE ロックを取り、終わるまでそのテーブルへのすべてのクエリをブロックします。
autovacuum はオフにすべきですか?
いいえ。autovacuum がないと不要な行がたまり、統計情報が古くなり、最終的にはトランザクション ID の周回を防ぐためにデータベースが書き込みを受け付けなくなります。オフにする代わりに、テーブルごとにしきい値を調整します。
VACUUM してもテーブルが小さくならないのはなぜですか?
通常の VACUUM は不要な行の領域を、同じテーブルの新しい行のための空き領域として記録します。オペレーティングシステムに領域を返すのは、空のページがファイルの末尾にあるときだけです。VACUUM FULL はテーブルを書き直し、領域を返します。
VACUUM が不要な行を削除しないのはなぜですか?
行を削除できるのは、実行中のどのトランザクションもその行を必要としなくなったときだけです。長く開いたままのトランザクション (よくあるのは BEGIN を実行したまま放置されたセッション)、古いレプリケーションスロット、放置された準備済みトランザクションが削除を止めます。