【テクニカル・上級編】 maintenance_work_mem – PostgreSQL

「なぜかインデックス作成が終わらない」を解消する：`maintenance_work_mem` を極める

PostgreSQLを長年運用していると、避けては通れない瞬間があります。数千万行、あるいは数億行のテーブルに対して`CREATE INDEX`を実行し、プログレスバーがいつまで経っても進まない――。そんな時、多くのエンジニアが真っ先に疑うのはディスクI/OやCPU負荷ですが、実はその背後に潜む「メモリ設定の罠」に気づいている人は意外と多くありません。

今回は、PostgreSQLのパフォーマンスチューニングにおいて最も過小評価されがちなパラメータの一つ、`maintenance_work_mem`について深掘りしていきましょう。

メンテナンス処理の「作業机」としての役割

まず、このパラメータの立ち位置を整理しておきましょう。`work_mem`がクエリ実行時のソートやハッシュ結合に使われる「個別のデスク」だとしたら、`maintenance_work_mem`はVACUUM、`CREATE INDEX`、`ALTER TABLE ADD FOREIGN KEY`といった、いわゆる「重いメンテナンス作業」専用の広大なワークスペースです。

内部的な話をすると、例えばB-treeインデックスを構築する際、PostgreSQLはメモリ上でソート済みタプルの塊（Run）を作成し、それをディスクに書き出し、後にマージしていくという工程を踏みます。ここで`maintenance_work_mem`が小さすぎると、メモリに収まりきらないデータの溢れ出し（Spill）が頻発し、OSのI/Oサブシステムが悲鳴を上げることになります。

なぜデフォルト値はこれほど控えめなのか？

PostgreSQLのデフォルト設定（64MB）は、正直に言って現代のサーバー環境では少なすぎます。「全環境で安全に動く」ことを優先した設計ゆえですが、本番環境でこのまま運用するのは、高性能なスポーツカーで時速30km制限の道路を走るようなものです。

実務レベルでは、「メモリに余裕があるなら、インデックス構築のために数GB単位で割り当てる」という発想が必要です。

パフォーマンストラブルシューティングの視点

インデックス構築が遅いと相談を受けた際、私がまず確認するのは`pg_stat_activity`ではなく、まずはそのセッションで`maintenance_work_mem`がどう設定されているかです。

もしあなたがインデックスの作成時間を劇的に短縮したいなら、以下の手順を試してみてください。

1. 一時的な引き上げ: `SET maintenance_work_mem = ‘2GB’;` のように、トランザクション単位で値を大きくする。
2. 実行計画の観察: `EXPLAIN (ANALYZE, VERBOSE)`で実際のメモリ使用量やI/O負荷を確認する。
3. 並列度の調整: Postgres 11以降であれば、`CREATE INDEX`の`PARALLEL`オプションと組み合わせるのが定石です。ただし、注意してください。`maintenance_work_mem`はワーカープロセスごとに割り当てられるため、並列度を高くしすぎるとメモリが枯渇し、かえってOOM Killerの標的になるリスクがあります。

「メモリ不足」の境界線を見極める

ここがエンジニアとしての腕の見せ所です。単純に大きくすればいいというわけではありません。

VACUUMの最適化: `autovacuum_work_mem`（これが未設定なら`maintenance_work_mem`が使われます）が不十分だと、VACUUMは何度もスキャンを繰り返すことになります。大規模テーブルでは、ページマップを保持するために、この値を大きくすることがVACUUMの完遂時間を短縮する鍵となります。
メモリ・プレッシャーの監視: `vmstat`や`iostat`を眺めながら、インデックス作成中にディスクI/Oの待機が急増していないか確認してください。もしI/O待ちが発生しているなら、それはメモリが足りず、ディスクとのスワップが発生している証拠です。

最後に：エンジニアとしての心得

データベースのチューニングにおいて、魔法のような「万能な設定値」は存在しません。ある環境で1GBが最適でも、別の環境ではメモリ不足の原因になる。だからこそ、私たちは推測するのではなく、メトリクスを測定し、その内部挙動を想像しなければならないのです。

`maintenance_work_mem`を適切に制御することは、単にインデックスを速く作るだけではありません。運用コストを下げ、システム全体の安定性を高めるための「守りの投資」です。

あなたのデータベースが今日、少しでも快適に動くことを願っています。もしインデックス構築で苦戦しているプロジェクトがあれば、まずはこの数値を少しだけ大胆に引き上げてみてください。その「軽快さ」に、きっと驚くはずですから。