QuerySet이란 무엇이며 어떻게 지연(lazy)되나요?

Question

Accepted Answer

**QuerySet**은 데이터베이스 행의 모음을 필터링, 정렬, 체이닝할 수 있는 Python 객체로 표현합니다. 그 정의적 특성은 **지연(laziness)**입니다. QuerySet은 생성될 때 데이터베이스에 접근하지 **않으며**, 데이터가 실제로 필요할 때(평가될 때)에만 쿼리를 실행합니다. 이를 이해하는 것이 효율적인 Django 코드를 작성하는 열쇠입니다.

## QuerySet은 지연됨 — 평가될 때까지 데이터베이스 접근 없음

```python
# 이들 중 어느 것도 데이터베이스에 접근하지 않음 — 단지 쿼리를 구성할 뿐
qs = Article.objects.all()                  # 아직 쿼리 없음
qs = qs.filter(published=True)              # 여전히 쿼리 없음 — 체이닝은 지연됨
qs = qs.exclude(views=0).order_by("-created_at")   # 여전히 쿼리 없음

# QuerySet이 평가될 때에만 데이터베이스에 접근:
for article in qs:        # ← 이제 쿼리 실행
    print(article.title)
```

QuerySet을 구성하고 체이닝하는 것은 비용이 들지 않습니다. Django는 SQL을 조립하지만 실제로 결과가 필요할 때까지 실행을 미룹니다. 이로 인해 복잡한 쿼리를 단일 데이터베이스 왕복으로 효율적으로 구성할 수 있습니다.

## 무엇이 평가(데이터베이스 접근)를 유발하는가

```text
✓ 반복:        for x in qs
✓ 스텝이 있는 슬라이싱: qs[::2]  (일반 슬라이싱 qs[:10]은 지연 유지, LIMIT 추가)
✓ len(qs), list(qs), bool(qs)
✓ QuerySet이 아닌 메서드 호출: .count(), .exists(), .first(), .get(), .aggregate()
```

## 지연이 강력한 이유

```python
# 추가 데이터베이스 왕복 없이 조건부로 쿼리 구성
qs = Article.objects.all()
if search:
    qs = qs.filter(title__icontains=search)   # DB 접근 없음
if category:
    qs = qs.filter(category=category)          # DB 접근 없음
articles = qs[:20]                              # 여기서 하나의 쿼리 실행, LIMIT 20
```

지연은 여러 줄에 걸쳐 쿼리를 조건부로 구성한 다음 **한 번** 실행하게 해줍니다. 효율적이고 깔끔합니다.

## QuerySet 캐싱

```python
qs = Article.objects.filter(published=True)
list(qs)     # 쿼리 실행, 결과가 QuerySet에 캐시됨
list(qs)     # 캐시 사용 — 두 번째 쿼리 없음
# 하지만 새로운 queryset은 다시 쿼리:
Article.objects.filter(published=True)   # 새로운 queryset → 새 쿼리
```

한 번 평가되면 QuerySet은 결과를 캐시하므로, *동일한* QuerySet을 다시 반복해도 다시 쿼리하지 않습니다.

## 지연의 함정

```python
# ⚠️ .count() 호출 후 반복하면 두 개의 쿼리가 실행됨
if Article.objects.filter(published=True).count() > 0:   # 쿼리 1
    for a in Article.objects.filter(published=True):     # 쿼리 2(새 queryset!)
        ...
# ✅ 더 나음 — 한 번 평가하고 재사용
qs = list(Article.objects.filter(published=True))
if qs: ...
```

## 왜 중요한가

QuerySet과 그 지연을 이해하는 것은 효율적이고 올바른 Django 데이터베이스 코드를 작성하는 데 기초적입니다. 성능에 직접 영향을 미치며 초보자를 혼란스럽게 하는 동작을 설명합니다.

핵심 통찰은 QuerySet이 **평가될 때까지 데이터베이스에 접근하지 않는다**는 점이며, 이는 강력합니다. 여러 줄의 코드에 걸쳐 복잡한 쿼리를 구성, 필터링, 체이닝, 조건부 조립하는 데 데이터베이스 비용이 전혀 들지 않고, 실제로 결과가 필요할 때 **단일 왕복**으로 모든 것을 실행할 수 있습니다.

이는 깔끔하고 효율적인 쿼리 구성(예: 사용자 입력에 따라 조건부로 필터를 추가한 다음 하나의 쿼리 실행)을 가능하게 하며, 그렇지 않으면 어색한 SQL 문자열 빌딩이 필요했을 것입니다.

**무엇이 평가를 유발하는지**(반복, `len()`, `list()`, `.count()`, `.exists()` 등) 정확히 알고 평가된 QuerySet에 결과가 **캐시**된다는 점을 아는 것은 흔한 성능 함정을 피하는 데 필수적입니다. 가장 주목할 만한 것은 실수로 동일한 쿼리를 여러 번 실행하는 것(예: `.count()`를 호출한 다음 새로운 QuerySet을 반복하여 데이터베이스에 두 번 접근)입니다.

지연은 Django ORM을 잘 사용하기 위한 가장 중요한 개념 중 하나로, 효율적인 데이터베이스 코드를 작성하는 개발자와 자신도 모르게 중복 쿼리를 유발하는 개발자를 구분합니다. 모든 효과적인 ORM 사용과 Django 성능 최적화의 토대가 되는 핵심 지식입니다.