Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/ / /
Kotlin Sync 드라이버

Atlas Search 쿼리 실행

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 사용하여 컬렉션 에서 Atlas Search 쿼리를 실행 방법을 학습 수 있습니다. Atlas Search 사용하면 MongoDB Atlas 에서 호스팅되는 컬렉션에서 전체 텍스트 검색을 수행할 수 있습니다. Atlas Search 인덱스는 검색 동작과 인덱스 할 필드를 지정합니다.

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트sample_mflix 데이터베이스 에 있는 movies 컬렉션 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 Atlas 시작하기 가이드를 참조하세요. 집계 작업 및 빌더 에 대해 자세히 학습 애그리게이션 작업 가이드 참조하세요.

이 섹션은 집계 파이프라인을 생성하여 컬렉션에서 Atlas Search 쿼리를 실행하는 방법을 설명합니다. Aggregates.search() 빌더 메서드를 사용하여 검색 기준을 지정하는 $search 파이프라인 단계를 만들 수 있습니다. 그런 다음 aggregate() 메서드를 호출하고 파이프라인을 매개 변수로 전달합니다.

참고

MongoDB Atlas v4.2 이상에서만 사용 가능

집계 파이프라인 연산자4.2 Atlas Search 인덱스 적용되는 v 이상을 실행 MongoDB Atlas 클러스터에 호스팅되는 컬렉션에만 사용할 수 있습니다. 이 연산자의 필수 설정 및 기능에 대한 자세히 보기는 Atlas Search 설명서를 참조하세요.

Atlas Search 쿼리 실행 전에 컬렉션 에 Atlas Search 인덱스 만들어야 합니다. 프로그래밍 방식으로 Atlas Search 인덱스 만드는 방법을 학습하려면 인덱스 가이드의 검색 인덱스 만들기 섹션을 참조하세요.

이 예시 다음 조치를 수행하여 Atlas Search 쿼리 실행합니다.

  • Aggregates.search() 빌더 메서드를 사용하여 $search 스테이지를 구성하고, 드라이버에게 title 필드에 "Alabama" 단어가 포함된 문서를 쿼리하도록 지시합니다.

  • Aggregates.project() 빌더 메서드를 사용하여 $project 단계를 구성하고, 쿼리 결과에 title 필드 포함하도록 운전자 에 지시합니다.

  • 파이프라인 단계를 aggregate() 메서드에 전달하고 결과를 출력합니다.

val pipeline: List<Bson> = listOf(
search(SearchOperator.text(
fieldPath("title"), "Alabama")),
project(Projections.include("title"))
)
val results = collection.aggregate(pipeline)
results.forEach { doc ->
println(doc.toJson())
}
{"_id": {"$oid": "..."}, "title": "Alabama Moon"}
{"_id": {"$oid": "..."}, "title": "Crazy in Alabama"}
{"_id": {"$oid": "..."}, "title": "Sweet Home Alabama"}

searchMeta() 메서드를 사용하여 Atlas 전체 텍스트 검색 결과에서 메타데이터 만 반환하는 $searchMeta 파이프라인 단계를 만듭니다.

MongoDB Atlas v4.4.11 이상에서만 사용 가능

이 집계 파이프라인 연산자는 v4.4.11 이상을 실행하는 MongoDB Atlas 클러스터에서만 사용할 수 있습니다.

다음 예에서는 Atlas Search 집계 단계의 near 메타데이터를 보여 줍니다.

searchMeta(
SearchOperator.near(2010, 1, fieldPath("year"))
)

Atlas Search 에 대해 자세히 학습 Atlas 설명서에서 Atlas Search 참조하세요.

이 가이드 에 언급된 메서드에 학습 보려면 다음 API 설명서를 참조하세요.

돌아가기

데이터베이스 명령 실행

이 페이지의 내용