İçeriğe geç
Aurabase Logosu
aura tabanı

Performans denetimi s.99

Yavaş sorguları tanımlayın, EXPLAIN ANALYZE'i, indeksleme stratejilerini ve üretimde Postgres'yi sonlandıran 5 anti-örüntüyü anlayın.

Nasıl yapılır kılavuzu14 dk. okuSeviye ileri düzey15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Optimize etmeden önce ölçün#

Denetim sayılarla başlar. Studio, p50/p95/p99'u uç noktaya ve sorguya göre gösterir. Herhangi bir değişiklikten önce 7 günlük bir taban çizgisi yakalayın.

Bilgi

aura db slow-queries ve aura db stats CLI komutları, projenizin kapsamına dahil edilen bağlantılı projenizdeki pg_stat_statements ve veritabanı havuzu/boyut ölçümlerini sorgular (ayrıca Studio › Database ve Logs içinde de mevcuttur). aura db inspect indexes|tables|locks dizin kullanımını (kullanılmayanlar işaretlenmiş olarak), tablo boyutlarını ve ölü satırları ve engelleme kilitlerini listeler; bunlar, /raw'nin sistem kataloglarını reddettiği için çalıştıramadığı tanılamalardır.

clibash
# En pahalı 10 sorgu (toplam süre)
aura db slow-queries --limit 10

# Bağlantılar ve veritabanı boyutu (uç nokta gecikmeleri: Studio › Günlükler)
aura db stats

gerçek zamanlı olarak pg_stat_statements#

pg_stat_statements her yeni projeye yüklenir ve önceden yüklenir. Her normalleştirilmiş sorguyu (hiçbir değişmez değer saklanmaz) mean_exec_time, calls ve rows ile toplar. /raw doğrudan okumaz — görünüm küme çapındadır — bu nedenle yalnızca projenizin sorgularını döndüren yukarıdaki komutları veya Studio › Database komutunu kullanın.

top-10bash
aura db slow-queries --limit 10 --json
aura db inspect indexes        # idx_scan = 0 ve benzersiz/birincil değil → kullanılmıyor

Planı bir profesyonel gibi okuyun#

Projenin ifade zaman aşımından (10 s) daha uzun çalışan bir sorgu, aura db raw'de STATEMENT_TIMEOUT (HTTP 504) / « ifade zaman aşımı nedeniyle ifadeyi iptal etme » ile iptal edilir: işi azaltın veya bölün.

Plan size sorgunun neden yavaş olduğunu söyler. Aranacak 4 sinyal:

  • Seq Scan tablodaki > 10k satırlar → eksik dizin
  • rows (estimated) ≠ rows (actual) ±10× → eski istatistikler, analyze table_name
  • Nested Loop 100.000'den fazla satırda → karma birleştirme tercih edilir, belki WHERE eksik
  • Materialize veya Sort Method: external merge → RAM tükendi, work_mem artırılacak
debugsql
explain (analyze, buffers, format json)
select * from orders
where customer_id = 'abc' and created_at > now() - interval '30 days';

Ne zaman, ne, nasıl#

  • B-ağacı (varsayılan): eşitlik, aralık, sıralama ölçütü. Vakaların %80'i.
  • GIN: tam metin araması, JSONB, tablolar. using gin (to_tsvector('french', body)).
  • GiST: aralık türleri, dışlama kısıtlamaları, benzerlik araması (pg_trgm).
  • HNSW (pgvector): vektör arama, > 100 bin vektör.
  • Kısmi: genel koşullar, geçici silme için where deleted_at is null.
  • Tabloda aramayı önlemek için: include (...)'yi kapsar.
Dikkat

Her dizin INSERT/UPDATE/DELETE'i yavaşlatır (dizin başına ~%5-15). Kullanılmayan dizinleri bırak — aura db inspect indexes bunları listeler (hiçbir zaman taranmaz, benzersiz değil, birincil değildir).

Üretimde Postgres'i öldüren şey nedir?#

  1. N+1 sorgu — bir birleştirme yapın veya döngü yerine SDK'da !inner kullanın
  2. OFFSET'e göre sayfalandırma — 1000'in ötesinde, imleç tabanlı kullanın (where id > last_seen)
  3. SELECT * büyük tablolarda — yalnızca gerekli sütunları isteyin
  4. Uzun işlemler — bunlar VACUUM'u engeller ve şişmeye neden olur. 1 saniyeden az tutun
  5. Dizine Alınmamış RLS İlkeler — ilkeniz tenant_id = auth.tenant() kullanıyorsa, dizin tenant_id

Daha ileri gitmek için#