Kas yra QuerySets ir kaip jie yra tinginiai?

Question

Accepted Answer

**QuerySet** reiškia duomenų bazės eilučių kolekciją kaip Python objektą, kurį galite filtruoti, rūšiuoti ir sujungti. Jo pagrindinė charakteristika yra **tingumo** — QuerySet **nekreipia** duomenų bazės, kai yra sukurtas; jis vykdo užklausą tik tada, kai duomenys iš tikrųjų reikalingi (įvertinti). Tai suprasti yra raktas į efektyvaus Django kodo rašymą.

## QuerySets yra tinginiai — nėra duomenų bazės kreipimosi kol nėra įvertinti

```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)
```

QuerySet kūrimas ir sujungimas nieko nekainuoja — Django surinkta SQL, bet atidėtas vykdymas, kol iš tikrųjų reikalingi rezultatai. Tai leidžia efektyviai sudaryti sudėtingas užklausas viename duomenų bazės kelyje.

## Kas sukelia įvertinimą (duomenų bazės kreipimasi)

```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()
```

## Kodėl tingumo yra galingas

```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
```

Tingumo leidžia sąlyginai sudaryti užklausą per daug linijų, tada ją vykdyti **vieną kartą** — efektyviai ir šviesiai.

## QuerySet talpinimas

```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
```

Kai tik įvertinti, QuerySet talpina savo rezultatus, todėl to paties QuerySet kartotinis kartojimas iš naujo neklausė.

## Tingumo spąstai

```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: ...
```

## Kodėl tai svarbu

Suprasti QuerySets ir jų tingumo yra pagrindinė sąlyga norint rašyti efektyvų ir teisingą Django duomenų bazės kodą — tai tiesiogiai veikia našumą ir paaiškina elgesį, kuris suglumina pradedančiuosius.

Pagrindinė nuomonė yra ta, kad QuerySets **nekreipia duomenų bazės kol nėra įvertinti**, o tai yra galingas: galite kurti, filtruoti, sujungti ir sąlyginai sudaryti sudėtingas užklausas per daug kodo linijų su nuline duomenų bazės kaina, tada vykdyti viską **viename kelyje**, kai jums iš tikrųjų reikalingi rezultatai.

Tai leidžia švarų, efektyvų užklausos konstravimą (pvz., sąlyginai pridedant filtrus pagal vartotojo įvestį, tada vykdant vieną užklausą), kuris kitaip reikalautų nepatogaus SQL eilučių konstravimo.

žinojimas tiksliai **kas sukelia įvertinimą** (kartojimas, `len()`, `list()`, `.count()`, `.exists()` ir kt.) ir kad rezultatai yra **talpinti** įvertintame QuerySet yra būtinas, norint išvengti bendrų našumo spąstų — ypač netyčia vykdant tą pačią užklausą kelis kartus (pvz., iškvietus `.count()` ir tada kartojant naują QuerySet, keliose vietose kreipiantis į duomenų bazę).

Tingumo yra vienas iš svarbiausių koncepcinių faktų Django ORM naudojimui, atskiriant kūrėjus, kurie rašo efektyvų duomenų bazės kodą, nuo tų, kurie netyčia suaktyvina nereikalingas užklausas, todėl tai yra pagrindinės žinios, kurios yra pagrindas efektyviam ORM naudojimui ir našumo optimizavimui Django.