Django QuerySet API

Database에서 전달받은 객체들의 모음(list)

Python으로 작성한 코드가 SQL로 mapping되어 <QuerySet>이라는 자료 형태로 값이 넘어오게 된다.

Model Method

Methods That Don't Return QuerySets

create()

table에 데이터를 추가(insert) 해주는 method, 생성된 인스턴스 반환
<class명>.objects.create()

Category.objects.create(name='콜드브루')
<Category: Category object (1)>

#category 변수에 반환된 값을 저장하고, 생성된 data를 사용할 수 있다.
#인스턴스로 반환되므로 category.name으로 class 안에 변수에 접근할 수 있다.
category = Category.objects.create(name='콜드브루')
category.name
'콜드브루'

get()

지정된 조회 매개 변수와 일치하는 인스턴스 반환, 이 매개 변수는 필드 조회에 설명 된 형식이어야 한다.

Category.objects.get(id=1)
<Category: Category object (1)>

update()

지정한 필드의 쿼리를 업데이트
name의 '콜드브루' 값을 가진 모든 row가 update된다.

Category.objects.filter(name='콜드브루').update(name='돌체 콜드브루')
2 # 총 업데이트 되어 반환된 row의 개수

delete()

QuerySet의 모든 행에 대해 SQL 삭제
삭제 된 개체 수와 개체 유형별 삭제 횟수가 있는 dictionary를 반환한다.

Category.objects.filter(name='돌체 콜드브루').delete()
(2, {'products.Category':1}) # (삭제 된 개체수, {삭제된 개체 유형:})

save()

insert 또는 update를 수행하는 메소드
단일 객체에 대해 업데이트할 때 많이 쓰인다.

category = Category.objects.get(id=2)
<Category: Category object (2)>

category.name
'브루드커피'

category.name = 'new name'
category.save()

category.name
'new name'

exists()

filter()와 함께 사용,
filter 조건에 맞는 데이터가 있는지 조회한다.
존재시 True, 존재하지 않을시 False를 반환

Category.objects.filter(name='콜드브루').exists()
True

그 밖에 QuerySets을 반환하지 않는 메소드

get_or_create()
bulk_create()
count()
first()
last()
aggreate()

---

QuerySet 반환

<QuerySet [<"Class명": "Class명" object (1)>, <"Class명": "Class명"object (2)>]>

Methods That Return QuerySets

all()

한 테이블의 모든 레코드를 가져온다.
그 결과로 각각의 인스턴스가 포함된 QuerySet을 반환

Category.objects.all()
<QuerySet [<Category: Category object (2)>, <Category: Category object (3)>, <Category: Category object (4)>, <Category: Category object (5)>, <Category: Category object (6)>, <Category: Category object (7)>]>

for category in Category.objects.all()
					print(category.name)

#아래와 같이 인스턴스들이 담겨 있는 QuerySet이 반환되기 때문에, 모든 속성에 접근해서 데이터 관리
#Output : 티
      브루드커리
      브루드커피
      콜드브루
      콜드브루

filter() & exclude()

filter keyword 인자로 주어진 조건에 일치하는 레코드들의 QuerySet을 반환한다.

case1
Category.objects.filter(name='콜드브루')
[<Category: Category object (3)>, <Category: Category object (4)>]

case2
Category.objects.filter(name='콜드브루').filter(id=3)
[<Category: Category object (3)>]

case3
Category.objects.filter(name='콜드브루').exclude(id=3)
[<Category: Category object (4)>]

valuse()

(iterable = 반복 가능한 객체)로 사용될 때, model 인스턴스가 아닌
dictionary를 포함하는 QuerySet 반환

Category.objects.filter(name='콜드브루')
[<Category: Category object (3)>, <Category: Category object (4)>]

Category.objects.filter(name='콜드브루').values()
<QuerySet [{'id': 3, 'name': '콜드브루', 'created_at': datetime.datetime(2020, 9, 8, 5, 43, 30, 4068, tzinfo=<UTC>), 'updated_at': datetime.datetime(2020, 9, 8, 5, 43, 30, 21801, tzinfo=<UTC>)}, {'id': 4, 'name': '브루드커피', 'created_at': datetime.datetime(2020, 9, 8, 5, 43, 30, 4068, tzinfo=<UTC>), 'updated_at': datetime.datetime(2020, 9, 8, 5, 43, 30, 21801, tzinfo=<UTC>)}]>

values_list()

values_list() method는 dictionary를 반환하는 대신 반복 될 때 튜플을 반환한다는 점을 제외하면 values ()와 같다.

Category.objects.filter(name='콜드브루').values_list()
<QuerySet [(3, '콜드브루', datetime.datetime(2020, 9, 8, 5, 43, 30, 4068, tzinfo=<UTC>), datetime.datetime(2020, 9, 8, 5, 43, 30, 21801, tzinfo=<UTC>)), (4, '콜드브루', datetime.datetime(2020, 9, 8, 5, 43, 30, 4068, tzinfo=<UTC>), datetime.datetime(2020, 9, 8, 5, 43, 30, 21801, tzinfo=<UTC>))]>

Reference

Queryset_API_Reference