텍스트 검색

샘플 문서

다음 섹션에서는 fast_and_furious_movies 컬렉션에 대한 텍스트 검색의 예를 소개합니다. 각 섹션은 이름이 collection인 변수를 사용하여 fast_and_furious_movies 컬렉션의 MongoCollection 인스턴스를 참조합니다.

fast_and_furious_movies 컬렉션에는 분노의 질주(Fast and Furious) 영화 프랜차이즈의 일부인 여러 영화 중 하나를 설명하는 문서가 포함되어 있습니다. 각 문서에는 제목 필드와 태그 필드가 있습니다.

{ "_id": 1, "title": "2 Fast 2 Furious ", "tags": ["undercover", "drug dealer"] }
{ "_id": 2, "title": "Fast 5", "tags": ["bank robbery", "full team"] }
{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] }
{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }

이 데이터는 다음 Kotlin 데이터 클래스로 모델링됩니다.

data class Movies(
    @BsonId val id: Int,
    val title: String,
    val tags: List<String>
)

Text Index

텍스트 검색을 실행하기 전에 텍스트 인덱스를 만들어야 합니다. 텍스트 인덱스는 텍스트 검색을 실행할 문자열 또는 문자열 배열 필드를 지정합니다.

다음 예시에서는 fast_and_furious_movies 컬렉션의 title 필드에 대해 텍스트 검색을 실행합니다. title 필드에서 텍스트 검색을 활성화하려면 인덱스 빌더를 사용하여 다음 스니펫으로 텍스트 인덱스를 만듭니다.

collection.createIndex(Indexes.text("title"))

자세한 내용은 다음 리소스를 참조하세요.

• 인덱스 가이드의 텍스트 인덱스 섹션

• 텍스트 인덱스 서버 수동 입력

옵션 지정

TextSearchOptions을 Filters.text() 메서드의 두 번째 매개변수로 포함하여 대/소문자 구분과 같은 텍스트 검색 옵션을 지정할 수 있습니다. 기본적으로 텍스트 검색은 대소문자 구분 없이 실행되므로 소문자와 대문자 값을 모두 검색합니다.

대소문자 구분 검색을 지정하려면 다음 코드 스니펫을 사용합니다.

val options: TextSearchOptions = TextSearchOptions().caseSensitive(true)
val filter = Filters.text("SomeText", options)

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• Filters.text()

• TextSearchOptions

용어로 텍스트 검색

Filters.text() 메서드에 문자열로 용어를 전달하여 텍스트 검색에서 용어를 지정합니다.

val filter = Filters.text("fast")
val findFlow = collection.find(filter)
findFlow.collect { println(it) }

Movies(id=1, title=2 Fast 2 Furious, tags=[undercover, drug dealer])
Movies(id=2, title=Fast 5, tags=[bank robbery, full team])

val filter = Filters.text("fate 7")
val findFlow = collection.find(filter)
findFlow.collect { println(it) }

Movies(id=3, title=Furious 7, tags=[emotional])
Movies(id=4, title=The Fate of the Furious, tags=[betrayal])

문구로 텍스트 검색

이스케이프 따옴표 가 포함된 구문을 Filters.text() 메서드에 전달하여 텍스트 Atlas Search에 구문을 지정합니다. 이스케이프 따옴표는 큰따옴표 앞에 백슬래시 문자가 오는 문자입니다. 구문 주위에 이스케이프 따옴표를 추가하지 않으면 find() 메서드가 텀 Atlas Search를 실행합니다.

val filter = Filters.text("\"fate of the furious\"")
val findFlow = collection.find(filter)
findFlow.collect { println(it) }

Movies(id=4, title=The Fate of the Furious, tags=[betrayal])

용어가 제외된 텍스트 검색

용어 검색에서 제외하려는 각 용어에 대해 Filters.text() 빌더 메서드에 전달하는 문자열에 빼기 기호를 용어 앞에 붙입니다.

검색에서 반환된 문서에는 텍스트 인덱스 필드에서 제외된 용어가 포함되어 있지 않습니다.

val filter = Filters.text("furious -fast")
val findFlow = collection.find(filter)
findFlow.collect { println(it) }

Movies(id=3, title=Furious 7, tags=[emotional])
Movies(id=4, title=The Fate of the Furious, tags=[betrayal])