반환할 문서 지정
개요
이 가이드 에서는 다음 메서드를 사용하여 읽기 작업에서 반환할 문서를 지정하는 방법을 학습 수 있습니다.
limit(): 쿼리 에서 반환할 최대 문서 수를 지정합니다.sort(): 반환된 문서의 정렬 순서를 지정합니다.skip(): 쿼리 결과를 반환하기 전에 건너뛸 문서 수를 지정합니다.
샘플 데이터
이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.
이 컬렉션 의 문서는 다음 코틀린 (Kotlin) 데이터 클래스에 따라 모델링됩니다.
data class Restaurant( val name: String, val borough: String, val cuisine: String )
Limit
읽기 작업에서 반환되는 최대 문서 수를 지정하려면 limit() 메서드를 호출합니다.
다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 레스토랑을 찾고 결과를 5 문서로 제한합니다.
val results = collection .find(eq(Restaurant::cuisine.name, "Italian")) .limit(5) results.forEach { result -> println(result) }
Restaurant(name=Philadelphia Grille Express, borough=Brooklyn, cuisine=Italian) Restaurant(name=Isle Of Capri Resturant, borough=Manhattan, cuisine=Italian) Restaurant(name=Marchis Restaurant, borough=Manhattan, cuisine=Italian) Restaurant(name=Crystal Room, borough=Staten Island, cuisine=Italian) Restaurant(name=Forlinis Restaurant, borough=Manhattan, cuisine=Italian)
팁
앞의 예시 에서는 쿼리 에서 반환된 처음 5개의 문서를 기본 기본 순서 반환합니다. 다음 섹션에서는 지정된 정렬 순서로 문서를 반환하는 방법에 대해 설명합니다.
Sort
지정된 순서로 문서를 반환하려면 sort() 메서드를 호출합니다. sort() 메서드는 정렬 방향을 매개 변수로 사용합니다. 정렬 방향을 지정하려면 Sorts.ascending() 또는 Sorts.descending() 메서드를 사용합니다. Sorts.ascending() 메서드는 가장 낮은 값에서 가장 높은 값으로 값을 정렬하고 Sorts.descending() 메서드는 가장 높은 값에서 가장 낮은 값으로 정렬합니다. 정렬 방향을 지정하지 않으면 sort() 은 문서를 오름차순으로 반환합니다.
다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 문서를 name 필드 값을 기준으로 오름차순으로 정렬하여 반환합니다.
val results = collection .find(eq(Restaurant::cuisine.name, "Italian")) .sort(Sorts.ascending(Restaurant::name.name)) results.forEach { result -> println(result) }
Restaurant(name=(Lewis Drug Store) Locanda Vini E Olii, borough=Brooklyn, cuisine=Italian) Restaurant(name=101 Restaurant And Bar, borough=Brooklyn, cuisine=Italian) Restaurant(name=44 Sw Ristorante & Bar, borough=Manhattan, cuisine=Italian) Restaurant(name=900 Park, borough=Bronx, cuisine=Italian) Restaurant(name=A Voce, borough=Manhattan, cuisine=Italian) ...
Skip
쿼리 결과를 반환하기 전에 지정된 수의 문서를 건너뛰려면 skip() 메서드를 호출하고 건너뛸 문서 수를 전달합니다. skip() 메서드는 쿼리 결과에서 지정된 수의 문서를 무시하고 나머지를 반환합니다.
다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 문서를 반환하고 처음 10 문서를 건너뜁니다.
val results = collection .find(eq(Restaurant::cuisine.name, "Italian")) .skip(10) results.forEach { result -> println(result) }
Restaurant(name=San Pietro, borough=Manhattan, cuisine=Italian) Restaurant(name=Manetta's Ristorante, borough=Queens, cuisine=Italian) Restaurant(name=Salvi Restaurant, borough=Brooklyn, cuisine=Italian) Restaurant(name=Tommaso Restaurant, borough=Brooklyn, cuisine=Italian) Restaurant(name=Da Rosina Restaurant, borough=Manhattan, cuisine=Italian) ...
제한, 정렬 및 건너뛰기 결합
단일 작업으로 limit(), sort() 및 skip() 메서드를 결합할 수 있습니다. 이렇게 하면 지정된 수의 문서를 건너뛰고 반환할 정렬된 최대 문서 수를 설정할 수 있습니다.
다음 예시 에서는 cuisine 필드 값이 "Italian" 인 문서를 반환합니다. 결과는 알파벳순으로 정렬되며 처음 10 문서는 건너뛰고 결과는 5 문서로 제한됩니다.
val results = collection .find(eq(Restaurant::cuisine.name, "Italian")) .sort(Sorts.ascending(Restaurant::name.name)) .skip(10) .limit(5) results.forEach { result -> println(result) }
Restaurant(name=Acqua, borough=Manhattan, cuisine=Italian) Restaurant(name=Acqua Restaurant, borough=Manhattan, cuisine=Italian) Restaurant(name=Acqua Santa, borough=Brooklyn, cuisine=Italian) Restaurant(name=Acquista Trattoria, borough=Queens, cuisine=Italian) Restaurant(name=Acquolina Catering, borough=Manhattan, cuisine=Italian)
참고
이러한 메서드를 호출하는 순서는 반환되는 문서를 변경하지 않습니다. 운전자 는 호출을 자동으로 재정렬하여 정렬 및 건너뛰기 작업을 먼저 수행하고 제한 작업을 나중에 수행합니다.
추가 정보
쿼리 지정에 대한 자세한 내용은 쿼리 지정을 참조하세요.
문서 조회에 대한 자세한 내용은 데이터 조회를 참조하세요.
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.