EXPLAIN ve EXPLAIN ANALYZE nasıl kullanılır?

Question

Accepted Answer

**`EXPLAIN`** PostgreSQL'in **sorgu yürütme planını** gösterir — bir sorguyu nasıl çalıştıracağını (hangi taramaları, birleştirmeleri, dizinleri). **`EXPLAIN ANALYZE`** aslında sorguyu çalıştırır ve gerçek zamanlamayı ve satır sayılarını gösterir. Bunlar, yavaş sorguları teşhis etmek için birincil araçlardır.

## EXPLAIN — plan (çalıştırma olmaksızın)

```sql
EXPLAIN SELECT * FROM orders WHERE customer_id = 5;
-- shows the PLAN: scan type, estimated cost, estimated rows — but doesn't run it
```

## EXPLAIN ANALYZE — plan ile GERÇEK yürütme verisi

```sql
EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- ACTUALLY runs it → shows REAL time, ACTUAL rows, and where time was spent
EXPLAIN (ANALYZE, BUFFERS) SELECT ...;   -- also shows buffer/cache usage
```

`EXPLAIN ANALYZE` daha kullanışlıdır çünkü *gerçek* performansı gösterir (gerçek zamanlamalar, gerçek satır sayıları) — sorgunun aslında nerede zaman harcadığını ortaya çıkarır, sadece tahminleri değil.

## Planı okumak: dikkat edilecek önemli şeyler

```text
SCAN TYPES (most important):
  Seq Scan      → FULL TABLE SCAN (reads every row) — slow on big tables, often the problem
  Index Scan    → uses an index to find rows — fast
  Index Only Scan → reads only the index (doesn't touch the table) — fastest
  Bitmap Scan   → for combining indexes / many matches

WATCH FOR:
  ✗ Seq Scan on a large table being filtered → likely a MISSING INDEX
  ✗ Estimated rows VERY different from actual rows → outdated statistics (run ANALYZE)
  ✗ Expensive joins, sorts spilling to disk ("external merge")
  ✗ The node with the highest actual time = the bottleneck
```

## Teşhis örneği

```sql
EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- "Seq Scan on orders ... actual time=120ms" → a full scan, slow

CREATE INDEX idx_orders_customer ON orders(customer_id);

EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- "Index Scan using idx_orders_customer ... actual time=0.05ms" → fixed!
```

## Neden önemli

`EXPLAIN` ve `EXPLAIN ANALYZE` PostgreSQL'de **yavaş sorguları teşhis etmek ve optimize etmek** için gerekli, birincil araçlardır — sorgu performansı uygulamalar için kritiktir ve bu araçlar bir sorgunun neden yavaş olduğunu anlamanız ve düzeltmeleri doğrulamanız için nasıl kullanılacağıdır, bu nedenle bunlara hakim olmak veritabanı performans çalışması için önemli üst düzey bilgidir.

Temel değer **yürütme planına karşı görünürlüktür**: bir sorgunun neden yavaş olduğunu tahmin etmek yerine, `EXPLAIN ANALYZE` (sorguyu çalıştırır ve gerçek zamanlamalar ve satır sayılarını gösterir) Postgres'in bunu tam olarak nasıl yürüttüğünü ve zamanın nerede harcandığını ortaya çıkarır.

Tanınması gereken en önemli şeyler **tarama türleridir** — özellikle büyük filtrelenmiş bir tablodaki **`Seq Scan` (tam tablo taraması)** tanımlamak, bu genellikle **eksik bir dizini** (en yaygın ve etkili sorgu performans sorunu) gösterir, hızlı **`Index Scan`** ile karşılaştırıldığında.

Planı okuma yeteneği (tarama türleri, eski istatistikleri fark etmek için tahmin edilen satırlarla gerçek satırları karşılaştırma, darboğazı olarak en pahalı düğümü tanımlama, disk-spilling sıralamaları izleme) sorgu optimizasyonu için anahtar beceridir.

Teşhis iş akışı — `EXPLAIN ANALYZE` çalıştırma, darboğazı tanımlama (genellikle bir Seq Scan), düzeltmeyi uygulama (genellikle bir dizin ekleme) ve doğrulamak için yeniden çalıştırma — sorgu optimizasyonu için standart, ölçüm odaklı yaklaşımdır.

Yavaş sorgular zayıf veritabanı performansının önde gelen nedenleri olduğundan ve `EXPLAIN`/`EXPLAIN ANALYZE` onları teşhis etmek için *tek* araçlar olduğundan (eksik dizinleri, kötü planları ve darboğazları ortaya çıkarır) ve optimizasyonları doğrular, bunlara hakim olmak PostgreSQL performansı için önemli, yüksek değerli bilgidir — tahmin etmek yerine sistematik bir şekilde yavaş sorguları bulup düzeltmenin yoludur, performans sağlayan veritabanları için kritik bir beceri ve veritabanı optimizasyonu çalışması için yaygın bir konudur.