AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

고유 필드 값 검색

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

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

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

다음 예시 restaurants 컬렉션 에 있는 borough 필드 의 고유 값을 검색합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

results = restaurants.distinct("borough")
for restaurant in results:
print(restaurant)
Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island
results = await restaurants.distinct("borough")
for restaurant in results:
print(restaurant)
Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

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

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

다음 예시 cuisine 필드 값이 "Italian"인 모든 문서에 대해 borough 필드 의 고유 값을 검색합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

results = restaurants.distinct("borough", {
"cuisine": "Italian"
})
for restaurant in results:
print(restaurant)
Bronx
Brooklyn
Manhattan
Queens
Staten Island
results = await restaurants.distinct("borough", {
"cuisine": "Italian"
})
for restaurant in results:
print(restaurant)
Bronx
Brooklyn
Manhattan
Queens
Staten Island

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

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

속성
설명

filter

고유 값을 검색할 문서를 지정하는 쿼리 필터입니다.

session

ClientSession 의 인스턴스입니다.

comment

작업에 첨부할 주석입니다.

maxTimeMS

작업 실행을 허용하는 최대 시간(밀리초)입니다.

collation

Collation 의 인스턴스입니다.

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

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
...
results = await 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 설명서를 참조하세요.