텍스트 검색

개요

이 가이드에서는 Rust 드라이버를 사용하여 텍스트 검색을 실행하는 방법을 배울 수 있습니다. 텍스트 검색을 사용하면 문자열 값이 있는 필드를 효율적으로 쿼리할 수 있습니다.

이 가이드에는 다음 섹션이 포함되어 있습니다.

• 예제용 샘플 데이터는 Atlas Search 예제 텍스트에서 사용되는 샘플 데이터를 제공합니다.

• 텍스트 인덱스 는 문자열 값 필드에 텍스트 인덱스를 만드는 방법을 설명합니다.

• 텍스트 Atlas Search 는 다양한 Atlas Search 기준으로 텍스트 검색을 수행하는 방법을 설명합니다.

• 집계 는 집계 파이프라인을 사용하여 텍스트 검색을 수행하는 방법을 설명합니다.

• 추가 정보에서 이 가이드에 언급된 유형 및 메소드에 대한 리소스 및 API 문서 링크를 찾을 수 있습니다.

예시용 샘플 데이터

이 가이드의 예제에서는 다음 Dish 구조체를 menu collection의 문서 모델로 사용합니다.

#[derive(Serialize, Deserialize, Debug)]
struct Dish {
    name: String,
    description: String,
}

이 예제에서는 레스토랑에서 주문할 수 있는 요리를 설명하는 다음 샘플 문서를 사용합니다.

{ "name": "Shepherd’s Pie", "description": "A vegetarian take on the classic dish that uses lentils as a base. Serves 2." },
{ "name": "Green Curry", "description": "A flavorful Thai curry, made vegetarian with tofu. Vegetarian and vegan friendly." },
{ "name": "Herbed Branzino", "description": "Grilled whole fish stuffed with herbs and pomegranate seeds. Serves 3-4." },
{ "name": "Kale Tabbouleh", "description": "A bright, herb-based salad. A perfect starter for vegetarians and vegans." },
{ "name": "Garlic Butter Trout", "description": "Baked trout seasoned with garlic, lemon, dill, and, of course, butter. Serves 2." }

Text Index

텍스트 검색을 수행하기 전에 collection에 텍스트 인덱스 를 생성해야 합니다. 텍스트 인덱스는 텍스트 검색을 수행할 수 있는 문자열 또는 문자열 배열 필드를 지정합니다.

이 가이드의 예제에서는 collection에 있는 문서의 필드에서 텍스트 검색을 수행합니다.description menu description 필드에서 텍스트 검색을 활성화하려면 다음 코드에 표시된 대로 텍스트 인덱스를 만듭니다.

let index = IndexModel::builder()
    .keys(doc! { "description": "text" })
    .build();
let idx_res = my_coll.create_index(index).await?;

텍스트 검색

텍스트 검색은 인덱스된 필드의 값에 지정된 텀 나 구 가 포함된 문서를 조회합니다. 텀은 공백 문자를 제외한 일련의 문자입니다. 구문은 임의의 수의 공백 문자가 있는 일련의 텀입니다.

텍스트 검색을 수행하려면 쿼리 필터에 $text 평가 쿼리 연산자를 포함하고 그 뒤에 $search 필드를 포함합니다. $text 연산자는 텍스트 인덱스 필드에서 텍스트 검색을 수행하도록 지정합니다. $search 필드는 텍스트 인덱스 필드에서 검색할 용어나 구를 지정합니다.

텍스트 검색을 위한 쿼리 필터는 다음 형식을 사용합니다.

let filter = doc! { "$text": { "$search": "<search term or phrase>" } };

let filter = doc! { "$text": { "$search": "herb" } };
let mut cursor = my_coll.find(filter).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

let filter = doc! { "$text": { "$search": "\"<some phrase>\"" } };

let filter = doc! { "$text": { "$search": "\"serves 2\"" } };
let mut cursor = my_coll.find(filter).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

let filter = doc! { "$text": { "$search": "<term> -<excluded term>" } };

let filter = doc! { "$text": { "$search": "vegan -tofu" } };
let mut cursor = my_coll.find(filter).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

let filter = doc! { "$text": { "$search": "vegetarian" } };
let sort = doc! { "score": { "$meta": "textScore" } };
let projection =
    doc! { 
    "_id": 0, 
    "name": 1, 
    "score": { "$meta": "textScore" } 
};
let doc_coll: Collection<Document> = my_coll.clone_with_type();
let mut cursor = doc_coll.find(filter)
    .sort(sort)
    .projection(projection)
    .await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

집계

$match 애그리게이션 단계에 $text 평가 쿼리 연산자를 포함하여 집계 파이프라인에서 텍스트 검색을 수행할 수 있습니다.

다음 섹션에서는 find() 메서드 대신 집계 파이프라인을 사용하여 텍스트 검색을 수행하는 방법을 보여 줍니다.

let match_stage = doc! { "$match": { "$text": { "$search": "herb" } } };
let mut cursor = my_coll.aggregate([match_stage]).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

let match_stage = doc! { "$match": { "$text": { "$search": "vegetarian" } } };
let sort_stage = doc! { "$sort": { "score": { "$meta": "textScore" } } };
let proj_stage =
    doc! { "$project": { 
    "_id": 0, 
    "name": 1, 
    "score": { "$meta": "textScore" } 
} };
let pipeline = [match_stage, sort_stage, proj_stage];
let mut cursor = my_coll.aggregate(pipeline).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{:?}", doc);
}

추가 정보

find() 메서드를 사용하는 실행 가능한 예제는 여러 문서 찾기 사용 예제를 참조하세요.

이 가이드의 작업에 대해 자세히 알아보려면 다음 문서를 참조하세요.

• 쿼리 지정

• Retrieve Data

• 집계

• Indexes

• 서버 매뉴얼의 텍스트 인덱스

• MongoDB Server 매뉴얼의 $text

• 서버 매뉴얼의 $meta