GINインデックスの「更新が遅い」問題、その正体と付き合い方
PostgreSQLで全文検索やJSONBをバリバリ使っていると、避けて通れないのが「GIN（Generalized Inverted Index）インデックス」の更新コスト問題です。
「データを入れるたびに検索が止まる」とか「インデックスの更新が追いつかなくて書き込みが詰まる」なんて経験、一度はありませんか？
今回は、GINインデックスがなぜ重くなりがちなのか、そして現場でどうやってその重さと付き合っていくべきか、僕なりの知見を共有します。教科書には載っていない「肌感覚」の話も交えていくので、ぜひ最後まで付き合ってください。
—
GINインデックスは「究極の遅刻魔」？
まず、GINインデックスがなぜ重いのか。それは構造を見れば一目瞭然です。GINは「逆引き辞書」みたいなもので、一つの値を更新しようとすると、その値が関連する大量のインデックスエントリをツリー構造の中で書き換えなきゃいけない。
これを毎回律儀にやっていたら、書き込み処理はたまったもんじゃありません。
そこでPostgreSQLは、ある工夫をしました。それが「Pending List（保留リスト）」です。
Pending Listの仕組み
書き込みが発生したとき、PostgreSQLはすぐにツリーを更新するのではなく、とりあえず「Pending List」という一時的な領域に突っ込みます。これが「書き込みが速い」理由です。
しかし、このリストが膨れ上がるとどうなるか。
検索時にPostgreSQLは、メインのインデックスだけでなく、この「溜まりに溜まったPending List」もスキャンしてマージしなきゃいけなくなります。結果、「書き込みは速いけど、検索が地獄のように遅くなる」という本末転倒な状況が生まれるわけです。
—
実践：Pending Listと仲良くする方法
この問題を解決するには、「溜まったPending Listを適切なタイミングでインデックス本体にマージ（掃除）してやる」ことが不可欠です。
1. 設定値（fastupdate）の検討
まずは、そもそもPending Listを使うかどうかを考えましょう。
— GINインデックス作成時
CREATE INDEX idx_mytable_data ON mytable USING GIN (data_column) WITH (fastupdate = on);
`fastupdate = on` がデフォルトですが、もし書き込みがそこまで頻繁でないなら、いっそ `off` にしてリアルタイム更新させるのも手です。そのほうが検索パフォーマンスは安定します。
2. `gin_clean_pending_list` の手動実行
もし `fastupdate = on` を使うなら、定期的なメンテナンスが必須です。これを忘れると、ある日突然パフォーマンスが崖から落ちます。
手動で掃除するコマンドはこれ。
— メンテナンスしたいインデックスを指定
SELECT gin_clean_pending_list(‘idx_mytable_data’);
これを `cron` や `pg_cron` で定期的に叩くようにしましょう。僕が以前担当したプロジェクトでは、夜間のトラフィックが減るタイミングでバッチを走らせることで、日中の検索速度を劇的に改善しました。
—
現場からのアドバイス：どうやって管理するか？
「どのくらい溜まっているのか」を確認しないまま闇雲に掃除しても意味がありません。今のサイズを確認するクエリを叩き込んでおきましょう。
— 現在のpending listのサイズを確認
SELECT pg_size_pretty(pg_relation_size(pending_list_relid))
FROM pg_gin_index_stats(‘idx_mytable_data’);
このクエリの結果を見て、「あ、今週は更新が多かったから溜まり方が早いな」とか「このサイズを超えたら掃除しよう」という基準を設けるのが、優秀なDBエンジニアの仕事です。
最後に
GINインデックスの更新コストは、PostgreSQLの「優しさ（Pending List）」が仇になっている側面もあります。
- 書き込み頻度が高いなら： `fastupdate = on` にして、定期的な `gin_clean_pending_list` をタスクに組み込む。
- 検索速度が命なら： `fastupdate = off` にして、書き込み時のコストを甘んじて受ける。
結局のところ、銀の弾丸はありません。自分のアプリケーションが「書き込み重視」なのか「検索重視」なのかを見極めて、設定値を調整する。この「泥臭いチューニング」こそが、PostgreSQLを最高の武器に変える秘訣です。
現場からは以上です。もし「インデックスが重くて夜も眠れない！」という状況になったら、まずは `pg_gin_index_stats` を覗くところから始めてみてください。きっと答えが見えてくるはずですよ。
コメント