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

고유 필드 값 검색

이 페이지의 내용

개요

샘플 데이터
distinct() 메서드
컬렉션 전체에서 고유 값 검색
지정된 문서에서 고유 값 검색
고유 동작 수정
API 문서

개요

컬렉션 내에서 서로 다른 문서에는 단일 필드에 대해 서로 다른 값이 포함될 수 있습니다. 예를 들어 한 restaurant 문서의 borough 값은 "Manhattan" 이고, 다른 문서의 borough 값은 "Queens" 입니다. PyMongo를 사용하면 컬렉션의 여러 문서에서 필드에 포함된 모든 고유 값을 검색할 수 있습니다.

샘플 데이터

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

`distinct()` 메서드

지정된 필드의 고유 값을 검색하려면 distinct() 메서드를 호출하고 고유 값을 찾으려는 필드의 이름을 전달합니다.

컬렉션 전체에서 고유 값 검색

다음 예에서는 restaurants 컬렉션에 있는 borough 필드의 고유 값을 검색합니다.

results = restaurants.distinct("borough")
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

결과에는 컬렉션의 모든 문서에서 borough 필드에 나타나는 모든 고유 값이 표시됩니다. 여러 문서의 borough 필드에 동일한 값이 있지만 각 값은 결과에 한 번만 표시됩니다.

지정된 문서에서 고유 값 검색

distinct() 메서드에 쿼리 필터 를 제공하여 컬렉션의 문서 하위 집합에서 고유 필드 값을 찾을 수 있습니다. 쿼리 필터는 작업에서 문서를 일치시키는 데 사용되는 Atlas Search 기준을 지정하는 표현식입니다. 쿼리 필터 만들기에 대한 자세한 내용은 쿼리 지정을 참조하세요.

다음 예에서는 cuisine 필드 값이 "Italian" 인 모든 문서에 대해 borough 필드의 고유 값을 검색합니다.

results = restaurants.distinct("borough", {
    "cuisine": "Italian"
})
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Queens
Staten Island

고유 동작 수정

distinct() 메서드는 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 선택적 매개변수를 허용합니다. 옵션을 지정하지 않으면 드라이버는 작업을 사용자 지정하지 않습니다.

다음 표에서는 distinct() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

속성	설명
`filter`	A query filter that specifies the documents to retrieve distinct values from.
`session`	An instance of `ClientSession`.
`comment`	A comment to attach to the operation.
`maxTimeMS`	The maximum amount of time to allow the operation to run, in milliseconds.
`collation`	An instance of `Collation`.

다음 예시에서는 borough 필드 값이 "Bronx" 이고 cuisine 필드 값이 "Pizza" 인 모든 문서에 대해 name 필드의 고유 값을 검색합니다. 또한 comment 옵션을 사용하여 작업에 주석을 추가합니다.

results = restaurants.distinct("name", 
    { "borough": "Bronx", 
      "cuisine": "Pizza" }, 
    comment="Bronx pizza restaurants"
)

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
...

API 문서

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

← 문서 수 계산

커서에서 데이터 액세스 →

개요