ما هي QuerySets وكيف تكون كسولة (Lazy)؟

Question

Accepted Answer

يمثل **QuerySet** مجموعة من صفوف قاعدة البيانات كائن Python يمكنك تصفيته وترتيبه وربط عمليات عليه. الخاصية المميزة له هي **الكسل (Laziness)** — QuerySet **لا** يصل إلى قاعدة البيانات عند إنشاؤه؛ بل ينفذ الاستعلام فقط عندما تكون البيانات مطلوبة فعلاً (تقييم). فهم هذا هو المفتاح لكتابة كود Django فعال.

## QuerySets كسولة — لا وصول إلى قاعدة البيانات حتى التقييم

```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 لا يكلف شيئاً — Django يجمع SQL لكنه يؤجل التنفيذ حتى تحتاج فعلاً إلى النتائج. هذا يتيح لك تكوين استعلامات معقدة بكفاءة في رحلة واحدة إلى قاعدة البيانات.

## ما الذي ينشّط التقييم (وصول إلى قاعدة البيانات)

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

## لماذا الكسل قوي

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

الكسل يتيح لك تكوين استعلام بشكل مشروط عبر أسطر كثيرة، ثم تنفيذه **مرة واحدة** — فعال وأنيق.

## تخزين مؤقت لـ QuerySet

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

بمجرد التقييم، يخزن QuerySet نتائجه مؤقتاً، لذلك إعادة التكرار على نفس QuerySet لا تعيد الاستعلام.

## فخ الكسل

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

## لماذا يهمك

فهم QuerySets وكسلها أساسي لكتابة كود Django فعال وصحيح في قاعدة البيانات — إنه يؤثر مباشرة على الأداء ويشرح السلوكيات التي تربك المبتدئين.

الفكرة الرئيسية هي أن QuerySets **لا تصل إلى قاعدة البيانات حتى التقييم**، وهذا قوي: يمكنك بناء وتصفية وربط وتكوين استعلامات معقدة بشكل مشروط عبر أسطر كثيرة من الكود بدون أي تكلفة قاعدة بيانات، ثم تنفيذ كل شيء في **رحلة واحدة** عندما تحتاج فعلاً إلى النتائج.

هذا يفعّل بناء استعلام نظيف وفعال (مثلاً، إضافة عوامل تصفية بشكل مشروط بناءً على إدخال المستخدم، ثم تشغيل استعلام واحد) الذي قد يتطلب خلافاً لذلك بناء سلسلة SQL محرج.

معرفة بالضبط **ما الذي ينشّط التقييم** (التكرار، `len()`، `list()`، `.count()`، `.exists()` وغيرها) وأن النتائج **مخزنة مؤقتاً** على QuerySet المقيّم ضروري لتجنب المشاكل الأداء الشائعة — الأهم منها تشغيل نفس الاستعلام عدة مرات بالخطأ (مثلاً استدعاء `.count()` ثم التكرار على QuerySet جديد، وضرب قاعدة البيانات مرتين).

الكسل هو أحد أهم المفاهيم لاستخدام Django ORM بشكل جيد، يفصل بين المطورين الذين يكتبون كود قاعدة بيانات فعال وأولئك الذين ينشّطون استعلامات زائدة بدون وعي، مما يجعله معرفة أساسية تدعم كل استخدام فعال وتحسين أداء في Django.