[250121] 쿼리셋(QuerySet)이란?

QuerySet이란?

1. QuerySet 정의

• QuerySet은 Django ORM(Object-Relational Mapping)의 핵심 요소로, 데이터베이스에서 특정 조건에 맞는
  객체의 리스트를 표현한다.
• 데이터를 데이터베이스에서 검색할 때 게으르게 평가(Lazy Evaluation) 된다.
  즉, 쿼리가 실제로 실행되기 전까지 데이터베이스와 상호작용하지 않는다.

---

2. QuerySet 생성 방법

1) 기본 QuerySet 생성

from myapp.models import Book

# 전체 객체 조회
books = Book.objects.all()

2) 필터링을 통한 QuerySet

# 특정 조건에 맞는 데이터만 가져오기
books_by_author = Book.objects.filter(author="John Doe")

3) QuerySet 메서드 체이닝

# 여러 조건을 조합하여 데이터 검색
books = Book.objects.filter(author="John Doe").exclude(price__lt=10).order_by('-published_date')

---

3. QuerySet 주요 메서드

1) 조회 메서드

메서드	설명
`all()`	모델의 모든 객체를 반환함
`filter(**kwargs)`	지정된 조건과 일치하는 객체만 반환함
`exclude(**kwargs)`	지정된 조건과 일치하지 않는 객체만 반환함
`get(**kwargs)`	조건과 정확히 일치하는 하나의 객체를 반환함 (결과가 없거나 여러 개일 경우 에러 발생)

예제:

books = Book.objects.filter(author="Alice")  # Alice가 저자인 책
book = Book.objects.get(id=1)               # ID가 1인 책

2) 필드 조회 옵션

Django ORM은 다양한 조회 옵션을 제공하며, 필드 이름 뒤에 조건 연산자를 붙여 사용한다.

연산자	설명
`exact`	정확히 일치하는 값 (기본값)
`iexact`	대소문자 구분 없이 정확히 일치
`contains`	지정된 값을 포함하는지 검사
`icontains`	대소문자 구분 없이 포함 여부를 검사
`startswith`	지정된 값으로 시작하는지 검사
`istartswith`	대소문자 구분 없이 시작 여부를 검사
`endswith`	지정된 값으로 끝나는지 검사
`iendswith`	대소문자 구분 없이 끝나는지 검사
`in`	주어진 값 목록 중 하나에 해당하는지 검사
`gt`, `gte`	크다 (greater than), 크거나 같다 (greater than or equal)
`lt`, `lte`	작다 (less than), 작거나 같다 (less than or equal)
`isnull`	`True`면 값이 `NULL`인지 검사
`range`	범위 내에 포함되는지 검사
`year`, `month`	날짜 필드에서 특정 연도, 월에 해당하는 객체를 필터링

예제:

# price가 20 이상인 책
books = Book.objects.filter(price__gte=20)

# 제목에 'Python'이 포함된 책 (대소문자 구분 없음)
books = Book.objects.filter(title__icontains="python")

# ID가 1, 2, 3 중 하나인 책
books = Book.objects.filter(id__in=[1, 2, 3])

# 출판일이 2023년인 책
books = Book.objects.filter(published_date__year=2023)

3) 정렬 메서드

메서드	설명
`order_by()`	데이터를 특정 필드 기준으로 정렬

예제:

# 출판일 오름차순 정렬
books = Book.objects.all().order_by('published_date')

# 출판일 내림차순 정렬
books = Book.objects.all().order_by('-published_date')

4) 데이터 관련 메서드

메서드	설명
`create()`	객체를 생성하고 데이터베이스에 저장
`save()`	객체를 저장 (수정된 내용을 저장할 때 사용)
`delete()`	객체를 삭제

예제:

# 새 객체 생성
new_book = Book.objects.create(title="New Book", author="Author", price=10)

# 객체 수정 및 저장
book = Book.objects.get(id=1)
book.price = 15
book.save()

# 객체 삭제
book.delete()

---

4. Lazy Evaluation (게으른 평가)

• QuerySet은 데이터베이스 쿼리를 즉시 실행하지 않는다.
• 데이터가 실제로 필요할 때(`list()`, 반복문, `len()` 등) 쿼리가 실행된다.

예제:

# 데이터베이스 쿼리 실행되지 않음
books = Book.objects.filter(author="John")

# 실제로 데이터를 사용하면 쿼리가 실행됨
for book in books:
    print(book.title)

---

5. QuerySet의 장점

1. Pythonic 코드: SQL 문을 작성하지 않아도 Python 코드로 데이터베이스 작업 가능
2. 데이터베이스 독립성: ORM을 사용하면 데이터베이스 종류에 의존하지 않고 코드 작성 가능
3. 안전성: SQL 인젝션 방지 기능 내장

---

6. QuerySet 정리

Django의 QuerySet은 데이터베이스와의 상호작용을 단순화하면서도 강력한 기능을 제공하며,
다음과 같은 작업을 수행할 수 있다:

• 데이터를 검색 (`filter`, `exclude` 등)
• 데이터를 정렬 (`order_by`)
• 데이터를 추가, 수정, 삭제 (`create`, `save`, `delete`)