QuerySet'ler nedir ve nasıl tembeldirler?

Question

Accepted Answer

Bir **QuerySet**, bir Python nesnesi olarak veritabanı satırlarının koleksiyonunu temsil eder ve bu koleksiyon üzerinde filtreleme, sıralama ve zincirleme işlemleri yapabilirsiniz. Tanımlayıcı özelliği **tembellik**'tir — bir QuerySet oluşturulduğunda veritabanına **erişmez**; sorgu yalnızca veriye gerçekten ihtiyaç duyulduğunda (değerlendirildiğinde) yürütülür. Bunu anlamak, verimli Django kodu yazmanın anahtarıdır.

## QuerySet'ler tembeldir — değerlendirilene kadar veritabanına erişilmez

```python
# NONE of these touch the database — they just build up the query
qs = Article.objects.all()                  # no query yet
qs = qs.filter(published=True)              # still no query — chaining is lazy
qs = qs.exclude(views=0).order_by("-created_at")   # still no query

# the database is hit ONLY when the QuerySet is EVALUATED:
for article in qs:        # ← NOW the query runs
    print(article.title)
```

Bir QuerySet oluşturmak ve zincirleme işlemleri yapmak hiçbir maliyete neden olmaz — Django SQL'i bir araya getirir ancak sonuçlara gerçekten ihtiyaç duyulana kadar yürütmeyi ertelenir. Bu, karmaşık sorguları tek bir veritabanı bağlantısında verimli bir şekilde oluşturmanıza olanak sağlar.

## Değerlendirmeyi tetikleyen şeyler (bir veritabanı erişimi)

```text
✓ Iterating:        for x in qs
✓ Slicing with step: qs[::2]  (plain slicing qs[:10] stays lazy, adds LIMIT)
✓ len(qs), list(qs), bool(qs)
✓ Calling a non-QuerySet method: .count(), .exists(), .first(), .get(), .aggregate()
```

## Tembelliğin gücü nedir?

```python
# build a query conditionally WITHOUT extra database trips
qs = Article.objects.all()
if search:
    qs = qs.filter(title__icontains=search)   # no DB hit
if category:
    qs = qs.filter(category=category)          # no DB hit
articles = qs[:20]                              # ONE query runs here, with LIMIT 20
```

Tembellik, bir sorguyu koşullu olarak birçok satır boyunca oluşturmanıza ve ardından onu **bir kez** yürütmenize izin verir — verimli ve temiz.

## QuerySet önbelleği

```python
qs = Article.objects.filter(published=True)
list(qs)     # query runs, results CACHED on the QuerySet
list(qs)     # uses the CACHE — no second query
# BUT a NEW queryset re-queries:
Article.objects.filter(published=True)   # a fresh queryset → new query
```

Bir kez değerlendirildikten sonra, bir QuerySet sonuçlarını önbelleğe alır, bu nedenle aynı QuerySet'i yeniden yinelemek sorguyu tekrar çalıştırmaz.

## Tembellik tuzağı

```python
# ⚠️ calling .count() then iterating runs TWO queries
if Article.objects.filter(published=True).count() > 0:   # query 1
    for a in Article.objects.filter(published=True):     # query 2 (new queryset!)
        ...
# ✅ better — evaluate once, reuse
qs = list(Article.objects.filter(published=True))
if qs: ...
```

## Neden önemli

QuerySet'leri ve bunların tembelliğini anlamak, verimli ve doğru Django veritabanı kodu yazmanın temelini oluşturur — bu doğrudan performansı etkiler ve yeni başlayanları şaşırtan davranışları açıklar.

Ana fikir, QuerySet'lerin **değerlendirilene kadar veritabanına erişmemesi**'dir ve bu güçlüdür: veritabanı maliyeti olmaksızın birçok kod satırı boyunca karmaşık sorguları oluşturabilir, filtreleyebilir, zincirleyebilir ve koşullu olarak oluşturabilirsiniz, ardından sonuçlara gerçekten ihtiyaç duyduğunuzda her şeyi **tek bir bağlantıda** yürütebilirsiniz.

Bu, temiz, verimli sorgu oluşturmayı (örneğin, kullanıcı girdisine göre koşullu olarak filtreler eklemek, ardından bir sorgu çalıştırmak) sağlar; aksi takdirde garip SQL string'i oluşturma gerektirirdi.

Precise olarak **neyin değerlendirmeyi tetiklediğini** (iterasyon, `len()`, `list()`, `.count()`, `.exists()`, vb.) ve sonuçların **bir değerlendirilmiş QuerySet'te önbelleğe alındığını** bilmek, yaygın performans sorunlarını önlemek için gereklidir — özellikle aynı sorguyu yanlışlıkla birden çok kez çalıştırmak (örneğin `.count()` çağırmak ve ardından yeni bir QuerySet'i yinelemek, veritabanına iki kez erişmek) dışındakiler.

Tembellik, Django ORM'i iyi bir şekilde kullanmak için en önemli kavramlardan biridir; verimli veritabanı kodu yazan geliştiricileri bilinçsizce gereksiz sorguları tetikleyenlerden ayırır ve bu, Django'da tüm etkili ORM kullanımı ve performans optimizasyonunun temelini oluşturan temel bilgidir.