Menu

PostgreSQL EXPLAIN ANALYZE: Sorgu Planı Nasıl Okunur

EXPLAIN, PostgreSQL'in bir sorgu için seçtiği planı gösterir; EXPLAIN ANALYZE ise sorguyu çalıştırır ve her adımın gerçek satır sayılarını ve sürelerini ekler. Plan ağacını ve sık görülen düğüm adlarını okumayı öğren.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

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çaAnlamı
cost=STARTUP..TOTALilk 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ı
widthbayt cinsinden tahmini ortalama satır boyutu
actual timedö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
loopsdüğü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üğümNe yapar
Seq Scantüm tabloyu okur
Index Scansatırları bir indeks üzerinden bulur, sonra her satırı tablodan okur
Index Only Scantabloya hiç uğramadan indeksten yanıt verir
Bitmap Index Scan + Bitmap Heap Scaneşleşen satırların konumlarını bir indeksten toplar, sonra onları tablo sırasıyla okur
Nested Loopher dış satır için iç girdide eşleşmeleri arar; dış taraf küçükken iyidir
Hash Join + Hashbir girdiden hash tablosu kurar, diğer girdiyle ona bakar
Merge Joinjoin anahtarına göre zaten sıralı iki girdiyi birleştirir
Sort, Incremental SortORDER BY, DISTINCT ya da merge join için satırları sıralar
HashAggregate, GroupAggregatehash tablosuyla ya da sıralı girdi üzerinde GROUP BY
LimitN satırdan sonra durur
Gatherparalel 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.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla