쿼리 텍스트

샘플 문서

다음 섹션에서는 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

텍스트 쿼리 실행 전에 텍스트 인덱스 만들어야 합니다. 텍스트 인덱스 텍스트 쿼리 실행 문자열 또는 문자열 배열 필드 지정합니다.

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

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

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

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

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

옵션 지정

Filters.text() 메서드의 두 번째 매개 변수로 TextSearchOptions 를 포함하여 대소문자 구분과 같은 텍스트 쿼리 옵션을 지정할 수 있습니다. 기본값 으로 텍스트 쿼리는 대소문자 구분 없이 실행 쿼리 가 소문자와 대문자 값을 모두 일치시킵니다.

대소문자를 구분하는 쿼리 지정하려면 다음 스니펫을 사용하세요.

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() 메서드에 전달하여 텍스트 쿼리에 사용할 구문을 지정합니다. 이스케이프 따옴표는 큰따옴표 앞에 백슬래시 문자가 오는 문자입니다. 구문 주위에 이스케이프 따옴표를 추가하지 않으면 find() 메서드는 텀 검색을 실행합니다.

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])