Docs Home → 애플리케이션 개발 → Python 드라이버 → PyMongo
반환할 필드 지정
이 페이지의 내용
개요
이 가이드에서는 프로젝션 을 사용하여 읽기 작업에서 반환할 필드를 지정하는 방법을 배울 수 있습니다. 프로젝션은 MongoDB가 쿼리에서 반환하는 필드를 지정하는 문서입니다.
샘플 데이터
이 가이드의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants.restaurants
컬렉션을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 PyMongo시작하기 가이드를 참조하세요.
프로젝션 유형
프로젝션을 사용하여 반환 문서에 포함할 필드를 지정하거나 제외할 필드를 지정할 수 있습니다. _id
필드를 제외하지 않는 한 포함 및 제외 문을 단일 프로젝션에서 결합할 수 없습니다.
포함할 필드 지정
다음 구문을 사용하여 결과에 포함할 필드를 지정합니다.
{ "<Field Name>": 1 }
다음 예제에서는 find()
메서드를 사용하여 name
필드 값이 "Emerald Pub"
인 모든 레스토랑을 찾습니다. 그런 다음 프로젝션을 사용하여 반환된 문서에서 name
, cuisine
및 borough
필드만 반환합니다.
results = restaurants.find({ "name" : "Emerald Pub"}, {"name": 1, "cuisine": 1, "borough": 1}) for restaurant in results: print(restaurant)
{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'} {'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}
프로젝션을 사용하여 반환 문서에 포함할 필드를 지정하면 기본적으로 _id
필드도 포함됩니다. 다른 모든 필드는 암시적으로 제외됩니다. 반환 문서에서 _id
필드를 제거하려면 해당 필드를 명시적으로 제외해야 합니다.
_id
필드 제외
포함할 필드를 지정할 때 반환된 문서에서 _id
필드를 제외할 수도 있습니다.
다음 예제에서는 이전 예제와 동일한 쿼리를 수행하지만 프로젝션에서 _id
필드를 제외합니다.
results = restaurants.find({ "name" : "Emerald Pub"}, {"_id": 0, "name": 1, "cuisine": 1, "borough": 1}) for restaurant in results: print(restaurant)
{'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'} {'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}
제외할 필드 지정
다음 구문을 사용하여 결과에서 제외할 필드를 지정합니다.
{ "<Field Name>": 0 }
다음 예제에서는 find()
메서드를 사용하여 name
필드 값이 "Emerald Pub"
인 모든 레스토랑을 찾습니다. 그런 다음 프로젝션을 사용하여 반환된 문서에서 grades
및 address
필드를 제외합니다.
results = restaurants.find({ "name" : "Emerald Pub"}, {"grades": 0, "address": 0} ) for restaurant in results: print(restaurant)
{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40367329'} {'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40668598'}
프로젝션을 사용하여 제외할 필드를 지정하면 지정되지 않은 모든 필드가 반환 문서에 암시적으로 포함됩니다.
문제 해결
다음 섹션에서는 프로젝션을 사용할 때 표시될 수 있는 오류에 대해 설명합니다.
'포함 프로젝션의 <field> 필드에 대해 제외를 수행할 수 없음'
단일 프로젝션에 필드를 포함 및 제외하려고 하면 드라이버는 이 메시지와 함께 OperationFailure
를 반환합니다. 프로젝션이 포함할 필드 또는 제외할 필드만 지정하는지 확인합니다.
추가 정보
프로젝션에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 프로젝트 필드 가이드 를 참조하세요.
API 문서
이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.