PostgreSQL Performans Optimizasyon Rehberi
Yavaş PostgreSQL sorguları için pratik bir iş akışı: EXPLAIN planlarını okuyun, işe yarayan en küçük indeksi ekleyin, pg_stat_statements ile sorunlu sorguları sıralayın ve yapılandırmayı en son ayarlayın.

Yönetici panomuzun arkasındaki siparişler uç noktası ilk yıl yaklaşık 80 ms'de yanıt veriyordu. Ardından tablo birkaç milyon satırı geçti ve aynı uç nokta, hiçbir kod değişikliği olmaksızın saniyeler sürmeye başladı. Sorguya kimse dokunmamıştı. Planlayıcı, sorguyu yanıtlamak için ucuz yolların tükenmişti.
PostgreSQL performans sorununun olağan şekli budur: yavaşça sızar, sonra aniden ortaya çıkar. Nedeni nadiren gizli bir ayardır. Neredeyse her zaman eksik bir indeks, zaten sahip olduğunuz indeksi kullanamayan bir sorgu veya uzun süredir VACUUM yapılmamış bir tablodur. Bu rehber, izlediğim iş akışıdır: EXPLAIN ile ölçün, işe yarayan en küçük indeksle düzeltin, pg_stat_statements ile sorguları sıralayın ve yapılandırmaya en son dokunun.
Hızlı çıkarımlar
- Herhangi bir şeyi değiştirmeden önce
EXPLAIN (ANALYZE, BUFFERS)komutunu çalıştırın. Plan, eksik bir indeksiniz, kötü bir satır tahmininiz veya sadece çok fazla veriniz olup olmadığını size söyler. - Bileşik bir indekste, eşitlik sütunlarını önce, aralık veya sıralama sütununu ise en sona koyun.
- Kısmi ve kapsayıcı indeksler, indeksleri küçük tutar ve yalnızca indeks taramalarını etkinleştirir, ancak her indeks yazma işlemlerini yavaşlatır.
- Sorguları en yavaş tek çalıştırmaya göre değil, toplam süreye göre sıralayın. Milyonlarca kez çağrılan 5 ms'lik bir sorgu, genellikle 2 saniyelik bir rapordan daha pahalıya mal olur.
- Yapılandırmayı en son, her seferinde bir ayar olacak şekilde değiştirin ve bir havuzlayıcı (pooler) ile bağlantı sayılarını düşük tutun.
EXPLAIN planı nasıl okunur?
Sorun yaratan sorguyla başlayın ve PostgreSQL'e aslında ne yaptığını sorun:
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, total_cents
FROM orders
WHERE customer_id = 4821 AND status = 'paid'
ORDER BY created_at DESC
LIMIT 20;
ANALYZE ifadeyi gerçekten yürütür, bu nedenle UPDATE veya DELETE için bunu BEGIN; ... ROLLBACK; içine alın. Uygun bir indeksi olmayan bir tablodan kırpılmış bir plan şöyle görünür (örnek sayılar):
Limit (actual time=212.4..212.4 rows=20 loops=1)
-> Sort (actual time=212.4..212.4 rows=20 loops=1)
Sort Key: created_at DESC
-> Seq Scan on orders (actual time=0.1..201.7 rows=312 loops=1)
Filter: ((customer_id = 4821) AND (status = 'paid'::text))
Rows Removed by Filter: 4188000
Bakılacak üç şey var. Birincisi, tarama türü: Milyonlarca satırı kaldırıp birkaç yüz satır döndüren bir Seq Scan, klasik eksik indeks belirtisidir. İkincisi, tahmini ve gerçek satırlar: Büyük bir fark, güncel olmayan istatistikler anlamına gelir, bu yüzden tabloda ANALYZE çalıştırın. Üçüncüsü, Buffers satırı ve sıralama yöntemi: diskten okumalar ve external merge sıralamaları, bellek baskısına veya ihtiyacından çok daha fazlasını döndüren bir sorguya işaret eder.
Hangi indeksi oluşturmalıyım?
B-tree varsayılandır ve eşitlik, aralık ve sıralama sorgularına uyar. Dizileri, jsonb veya tam metin vektörlerini ararken GIN'i, geometrik veya aralık verilerinde ise GiST'i tercih edin. BRIN, zamana göre sıralanmış büyük, yalnızca eklemeli tablolarda iyi çalışan küçük bir indekstir. Hash indeksleri yalnızca eşitliği destekler ve nadiren bir B-tree'den daha iyidir.
Yukarıdaki sorgu için, üç varyant çoğu gerçek durumu kapsar:
-- equality columns first, then the column used for ordering
CREATE INDEX CONCURRENTLY idx_orders_customer_status_created
ON orders (customer_id, status, created_at DESC);
-- partial: index only the rows the hot query touches
CREATE INDEX CONCURRENTLY idx_orders_pending
ON orders (created_at)
WHERE status = 'pending';
-- covering: lets PostgreSQL answer from the index alone
CREATE INDEX CONCURRENTLY idx_orders_customer_covering
ON orders (customer_id, created_at DESC) INCLUDE (total_cents);
Yalnızca indeks taraması, autovacuum'un koruduğu güncel bir görünürlük haritasına da ihtiyaç duyar, bu nedenle hiç VACUUM yapılmayan bir tablodaki kapsayıcı bir indeks sizi hayal kırıklığına uğratacaktır. CREATE INDEX CONCURRENTLY yazma işlemlerini engellemekten kaçınır ancak bir işlem içinde çalışamaz; kilit ile ilgili ayrıntılar Postgres Migrations Without Locks makalesinde bulunmaktadır. Bir indeks oluşturduktan sonra, EXPLAIN komutunu tekrar çalıştırın ve sayıları karşılaştırın. Plan değişmediyse, indeksi bırakın.
Dikkat edilmesi gereken sorguları nasıl bulurum?
Tahmin etmek zaman kaybıdır. pg_stat_statements her normalleştirilmiş sorguyu toplar ve toplam süreye göre sıralama, veritabanının gününü nerede geçirdiğini gösterir:
-- postgresql.conf: shared_preload_libraries = 'pg_stat_statements' (restart required)
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
SELECT round(total_exec_time::numeric, 0) AS total_ms,
calls,
round(mean_exec_time::numeric, 2) AS mean_ms,
rows,
left(query, 80) AS query
FROM pg_stat_statements
ORDER BY total_exec_time DESC
LIMIT 10;
Günde 50 kez çalışan 200 ms'lik bir sorgu sizin sorununuz değildir; beş milyon kez çalışan 5 ms'lik bir sorgu ise sorununuzdur. Tek seferlik aykırı değerleri yakalamak için bunu yavaş sorgu günlüğü (log_min_duration_statement = 500) ile eşleştirin ve planların otomatik olarak yakalanmasını istiyorsanız auto_explain ile kullanın.
Hangi yapılandırma ayarları önemlidir?
Düşündüğünüzden daha azı. Bunlar özel bir 16 GB sunucu için başlangıç noktalarıdır, kurallar değil:
# postgresql.conf
shared_buffers = 4GB # about 25% of RAM
effective_cache_size = 12GB # planner hint, 50-75% of RAM
work_mem = 32MB # per sort or hash node, per query
maintenance_work_mem = 1GB
random_page_cost = 1.1 # for SSD storage
log_min_duration_statement = 500
work_mem konusunda dikkatli olun: her sorgudaki her sıralama veya hash işlemine uygulanır, bu nedenle her biri birkaç böyle düğüme sahip 200 eşzamanlı sorgu belleği hızla tüketebilir. Bağlantı sayısının önemli olmasının nedeni de budur. Her PostgreSQL bağlantısı bir süreçtir, bu nedenle veritabanının önüne PgBouncer'ı koyun ve sunucuyu yüzlerce yerine birkaç düzine bağlantıda tutun. İşlem havuzlama, danışmanlık kilitleri ve SET gibi oturum düzeyindeki özellikleri bozar, bu nedenle uygulamanızı önce test edin. Eğer bir tablo VACUUM yapmak ve rahatça küçültmek için çok büyükse, bir sonraki adım PostgreSQL Partitioning and Read Replicas makalesinde ele alınan bölümlemedir.
En yaygın PostgreSQL performans hataları nelerdir?
- N+1 sorguları. İlişkili satırları bir döngüde getirmek. Bir
JOINkullanın veyaWHERE id = ANY($1)ile tek bir sorgu kullanın. - İndekslenmemiş yabancı anahtarlar. PostgreSQL sizin için referans veren sütunda bir indeks oluşturmaz ve ana tablodaki silme işlemleri alt tabloyu tarayacaktır.
- İndekslenmiş sütunlarda fonksiyonlar.
WHERE lower(email) = 'a@b.com'emailüzerinde düz bir indeks kullanamaz;lower(email)üzerinde bir ifade indeksi oluşturun. - Aşırı indeksleme. Her indeks yazma süresi ve disk maliyeti getirir. Kimsenin okumadığı indeksleri bulun:
SELECT s.relname AS table_name,
s.indexrelname AS index_name,
pg_size_pretty(pg_relation_size(s.indexrelid)) AS size,
s.idx_scan
FROM pg_stat_user_indexes s
JOIN pg_index i ON i.indexrelid = s.indexrelid
WHERE s.idx_scan = 0 AND NOT i.indisunique
ORDER BY pg_relation_size(s.indexrelid) DESC
LIMIT 20;
- Autovacuum'u göz ardı etmek. Ölü satırlar tabloları şişirir ve güncel olmayan istatistikler kötü planlar üretir.
pg_stat_user_tablesiçindekin_dead_tupdeğerini izleyin.
İstatistikler bir çökme veya manuel sıfırlama durumunda sıfırlanır ve bir indeks yalnızca bir replikada kullanılabilir, bu nedenle herhangi bir şeyi bırakmadan önce her düğümde tam bir iş döngüsünü kontrol edin.
Bu hafta ne yapmalıyım?
pg_stat_statements'ı etkinleştirin, bir gün boyunca veri toplamasını bekleyin ve toplam süreye göre en iyi beş sorguyu alın. Her birinde EXPLAIN (ANALYZE, BUFFERS) komutunu çalıştırın ve yalnızca en kötü olanı tek bir indeksle düzeltin. Yöntemi değil, sadece sonucu görebilmesi için sonraki kişinin çekme isteğine (pull request) önceki ve sonraki zamanlamaları kaydedin. Yavaş uç noktaların uygulama tarafındaki nedenleri Backend Performance Optimization makalesinde ele alınmıştır.
Uğur Kaval
Modern teknolojilerle yenilikçi çözümler geliştirmede uzmanlaşmış AI/ML Mühendisi & Full Stack Geliştirici. Otomasyon, makine öğrenmesi ve web geliştirme tutkunu.


