PostgreSQL vacuumdbを使ったフルバキューム実行とデータベース一括クリーンアップ手順

この記事のポイント

・vacuumdbはVACUUM SQLをCLIから実行するPostgreSQL付属のコマンド
・--fullオプションでテーブルを書き直し、OS側にディスク領域を返却できる
・--allで全データベースを一括クリーンアップし、メンテナンスを効率化できる
・--jobs=Nで複数テーブルを並列処理し、大規模DBの処理時間を短縮できる

# PostgreSQLに接続してデッドタプル量を確認する
sudo -u postgres psql -d mydb -c "
SELECT
  relname,
  n_live_tup,
  n_dead_tup,
  round(n_dead_tup::numeric / NULLIF(n_live_tup + n_dead_tup, 0) * 100, 1) AS dead_pct,
  last_vacuum,
  last_autovacuum
FROM pg_stat_user_tables
WHERE n_dead_tup > 1000
ORDER BY n_dead_tup DESC
LIMIT 10;"

   relname    | n_live_tup | n_dead_tup | dead_pct |       last_vacuum        |      last_autovacuum
--------------+------------+------------+----------+--------------------------+----------------------------
 orders       |     312041 |      87432 |     21.9 | 2026-09-14 03:00:02+09   | 2026-09-15 01:22:15+09
 access_logs  |    1204550 |      34218 |      2.8 |                          | 2026-09-15 00:15:42+09
 sessions     |      42100 |      12890 |     23.4 |                          | 2026-09-14 23:48:10+09
(3 rows)

# テーブルサイズを確認する（FULL VACUUM前後の比較用）
sudo -u postgres psql -d mydb -c "
SELECT
  relname,
  pg_size_pretty(pg_relation_size(relid)) AS table_size,
  pg_size_pretty(pg_total_relation_size(relid)) AS total_size
FROM pg_stat_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 10;"

# postgresユーザーに切り替え
sudo -u postgres vacuumdb mydb

# または sudo -u postgres を毎回付ける形でも可
sudo -u postgres vacuumdb --verbose mydb

INFO:  vacuuming "public.orders"
INFO:  scanned index "orders_pkey" to remove 87432 row versions
INFO:  "orders": removed 87432 row versions in 10929 pages
DETAIL:  CPU: user: 1.23 s, system: 0.08 s, elapsed: 3.41 s
INFO:  "orders": found 87432 removable, 312041 nonremovable row versions in 19854 of 19854 pages
DETAIL:  0 dead row versions cannot be removed yet, oldest xmin: 4290123
INFO:  vacuuming "public.access_logs"
...
vacuumdb: vacuuming database "mydb"

# VACUUMとANALYZEを同時実行
sudo -u postgres vacuumdb --analyze --verbose mydb

# 特定テーブルだけ対象にする場合
sudo -u postgres vacuumdb --analyze --table=orders mydb

# 全データベースをVACUUM + ANALYZE
sudo -u postgres vacuumdb --all --analyze --verbose

# FULLバキュームを実行（実行前にordersテーブルがロックされることに注意）
sudo -u postgres vacuumdb --full --analyze --verbose --table=orders mydb

# FULL VACUUM前のサイズ確認
sudo -u postgres psql -d mydb -c   "SELECT pg_size_pretty(pg_relation_size('orders'));"
 pg_size_pretty
----------------
 3721 MB

# vacuumdb --full 実行後（数分後）
sudo -u postgres psql -d mydb -c   "SELECT pg_size_pretty(pg_relation_size('orders'));"
 pg_size_pretty
----------------
 2108 MB

# データベースごとのXID周回余裕を確認
sudo -u postgres psql -c "
SELECT datname,
       age(datfrozenxid) AS xid_age,
       2100000000 - age(datfrozenxid) AS xid_remaining
FROM pg_database
ORDER BY age(datfrozenxid) DESC;"

   datname   |  xid_age  | xid_remaining
-------------+-----------+---------------
 mydb        | 801234567 |   1298765433
 template1   |  45678901 |   2054321099
 postgres    |  45678890 |   2054321110

# 強制フリーズを実行（全DB対象）
sudo -u postgres vacuumdb --all --freeze --verbose

# 4つの接続を並列で使ってVACUUMを実行
sudo -u postgres vacuumdb --jobs=4 --analyze --verbose mydb

# 現在の接続数とmax_connectionsを確認
sudo -u postgres psql -c   "SELECT count(*) AS current_conn,
          (SELECT setting::int FROM pg_settings WHERE name='max_connections') AS max_conn
   FROM pg_stat_activity;"
 current_conn | max_conn
--------------+----------
           42 |      100

# /etc/cron.d/postgresql-vacuumdb（postgresユーザーで実行）
# 毎週日曜3:00にFULL VACUUM + ANALYZE（全DB）
0 3 * * 0 postgres /usr/bin/vacuumdb --all --analyze --verbose 2>&1 | logger -t vacuumdb

# 毎日2:00に通常VACUUM + ANALYZE（mydbのみ）
0 2 * * * postgres /usr/bin/vacuumdb --analyze mydb 2>&1 | logger -t vacuumdb

# vacuumdbのcron実行ログを確認する
journalctl -t vacuumdb --since "2026-10-05 02:00:00" --until "2026-10-05 04:00:00"

# FULLの前にautovacuumを一時停止する（postgresqlの設定変数を確認）
sudo -u postgres psql -d mydb -c "SET autovacuum = off;"

# この方法はセッションローカルのみ有効。DBレベルで止める場合
sudo -u postgres psql -c   "ALTER SYSTEM SET autovacuum = off;"
sudo -u postgres psql -c "SELECT pg_reload_conf();"

# vacuumdb実行後に必ず戻す
sudo -u postgres psql -c   "ALTER SYSTEM SET autovacuum = on;"
sudo -u postgres psql -c "SELECT pg_reload_conf();"

# エラーメッセージ例
vacuumdb: error: too many parallel jobs requested (10), maximum is 58

# 解決策: jobsの数をmax_connections残余以内に収める
sudo -u postgres vacuumdb --jobs=4 --analyze mydb

# NG: rootで直接実行する
root# vacuumdb mydb
vacuumdb: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed:
FATAL:  role "root" does not exist

# OK: postgresユーザーに切り替えてから実行する
root# sudo -u postgres vacuumdb mydb

# vacuumdbの進捗を確認する（PostgreSQL 9.6以降）
sudo -u postgres psql -c "
SELECT relid::regclass AS table_name,
       phase,
       heap_blks_scanned,
       heap_blks_total,
       round(heap_blks_scanned::numeric / NULLIF(heap_blks_total, 0) * 100, 1) AS pct
FROM pg_stat_progress_vacuum;"

      table_name      |       phase        | heap_blks_scanned | heap_blks_total |  pct
----------------------+--------------------+-------------------+-----------------+-------
 public.orders        | vacuuming heap     |             34512 |           47684 |  72.4