개요
이 가이드 에서는 다음 메서드를 find 메서드에 연결하여 읽기 작업에서 반환할 문서를 지정하는 방법을 학습 수 있습니다.
샘플 데이터
이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 사용합니다. Ruby 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 Mongo::Client 객체 만들고 database 및 collection 변수에 다음 값을 할당합니다.
database = client.use('sample_restaurants') collection = database[:restaurants]
무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.
Limit
읽기 작업에서 반환되는 최대 문서 수를 지정하려면 작업에 limit 옵션을 적용 . limit setter 메서드를 find 메서드에 연결하여 이 옵션을 설정하다 수 있습니다.
다음 예시 에서는 cuisine 필드 값이 'Italian' 인 모든 레스토랑을 찾고 결과를 5 문서로 제한합니다.
filter = { cuisine: 'Italian' } collection.find(filter) .limit(5) .each { |doc| puts doc }
{"_id"=>BSON::ObjectId('...'), ... , "name"=>"Philadelhia Grille Express", "restaurant_id"=>"40364305"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Isle Of Capri Restaurant", "restaurant_id"=>"40364373"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Marchis Restaurant", "restaurant_id"=>"40364668"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Crystal Room", "restaurant_id"=>"40365013"} {"_id"=>BSON::ObjectId('...'), ... , name"=>"Forlinis Restaurant", "restaurant_id"=>"40365098"}
팁
앞의 예시 에서는 데이터베이스 에서의 기본 기본 순서 에 따라 쿼리 와 일치하는 처음 5개의 문서를 반환합니다. 다음 섹션에서는 지정된 순서대로 문서를 반환하는 방법에 대해 설명합니다.
Sort
지정된 순서로 문서를 반환하려면 읽기 작업에 sort 옵션을 적용 . sort setter 메서드를 find 메서드에 연결하여 이 옵션을 설정하다 수 있습니다.
sort를 호출할 때 결과를 정렬할 필드 와 정렬 방향을 전달합니다. 정렬 방향 값이 1 이면 값이 가장 낮은 값에서 가장 높은 값으로 정렬되고 -1 이면 가장 높은 값에서 가장 낮은 값으로 정렬됩니다.
다음 예시 cuisine 필드 값이 'Italian'인 모든 문서를 name 필드 값의 오름차순으로 정렬하여 반환합니다.
filter = { cuisine: 'Italian' } collection.find(filter) .sort(name: 1) .each { |doc| puts doc }
{"_id"=>BSON::ObjectId('...'), ... , "name"=>"(Lewis Drug Store) Locanda Vini E Olii", "restaurant_id"=>"40804423"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"101 Restaurant And Bar", "restaurant_id"=>"40560108"} ... {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Zucchero E Pomodori", "restaurant_id"=>"41189590"}
Skip
쿼리 결과를 반환하기 전에 지정된 수의 문서를 건너뛰려면 읽기 작업에 skip 옵션을 적용 . skip setter 메서드를 find 메서드에 연결하여 이 옵션을 설정하다 수 있습니다.
다음 예시 에서는 borough 필드 값이 'Manhattan' 인 모든 문서를 반환하고 처음 10 문서를 건너뜁니다.
filter = { borough: 'Manhattan' } collection.find(filter) .skip(10) .each { |doc| puts doc }
{"_id"=>BSON::ObjectId('...'), ... , "name"=>"Cafe Metro", "restaurant_id"=>"40363298"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Lexler Deli", "restaurant_id"=>"40363426"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Domino'S Pizza", "restaurant_id"=>"40363644"} ...
제한, 정렬 및 건너뛰기 결합
limit, sort 및 skip 메서드를 단일 find 메서드 호출에 연결할 수 있습니다. 이를 통해 읽기 작업에서 반환할 정렬된 최대 문서 수를 설정하다 반환하기 전에 지정된 수의 문서를 건너뛸 수 있습니다.
다음 예시 cuisine 값이 'Italian'인 5 문서를 반환합니다. 결과는 처음 10 개 문서를 건너뛰고 name 필드 값을 기준으로 오름차순으로 정렬됩니다.
filter = { cuisine: 'Italian' } collection.find(filter) .limit(5) .skip(10) .sort(name: 1) .each { |doc| puts doc }
{"_id"=>BSON::ObjectId('...'), ... , "name"=>"Acqua", "restaurant_id"=>"40871070"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Acqua Restaurant", "restaurant_id"=>"41591488"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Acqua Santa", "restaurant_id"=>"40735858"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Acquista Trattoria", "restaurant_id"=>"40813992"} {"_id"=>BSON::ObjectId('...'), ... , "name"=>"Acquolina Catering", "restaurant_id"=>"41381423"}
참고
이러한 메서드를 호출하는 순서는 반환되는 문서를 변경하지 않습니다. Ruby 운전자 호출을 자동으로 재정렬하여 정렬 작업을 먼저 수행하고 건너뛰기 작업을 수행한 다음 제한 작업을 수행합니다.
추가 정보
문서 검색에 대한 자세한 내용은 문서 찾기 가이드 참조하세요.
쿼리 지정 가이드 를 참조하세요.
API 문서
find 메서드 및 해당 옵션에 대해 자세히 학습하려면 API 설명서를 참조하세요.