반환할 필드 지정

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 사용합니다. Ruby 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 Mongo::Client 객체 만들고 database 및 collection 변수에 다음 값을 할당합니다.

database = client.use('sample_restaurants')
collection = database[:restaurants]

무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.

포함할 필드 지정

읽기 작업 결과에 특정 필드를 포함하려면 find 메서드에 대한 매개 변수에 projection 옵션을 지정합니다. 이 옵션을 설정하다 하려면 다음 구문을 사용합니다.

{ projection: { <field_name>: 1 } }

다음 예시 에서는 find 메서드를 사용하여 name 필드 값이 'Emerald Pub'인 모든 레스토랑을 찾습니다. 그런 다음 이 코드는 projection 옵션을 지정하여 일치하는 문서의 name, cuisine 및 borough 필드만 반환하도록 찾기 작업을 지시합니다.

opts = { projection: { name: 1, cuisine: 1, borough: 1 } }
collection.find({ name: 'Emerald Pub' }, opts).each do |doc|
  puts doc
end

{"_id"=>BSON::ObjectId('...'), "borough"=>"Manhattan", "cuisine"=>"American", "name"=>"Emerald Pub"}
{"_id"=>BSON::ObjectId('...'), "borough"=>"Queens", "cuisine"=>"American", "name"=>"Emerald Pub"}

프로젝션을 사용하여 반환 문서에 포함할 필드를 지정하면 기본적으로 _id 필드도 포함됩니다. 다른 모든 필드는 암시적으로 제외됩니다. 반환 문서에서 _id 필드를 제거하려면 해당 필드를 명시적으로 제외해야 합니다.

필드 제외 _id

포함할 필드를 지정할 때 반환된 문서에서 _id 필드를 제외할 수도 있습니다.

다음 예시 에서는 이전 예시 와 동일한 쿼리 를 수행하지만 프로젝션 에서 _id 필드 를 제외합니다.

opts = { projection: { name: 1, cuisine: 1, borough: 1, _id: 0 } }
collection.find({ name: 'Emerald Pub' }, opts).each do |doc|
  puts doc
end

{"borough"=>"Manhattan", "cuisine"=>"American", "name"=>"Emerald Pub"}
{"borough"=>"Queens", "cuisine"=>"American", "name"=>"Emerald Pub"}

제외할 필드 지정

읽기 작업 결과에서 특정 필드를 제외하려면 find 메서드에 대한 매개 변수에 projection 옵션을 지정합니다. 이 옵션을 설정하다 하려면 다음 구문을 사용합니다.

{ projection: { <field_name>: 0 } }

다음 예시 에서는 find 메서드를 사용하여 name 필드 값이 'Emerald Pub'인 모든 레스토랑을 찾습니다. 그런 다음 이 코드는 projection 옵션을 사용하여 찾기 작업에 결과에서 grades 및 address 필드를 생략하도록 지시합니다.

opts = { projection: { grades: 0, address: 0 } }
collection.find({ name: 'Emerald Pub' }, opts).each do |doc|
  puts doc
end

{"_id"=>BSON::ObjectId('...'), "borough"=>"Manhattan", "cuisine"=>"American",
"name"=>"Emerald Pub", "restaurant_id"=>"40367329"}
{"_id"=>BSON::ObjectId('...'), "borough"=>"Queens", "cuisine"=>"American",
"name"=>"Emerald Pub", "restaurant_id"=>"40668598"}

프로젝션을 사용하여 제외할 필드를 지정하면 지정되지 않은 모든 필드가 반환 문서에 암시적으로 포함됩니다.

API 문서

메서드에 대해 find 자세히 학습 API 설명서를 참조하세요.