QuerySet

Django QuerySet

1. QuerySet이란?

DB에서 데이터를 가져온 레코드 집합 (리스트처럼 사용 가능)

Post.objects.all()  # QuerySet 객체 반환
Python
복사

QuerySet의 핵심 특징

지연 평가 (Lazy Evaluation)

•

QuerySet을 정의하는 시점에는 DB에 접근하지 않음

•

실제로 결과가 필요한 시점(이터레이션, 슬라이싱 등)에 쿼리 실행

체이닝 가능 (Chainable)

•

여러 메서드를 연결해서 사용 가능

•

각 단계마다 새로운 QuerySet 반환

반복 가능 (Iterable)

•

for 문으로 순회 가능

•

리스트처럼 인덱싱/슬라이싱 지원

캐시 (Caching)

•

한 번 실행된 QuerySet은 메모리에 캐시

•

동일한 쿼리 재실행 시 DB 접근 없이 캐시 활용

2. QuerySet 주요 메서드 요약

메서드	설명
.all()	전체 레코드 조회
.filter(조건)	조건에 맞는 레코드 추출
.get(조건)	조건에 해당하는 하나의 레코드만 (없거나 여러 개면 에러)
.exclude(조건)	조건을 제외한 레코드
.order_by('field')	정렬 (-필드명으로 내림차순)
.count()	총 개수
.exists()	존재 여부 반환 (Boolean)
.first(), .last()	첫 번째/마지막 객체 반환
.values(), .values_list()	dict 또는 tuple로 추출

3. 필터링 예제 (Field lookup)

Post.objects.filter(title__contains="장고")         # 부분 포함
Post.objects.filter(title__startswith="공지")       # 시작 단어
Post.objects.filter(title__iexact="공지사항")        # 대소문자 무시
Post.objects.filter(id__in=[1, 2, 3])               # 목록 조건
Post.objects.filter(created_at__date='2024-01-01') # 날짜 조건
Python
복사

4. 정렬

Post.objects.order_by('created_at')     # 오름차순
Post.objects.order_by('-created_at')    # 내림차순
Python
복사

5. 슬라이싱

Post.objects.all()[:5]       # 앞 5개
Post.objects.all()[5:10]     # 6~10번째
Python
복사

주의: 슬라이싱은 실제로 LIMIT OFFSET SQL이 실행됨

6. 집계 (Aggregation)

from django.db.models import Count, Avg, Max

Post.objects.aggregate(Count('id'))          # 총 개수
Post.objects.aggregate(Max('created_at'))    # 최신 날짜
Python
복사

7. 그룹별 집계 (annotate)

from django.db.models import Count

# 게시글별 댓글 수 출력
Post.objects.annotate(num_comments=Count('comment')).values('title', 'num_comments')
Python
복사

8. Q 객체 (복잡한 조건)

from django.db.models import Q

Post.objects.filter(Q(title__contains="장고") | Q(content__contains="Django"))
Post.objects.filter(Q(title__contains="공지") & Q(is_public=True))
Python
복사

9. 실습 예제

실습명	목표
게시글 검색	filter(title__contains=) 활용
정렬 및 페이징	order_by() + 슬라이싱 실습
댓글 수 집계	annotate(Count())로 출력
다중 조건 검색	Q() 객체 사용 실습

10. shell에서 연습

python manage.py shell
Shell
복사

from board.models import Post
Post.objects.filter(title__contains="장고")
Python
복사

QuerySet 체이닝

Post.objects.filter(is_public=True).order_by('-created_at')[:5]
Python
복사

QuerySet은 체이닝으로 조합 가능 → SQL 쿼리 최적화 자동 적용됨

요약

기능	코드 예시
필터링	filter(field__lookup=value)
정렬	order_by('field'), -field
개수 세기	count(), aggregate(Count('id'))
다중 조건	filter(Q(...))
값만 추출	values(), values_list()

조인

•

단일 객체 조인

◦

1:1 = post : user  (게시글 : 회원)

•

다수 객체 조인

◦

1:N = post : comment (게시글 : 댓글)

1. select_related() – 단일 객체 조인 (1:1, N:1)

•

ForeignKey, OneToOneField 관계에서 사용

•

SQL의 INNER JOIN과 유사하게 작동

예제

comments = Comment.objects.select_related('post', 'writer')

for c in comments:
    print(c.content, c.post.title, c.writer.username)
Python
복사

•

Comment → Post, User 를 JOIN

•

효율적으로 1개의 SQL 쿼리로 결과를 가져옴

2. prefetch_related() – 다수 객체 조인 (1:N, M:N)

•

역참조나 ManyToManyField에 사용

•

여러 개의 관련 객체가 있을 때 적합 (2개의 쿼리를 내부적으로 사용)

예제

posts = Post.objects.prefetch_related('comment_set')

for post in posts:
    print(f'{post.title}의 댓글들:')
    for comment in post.comment_set.all():
        print(f'  - {comment.content}')
Python
복사

•

Post → Comment JOIN

•

역참조는 related_name이 없다면 <모델명>_set으로 접근

3. 필터에서 JOIN

•

관계 필드를 __(더블 언더스코어)로 따라가면서 조건 설정

예제

# 'tester' 유저가 작성한 게시글
Post.objects.filter(writer__username='tester')

# 게시글 제목에 'Django' 포함된 댓글
Comment.objects.filter(post__title__contains='Django')
Python
복사

4. SQL로 JOIN 확인하기

qs = Comment.objects.select_related('post', 'writer')
print(qs.query)
Python
복사

•

실제 SQL JOIN 쿼리 확인 가능

요약 표

목적	메서드	관계	쿼리 수	설명
외래키/단일 객체 조인	select_related()	1:1, N:1	1	JOIN으로 함께 조회
다대다/역참조 조인	prefetch_related()	1:N, M:N	2	관련 객체를 별도 쿼리로 가져와 조인
조건에서 JOIN	filter(FK__필드)	모두	1	필터 안에서 조인 수행
SQL 확인	.query	-	-	SQL 쿼리 직접 확인

추가 예시: Post - Comment 모델

# Post → Comment (역참조)
posts = Post.objects.prefetch_related('comment_set')

# Comment → Post (정참조)
comments = Comment.objects.select_related('post')
Python
복사

필요하시면 ManyToMany, GenericForeignKey, annotate()를 활용한 집계 JOIN 예제도 제공해드릴 수 있어요.