EXPLAIN query, PostgreSQL'in bir sorgu için seçtiği planı gösterir: tahmini maliyetleri ve satır sayıları olan adımlardan (düğümlerden) oluşan bir ağaç. EXPLAIN ANALYZE query ise sorguyu çalıştırır ve her düğümün gerçek süresini, satırlarını ve döngülerini ekler. Ağacı en içerideki düğümden dışarıya doğru oku: iç düğümler satırlarını bir üstteki düğüme aktarır.
email üzerinde indeks yok, bu yüzden plan bir Seq Scan: PostgreSQL her satırı okur ve Filter koşulunu geçenleri tutar. Rows Removed by Filter boşa giden işi gösterir. Süreler her çalıştırmada farklıdır; planın şekli sayılardan daha önemlidir.
Bir plan satırını okumak
Her düğüm şu biçimde bir satır yazdırır:
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| Parça | Anlamı |
|---|---|
cost=STARTUP..TOTAL | ilk satırdan önceki ve tüm satırlar için tahmini iş, planlayıcı birimiyle (milisaniye değil) |
rows (ilki) | düğümün döndüreceği tahmini satır sayısı |
width | bayt cinsinden tahmini ortalama satır boyutu |
actual time | döngü başına ilk satıra ve son satıra kadar geçen milisaniye |
rows (gerçek) | döngü başına döndürülen satırlar |
loops | düğümün kaç kez çalıştığı; süreyi ve satırları bununla çarp |
Bir üst düğümün maliyetleri alt düğümlerini de içerir. En alttaki Planning Time ve Execution Time tüm komutun toplamlarıdır.
Sık görülen plan düğümlerini tanımak
EXPLAIN (COSTS OFF) sayıları gizler, böylece planın şekli daha kolay görünür:
İçeriden başlayarak oku. İki tablo da taranır ve filtrelenen müşteriler bir Hash içine konur. Hash Join her siparişle bu hash'e bakar, en üstteki GroupAggregate de sonucu sayar. En sık karşılaşacağın düğümler:
| Düğüm | Ne yapar |
|---|---|
Seq Scan | tüm tabloyu okur |
Index Scan | satırları bir indeks üzerinden bulur, sonra her satırı tablodan okur |
Index Only Scan | tabloya hiç uğramadan indeksten yanıt verir |
Bitmap Index Scan + Bitmap Heap Scan | eşleşen satırların konumlarını bir indeksten toplar, sonra onları tablo sırasıyla okur |
Nested Loop | her dış satır için iç girdide eşleşmeleri arar; dış taraf küçükken iyidir |
Hash Join + Hash | bir girdiden hash tablosu kurar, diğer girdiyle ona bakar |
Merge Join | join anahtarına göre zaten sıralı iki girdiyi birleştirir |
Sort, Incremental Sort | ORDER BY, DISTINCT ya da merge join için satırları sıralar |
HashAggregate, GroupAggregate | hash tablosuyla ya da sıralı girdi üzerinde GROUP BY |
Limit | N satırdan sonra durur |
Gather | paralel worker'lardan satırları toplar |
Kötü satır tahminlerini bulmak
EXPLAIN ANALYZE içindeki en faydalı kontrol, aynı düğümde tahmini rows ile gerçek rows değerini karşılaştırmaktır. Aralarında büyük fark varsa planlayıcı planını yanlış sayılarla seçmiştir; bunun nedeni çoğu zaman eksik ya da eski istatistiklerdir:
Tarama gerçekte 10 satır döndürüyor, ama tahmin çok daha yüksek, çünkü tablo henüz analiz edilmedi. EXPLAIN'den önce ANALYZE tasks; ekle, tahmin 10'a yaklaşır. Autovacuum tabloları arka planda analiz eder, ama toplu bir yüklemeden sonra ANALYZE'ı kendin çalıştır (VACUUM ve autovacuum sayfasına bak).
Bir veri değişikliğini kalıcı yapmadan açıklamak
EXPLAIN ANALYZE komutu çalıştırır, yani bir UPDATE ya da DELETE satırları değiştirir. Komutu bir transaction içine al ve geri al:
Geri almadan sonra 1000 satırın hepsi hâlâ yerinde.
BUFFERS ve diğer seçeneklerle I/O'yu göstermek
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
BUFFERS I/O'yu gösterir: çok sayıda read sayfası olan bir düğüm diske gitmiştir. PostgreSQL 17, SERIALIZE (çıktı satırlarını metne çevirmenin maliyeti) ve MEMORY (planlayıcının belleği) seçeneklerini ekledi. Resmi EXPLAIN rehberi daha fazla planı adım adım inceler.
Planlayıcı ayarlarıyla bir planı test etmek
PostgreSQL'in bir yöntem olmadan hangi planı kullanacağını görmek için o yöntemi oturumunda kapat. Bunu yalnızca deneylerde yap, asla üretim kodunda yapma:
100 satırla planlayıcı Seq Scan'i tercih eder; enable_seqscan = off ile plan Index Scan using items_pkey gösterir. İndeksin işe yarayıp yaramadığını görmek için iki EXPLAIN ANALYZE süresini karşılaştır. RESET enable_seqscan; varsayılanı geri yükler.
Sıkça Sorulan Sorular
EXPLAIN ile EXPLAIN ANALYZE arasındaki fark nedir?
EXPLAIN sorguyu yalnızca planlar ve tahminleri gösterir. EXPLAIN ANALYZE ise sorguyu çalıştırır ve her düğümün gerçek süresini, satır sayısını ve döngü sayısını ekler; bu yüzden sorgunun kendisi kadar sürer.
PostgreSQL planında cost ne anlama gelir?
Cost, planlayıcının keyfi birimlerle yaptığı tahmindir; bir sayfayı sırayla okumak 1 (seq_page_cost) olacak şekilde ölçeklenir. Aynı sorgunun planlarını karşılaştırmak için işe yarar, milisaniye cinsinden bir süre değildir.
EXPLAIN ANALYZE verileri değiştirir mi?
Evet, INSERT, UPDATE, DELETE ve MERGE için değişikliği gerçekten yapar. Sonucu tutmadan ölçmek için BEGIN ile ROLLBACK arasında çalıştır.
İndeks varken neden Seq Scan seçiliyor?
Çünkü planlayıcı onun daha ucuz olduğunu tahmin ediyor: tablo küçüktür, sorgu satırların büyük bir kısmını döndürür ya da koşul indeksi kullanamaz. Eski istatistikler de onu yanıltabilir; bunu ANALYZE düzeltir.