Geliştirme

PostgreSQL İndeks Rehberi: Yavaş Sorgu Nasıl İncelenir?

Mehmet Fatih Ünal
28 Ekim 2026
6 dk okuma
#PostgreSQL#SQL#İndeks#EXPLAIN ANALYZE#Performans
PostgreSQL İndeks Rehberi: Yavaş Sorgu Nasıl İncelenir?

PostgreSQL indeksleri yavaş sorguları nasıl hızlandırır?

PostgreSQL indeksi, belirli satırları bulmak için tablonun tamamını okumaya alternatif bir erişim yolu sağlar. Faydalı olup olmadığı sorgunun filtresine, sıralamasına ve döndüreceği veri miktarına bağlıdır. Resmî indeks rehberi, performans kazancının yanında bakım maliyetini de vurgular.

Bir sipariş panelini düşünün: ekran yalnızca bir müşterinin son yirmi siparişini gösteriyor, fakat veri büyüdükçe açılması uzuyor. Ekrandaki satır sayısı değişmedi. Veritabanının bu satırları bulmak için yaptığı iş değişmiş olabilir.

İlk soru "hangi kolona indeks ekleyelim?" yerine "hangi sorgu, hangi parametrelerle ne yapıyor?" olmalı. Önce uygulamanın gerçekten çalıştırdığı SQL'i alın. ORM tarafında kısa görünen bir ifade, veritabanında beklenmedik bir sıralama ya da ek sorgular üretebilir.

EXPLAIN ile EXPLAIN ANALYZE arasındaki fark nedir?

EXPLAIN, PostgreSQL'in seçtiği tahmini sorgu planını gösterir. EXPLAIN ANALYZE sorguyu gerçekten çalıştırır ve plana gerçekleşen sürelerle satır sayılarını ekler. Plandaki cost değerleri milisaniye değildir; süre için actual time ve Execution Time alanlarına bakılır. EXPLAIN belgesi bu ayrımı açıklar.

Örnekte orders_demo tablosunun id, tenant_id, created_at ve status kolonlarını içerdiğini varsayalım. id benzersiz, created_at ise boş değer almayan bir tarih alanı olsun. Deneme veritabanında şu sorgunun planını kaydedin:

EXPLAIN (ANALYZE, BUFFERS)
SELECT id, created_at, status
FROM orders_demo
WHERE tenant_id = 42
ORDER BY created_at DESC, id DESC
LIMIT 20;

Yalnızca en üstteki süreyi okumayın. Tahmin edilen satır sayısı ile gerçekleşen sayı arasında büyük fark var mı? Ayrı bir Sort adımı görünüyor mu? loops değeri, bir işlemin kaç defa tekrarlandığını söylüyor. BUFFERS ise bellek ve okuma davranışını anlamak için ek bağlam sunuyor.

ANALYZE seçeneği gerçek yürütme yaptığı için bu incelemeyi yazma sorgularına gelişigüzel uygulamayın. Buradaki örnek SELECT kullanır; yine de pahalı bir okuma sorgusunun çalışma yükü oluşturacağını hesaba katın.

Birleşik indekste kolon sırası nasıl seçilir?

Birleşik B-tree indeksi, bu örnekte önce tenant_id eşitliğini, sonra istenen tarih ve kimlik sırasını destekleyebilir. Filtreyle daraltılan alanın ardından sıralama kolonlarını yerleştirmek bu sorgu için değerlendirmeye değer bir adaydır:

CREATE INDEX orders_demo_tenant_created_idx
ON orders_demo (tenant_id, created_at DESC, id DESC);

Bu bir deneme ortamı örneğidir; büyük canlı tablolarda indeks oluşturmanın kilit ve kaynak etkileri ayrıca planlanmalıdır. İndeksi oluşturduktan sonra aynı EXPLAIN sorgusunu tekrar çalıştırın. Planın değişip değişmediğini ve gereken işin azalıp azalmadığını karşılaştırın.

Çok kolonlu indeks belgesi, B-tree indekslerinde baştaki eşitlik koşullarının taranacak alanı nasıl daralttığını anlatır. Ancak bu, baştaki kolon filtrelenmediğinde indeksin hiçbir koşulda kullanılamayacağı anlamına gelmez. Kullanım kararı veri dağılımına ve planlayıcıya bağlıdır.

id alanı burada aynı tarihe sahip siparişleri belirli bir sıraya koyar. Başka sorgular status ile filtreliyorsa aynı indeksin onlar için de en iyi seçenek olduğunu varsaymayın. Her sorgu ailesini kendi koşullarıyla değerlendirin.

ORDER BY ve LIMIT neden birlikte önemlidir?

Sıralamayla uyumlu bir B-tree indeksi, bazı sorgularda ayrı bir sıralama yapmadan ilk satırlara ulaşılmasını sağlayabilir. ORDER BY ve indeks rehberi, bu avantajın özellikle LIMIT ile birlikte belirginleşebileceğini açıklar.

Fakat ekranda yirmi kayıt göstermek, arka planda yalnızca yirmi satırın incelendiği anlamına gelmez. Ek filtreler, tablo erişimleri ve farklı sıralamalar daha fazla iş gerektirebilir. Planda ne olduğuna bakmadan sabit bir hızlanma oranı söylemek doğru olmaz.

Listenin ileri sayfaları da yavaşsa sorguya eklenen OFFSET değerini kontrol edin. İlk sayfayı hızlandıran indeks, derin sayfalamanın bütün maliyetini ortadan kaldırmayabilir. Bu ayrımın devamı cursor ve offset sayfalama rehberinde var.

İndeks varken Seq Scan görmek hata mı?

Seq Scan görmek tek başına hata değildir. Küçük bir tabloyu ya da satırların büyük bölümünü okumak gerektiğinde sıralı tarama daha uygun olabilir. Hedef, planda belirli bir düğüm adı görmek değil, ihtiyacı daha az maliyetle karşılamaktır.

Tahminler veriyle uyuşmuyorsa istatistiklerin güncelliğini de inceleyin. PostgreSQL, sorgu planlamasında ANALYZE ile toplanan istatistiklerden yararlanır. Rutin bakım rehberi, bu istatistiklerin rolünü ve otomatik bakım sürecini açıklar.

Karşılaştırmayı aynı filtreler ve benzer veri dağılımıyla yapın. İlk çalıştırma ile sonraki çalıştırmalar arasında önbellek etkisi olabilir. Test sonucunu kaydederken veri boyutunu ve deneme koşullarını yazmak, tek bir süre paylaşmaktan daha yararlıdır.

Yeni indeks eklemeden önce neyi kaydetmeli?

Bir indeks kararı, hangi sorgunun iyileşmesini beklediğinizi ve neyi karşılaştıracağınızı açıkça içermelidir. SQL, parametreler, önceki plan, sonraki plan ve ilgili yazma yükü kısa bir teknik not için yeterli bir başlangıçtır.

Her ek indeks depolama ve yazma bakımına katkıda bulunur. Kullanılmayan benzer indeksleri biriktirmek yerine sorgu ihtiyacını netleştirin. Veritabanı seçimini hâlâ değerlendiriyorsanız SQLite production notları farklı bir kullanım modelini tartışır.

Sık sorulan sorular

Her WHERE kolonu için indeks oluşturmalı mıyım? Hayır. Filtrelerin birlikte kullanımı, seçiciliği ve sıralama ihtiyacı değerlendirilmelidir.

EXPLAIN çıktısındaki cost sorgunun süresi midir? Hayır. Planlayıcının maliyet tahminidir; gerçek süreler ANALYZE ile yürütme sonrasında görülür.

İndeks ekledim ama plan değişmedi, başarısız mı oldum? Şart değil. Veri miktarı, istatistikler ve sorgunun kaç satır istediği nedeniyle mevcut plan daha uygun olabilir.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar