Docs Menu

Docs Home애플리케이션 개발Python 드라이버PyMongo

반환할 문서 지정

이 페이지의 내용

  • 개요
  • 샘플 데이터
  • Limit
  • Sort
  • Skip
  • 제한, 정렬 및 건너뛰기 결합
  • 추가 정보
  • API 문서

이 가이드 에서는 다음 메서드를 사용하여 읽기 작업에서 반환할 문서를 지정하는 방법을 학습 수 있습니다.

  • limit(): 쿼리에서 반환할 최대 문서 수를 지정합니다.

  • sort(): 반환된 문서의 정렬 순서를 지정합니다.

  • skip(): 쿼리 결과를 반환하기 전에 건너뛸 문서 수를 지정합니다.

이 가이드의 예제에서는 Atlas 샘플 데이터 세트sample_restaurants.restaurants 컬렉션을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 PyMongo 시작하기를 참조하세요.

읽기 작업에서 반환되는 최대 문서 수를 지정하려면 limit() 메서드를 호출합니다.

다음 예에서는 cuisine 필드 값이 "Italian" 인 모든 레스토랑을 찾고 결과를 5 문서로 제한합니다.

results = restaurants.find({ "cuisine" : "Italian"}).limit(5)
for restaurant in results:
print(restaurant["name"])
Isle Of Capri Resturant Italian
Arturo'S Italian
Patsy'S Italian Restaurant Italian
Piccola Venezia Italian
Roadhouse Restaurant Italian

find() 메서드에 limit 매개변수를 지정하여 반환되는 문서 수를 제한할 수도 있습니다.

results = restaurants.find({ "cuisine" : "Italian"}, limit=5)
for restaurant in results:
print(restaurant["name"])
Isle Of Capri Resturant Italian
Arturo'S Italian
Patsy'S Italian Restaurant Italian
Piccola Venezia Italian
Roadhouse Restaurant Italian

앞의 예제에서는 쿼리 에서 반환된 처음 5개의 문서를 특정 순서 없이 반환합니다. 다음 섹션에서는 지정된 정렬 순서로 문서를 반환하는 방법에 대해 설명합니다.

지정된 순서로 문서를 반환하려면 sort() 메서드를 호출합니다. sort() 메서드는 결과를 정렬할 필드와 정렬 방향이라는 두 가지 매개변수를 사용합니다. 정렬 방향을 지정하려면 pymongo.ASCENDING 또는 pymongo.DESCENDING 을 지정합니다. ASCENDING 는 가장 낮은 값에서 가장 높은 값으로 값을 정렬하고 DESCENDING 는 가장 높은 값에서 가장 낮은 값으로 정렬합니다. 어느 방향이든 지정하지 않으면 메서드는 기본적으로 오름차순으로 정렬합니다.

다음 예에서는 cuisine 값이 "Italian" 인 모든 문서를 오름차순으로 정렬하여 반환합니다.

results = restaurants.find({ "cuisine" : "Italian"}).sort("name", pymongo.ASCENDING)
for restaurant in results:
print(restaurant["name"])
(Lewis Drug Store) Locanda Vini E Olii
101 Restaurant And Bar
44 Sw Ristorante & Bar
900 Park
A Voce
...
Zucchero E Pomodori

find() 메서드에 sort 매개변수를 지정하여 문서를 정렬할 수도 있습니다. 다음 예시 에서는 sort 매개 변수를 지정하여 이전 예시 와 동일한 순서로 결과를 반환합니다.

results = restaurants.find({ "cuisine" : "Italian"}, sort={"name": pymongo.ASCENDING} )
for restaurant in results:
print(restaurant["name"])
(Lewis Drug Store) Locanda Vini E Olii
101 Restaurant And Bar
44 Sw Ristorante & Bar
900 Park
A Voce
...
Zucchero E Pomodori

쿼리 결과를 반환하기 전에 지정된 수의 문서를 건너뛰려면 skip() 메서드를 호출하고 건너뛸 문서 수를 전달합니다. skip() 메서드는 쿼리 결과에서 지정된 수의 문서를 무시하고 나머지를 반환합니다.

다음 예시 에서는 borough 필드 값이 "Manhattan" 인 모든 문서를 반환하고 처음 10 문서를 건너뜁니다.

results = restaurants.find({ "borough" : "Manhattan"}).skip(10)
for restaurant in results:
print(restaurant["name"])
Dorrian'S Red Hand Restaurant
The Princeton Club
Moran'S Chelsea
La Parisienne Diner
Jimmy'S Corner
...

find() 메서드의 skip 매개변수를 사용하여 반환된 문서를 건너뛸 수도 있습니다. 다음 예시 에서는 이전 예시 와 동일한 건너뛰기를 지정합니다.

results = restaurants.find({ "borough" : "Manhattan"}, skip=10)
for restaurant in results:
print(restaurant["name"])
Dorrian'S Red Hand Restaurant
The Princeton Club
Moran'S Chelsea
La Parisienne Diner
Jimmy'S Corner
...

단일 작업으로 limit(), sort()skip() 메서드를 결합할 수 있습니다. 이렇게 하면 지정된 수의 문서를 건너뛰고 반환할 정렬된 최대 문서 수를 설정할 수 있습니다.

다음 예시 에서는 cuisine 값이 "Italian" 인 문서를 반환합니다. 결과는 처음 10 문서를 건너뛰고 알파벳순으로 정렬됩니다.

results = restaurants.find({ "cuisine" : "Italian"}) \
.sort("name", pymongo.ASCENDING) \
.limit(5) \
.skip(10)
for restaurant in results:
print(restaurant["name"])
Acqua
Acqua Restaurant
Acqua Santa
Acquista Trattoria
Acquolina Catering

참고

이러한 메서드를 호출하는 순서는 반환되는 문서를 변경하지 않습니다. 운전자 는 호출을 자동으로 재정렬하여 정렬 및 건너뛰기 작업을 먼저 수행하고 제한 작업을 나중에 수행합니다.

find() 메서드에서 결과를 매개변수로 지정하여 결과를 제한, 정렬 및 건너뛸 수도 있습니다. 다음 예시 에서는 이전 예시 와 동일한 쿼리 를 지정합니다.

results = restaurants.find({ "cuisine" : "Italian"}, limit=5, sort={"name": pymongo.ASCENDING}, skip=10)
for restaurant in results:
print(restaurant["name"])
Acqua
Acqua Restaurant
Acqua Santa
Acquista Trattoria
Acquolina Catering

쿼리 지정에 대한 자세한 내용은 쿼리 지정을 참조하세요.

문서 조회에 대한 자세한 내용은 데이터 조회를 참조하세요.

이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

← 반환할 필드 지정