dmosk / pgtune

PostgreSQL 設定チューナー

サーバーに合わせた postgresql.conf の設定例を生成します。バージョン、OS、負荷、RAM、CPU、接続数、ストレージを指定でき、各値に解説が付きます。計算はすべてブラウザー内です。

ハードウェアと負荷

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 をチューニングする手順

  1. PostgreSQL のバージョン、OS、負荷の種類を選びます。
  2. RAM 総量と単位を入力し、分かれば CPU コア数と最大接続数も入力します。
  3. ストレージの種類と、データ量が RAM より小さいか、同程度か、大きいかを選びます。
  4. 「生成」を押し、解説と警告を読んでから、スニペットを 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 から値が選ばれ、結果に想定した接続数が表示されます。