dmosk / pgtune

تنظیم پیکربندی PostgreSQL

بخشی از postgresql.conf را برای سرور خود بسازید: نسخه، سیستم‌عامل، بار کاری، RAM، CPU، اتصال‌ها و ذخیره‌ساز. هر مقدار توضیح دارد و همهٔ محاسبه‌ها در مرورگر انجام می‌شود.

سخت‌افزار و بار کاری

چرا pgtune

  • پیکربندی متناسب با سخت‌افزار شما. RAM، CPU، ذخیره‌ساز و نوع بار را وارد کنید و shared_buffers، work_mem، تنظیمات WAL و موازی‌سازی را بگیرید.
  • PostgreSQL 14–19. پارامترها از نسخهٔ انتخابی پیروی می‌کنند؛ مثلاً io_method برای 18 به بعد، wal_compression و گزینه‌های vacuum.
  • توضیح و هشدار. هر پارامتر دلیل کوتاهی دارد؛ ابزار خطر OOM، huge pages، LZ4، io_uring و تنظیم‌های نیازمند راه‌اندازی مجدد را نشان می‌دهد.
  • پنج نوع بار و انواع ذخیره‌ساز. وب، OLTP، انبار داده، دسکتاپ و ترکیبی؛ SSD، HDD، SAN و NVMe.
  • فقط در مرورگر. بدون سرور و API — پارامترها از دستگاه شما خارج نمی‌شوند. رایگان، به ۲۳ زبان و با پیوند قابل اشتراک.

چگونه PostgreSQL را تنظیم کنیم

  1. نسخهٔ PostgreSQL، سیستم‌عامل و نوع بار را انتخاب کنید.
  2. کل RAM و واحد آن را وارد کنید و در صورت آگاهی، هسته‌های CPU و حداکثر اتصال را هم بدهید.
  3. نوع ذخیره‌ساز را انتخاب کنید و مشخص کنید داده از RAM کوچک‌تر، تقریباً هم‌اندازه یا بزرگ‌تر است.
  4. «تولید» را بزنید، توضیح‌ها و هشدارها را بخوانید و بخش تولیدشده را در postgresql.conf کپی کنید.

دربارهٔ تنظیم‌های تولیدشده

نتیجه نقطهٔ شروعی بر پایهٔ قاعده‌های شناخته‌شده برای حافظه، WAL، برنامه‌ریز و موازی‌سازی است. جایگزین آزمون بار و پایش روی داده‌های خودتان نیست.

نکته‌ها:

  • تنظیم‌هایی که به راه‌اندازی مجدد نیاز دارند با نشان جداگانه علامت می‌خورند.
  • work_mem برای هر عملیات است نه هر اتصال؛ یک پرس‌وجوی پیچیده می‌تواند چندبار از آن استفاده کند.
  • با کلاینت‌های زیاد به‌جای افزایش max_connections از پولری مثل PgBouncer استفاده کنید.
  • روی Linux اگر shared_buffers از ۲ گیگابایت بیشتر است، huge pages را فعال کنید.
  • پس از تغییر با EXPLAIN (ANALYZE, BUFFERS) و pg_stat_statements بررسی کنید، پارامترها را گروهی تغییر دهید و پیکربندی قبلی را نگه دارید.

کاربردها

  • گرفتن پیکربندی اولیهٔ معقول برای سرور تازهٔ PostgreSQL؛
  • محاسبهٔ دوباره پس از افزودن RAM یا CPU یا ارتقای نسخهٔ اصلی؛
  • مقایسهٔ نوع‌های بار (وب، OLTP، تحلیلی) روی یک سخت‌افزار؛
  • توجیه انتخاب پارامترها در بازبینی یا runbook.

پرسش‌های متداول

آیا pgtune پارامترهای مرا به سرور می‌فرستد؟

خیر. همهٔ محاسبه‌ها در مرورگر انجام می‌شود و API وجود ندارد.

کدام نسخه‌های PostgreSQL پشتیبانی می‌شوند؟

از 14 تا 19. مجموعهٔ پارامترها و مقادیر آن‌ها به نسخهٔ انتخابی بستگی دارد.

آیا می‌توانم نتیجه را مستقیم در محیط عملیاتی بگذارم؟

آن را نقطهٔ شروع بدانید. هشدارها را بخوانید، روی نمونهٔ آزمایشی اعمال کنید و شاخص‌ها را زیر بار واقعی ببینید.

چرا max_connections حتی برای پایگاه‌دادهٔ بزرگ کم است؟

هر اتصال حافظه مصرف می‌کند و work_mem بین آن‌ها تقسیم می‌شود. پولری مثل PgBouncer معمولاً از هزاران اتصال مستقیم بهتر است.

اگر CPU یا تعداد اتصال را نمی‌دانم چه کنم؟

فیلدها را خالی بگذارید: مقادیر بر اساس نوع بار و RAM انتخاب می‌شوند و نتیجه تعداد اتصال فرض‌شده را نشان می‌دهد.