pgtune を使う理由
- ハードウェアに合わせた設定。RAM、CPU、ストレージ、負荷の種類を入力すると、
shared_buffers、work_mem、WAL、並列関連の設定が得られます。 - PostgreSQL 14–19。選んだバージョンに応じてパラメーターが変わります(18 以降の
io_method、wal_compression、vacuum 関連など)。 - 解説と警告。各パラメーターに短い理由を付け、OOM リスク、huge pages、LZ4、io_uring、再起動が必要な設定を示します。
- 5 つの負荷とストレージの種類。Web、OLTP、データウェアハウス、デスクトップ、混合。SSD、HDD、SAN、NVMe。
- ブラウザー内だけで動作。サーバーも API もなく、パラメーターは端末から出ません。無料、23 言語、共有リンク付き。
PostgreSQL をチューニングする手順
- PostgreSQL のバージョン、OS、負荷の種類を選びます。
- RAM 総量と単位を入力し、分かれば CPU コア数と最大接続数も入力します。
- ストレージの種類と、データ量が RAM より小さいか、同程度か、大きいかを選びます。
- 「生成」を押し、解説と警告を読んでから、スニペットを
postgresql.confにコピーします。
生成される設定について
結果は、メモリ、WAL、プランナー、並列処理に関する一般的な経験則に基づく出発点です。ご自身のデータでの負荷テストや監視の代わりにはなりません。
ヒント:
- 再起動が必要な設定には専用のバッジが付きます。
work_memは接続単位ではなく処理単位で適用され、複雑なクエリでは複数回使われることがあります。- クライアントが多い場合は
max_connectionsを上げるより PgBouncer などのプーラーを使ってください。 - Linux で
shared_buffersが 2 GB 以上なら huge pages を有効にします。 - 変更後は
EXPLAIN (ANALYZE, BUFFERS)とpg_stat_statementsで確認し、パラメーターはグループ単位で変更して元の設定を残してください。
用途
- 新しい PostgreSQL サーバーの妥当な初期設定を得る;
- RAM や CPU の増設、メジャーバージョンアップ後に再計算する;
- 同じハードウェアで負荷タイプ(Web、OLTP、分析)を比較する;
- レビューや運用手順書でパラメーター選定の根拠を説明する。
よくある質問
pgtune は入力内容をサーバーに送りますか?
いいえ。計算はすべてブラウザー内で行われ、API はありません。
対応する PostgreSQL のバージョンは?
14 から 19 です。パラメーターの種類と値は選んだバージョンで変わります。
結果をそのまま本番に貼ってよいですか?
出発点として扱ってください。警告を確認し、テスト環境で適用して、実負荷でメトリクスを見てください。
大きなデータベースでも max_connections が低いのはなぜ?
接続ごとにメモリを使い、work_mem はそれらで分け合います。数千の直接接続より PgBouncer などのプーラーのほうが通常は適しています。
CPU や接続数が分からないときは?
空欄のままにしてください。プロファイルと RAM から値が選ばれ、結果に想定した接続数が表示されます。