クエリ テキスト

Overview

このガイドでは、 Rustドライバーを使用してテキスト クエリを実行する方法を学習できます。テキストクエリを使用すると、string 値を持つフィールドを効率的にクエリできます。

このガイドには、次のセクションが含まれています。

• 例のサンプル データ では、テキスト クエリの例で使用されるサンプルデータが提示されます

• テキストインデックスでは、文字列値フィールドにテキスト インデックスを作成する方法について説明します。

• テキストクエリ では、さまざまな検索条件でテキストクエリを実行する方法について説明します

• 集計では、集計パイプラインを使用してテキストクエリを実行する方法について説明します

• 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します

サンプルデータの例

このガイドの例では、 menuコレクション内のドキュメントのモデルとして、次の Dish構造体を使用します。

#[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

テキストクエリを実行する前に、コレクションにテキストインデックスを作成する必要があります。テキストインデックスは、テキストクエリを実行できる string または string 配列のフィールドを指定します。

このガイドの例では、 menuコレクション内のドキュメントの descriptionフィールドに対してテキスト クエリを実行します。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);
}

Dish { name: "Kale Tabbouleh", description: "A bright, herb-based salad. A perfect starter for vegetarians and vegans." }
Dish { name: "Herbed Branzino", description: "Grilled whole fish stuffed with herbs and pomegranate seeds. Serves 3-4." }

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);
}

Dish { name: "Shepherd's Pie", description: "A vegetarian take on the classic dish that uses lentils as a base. Serves 2." }
Dish { name: "Garlic Butter Trout", description: "Baked trout seasoned with garlic, lemon, dill, and, of course, butter. Serves 2." }

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);
}

Dish { name: "Kale Tabbouleh", description: "A bright, herb-based salad. A perfect starter for vegetarians and vegans." }

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);
}

Document({"name": String("Green Curry"), "score": Double(0.9166666666666667)})
Document({"name": String("Kale Tabbouleh"), "score": Double(0.5625)})
Document({"name": String("Shepherd’s Pie"), "score": Double(0.5555555555555556)})

集計

$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);
}

Document({"_id": ObjectId("..."), "name": String("Kale Tabbouleh"), "description": String("A bright, herb-based salad. A perfect starter for vegetarians and vegans.")})
Document({"_id": ObjectId("..."), "name": String("Herbed Branzino"), "description": String("Grilled whole fish stuffed with herbs and pomegranate seeds. Serves 3-4.")})

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);
}

Document({"name": String("Green Curry"), "score": Double(0.9166666666666667)})
Document({"name": String("Kale Tabbouleh"), "score": Double(0.5625)})
Document({"name": String("Shepherd’s Pie"), "score": Double(0.5555555555555556)})

詳細情報

find()メソッドを使用する実行可能な例については、「 複数のドキュメントの検索 」の使用例を参照してください。

このガイドの操作の詳細については、次のドキュメントを参照してください。

• クエリを指定する

• Retrieve Data

• 結果を並べ替える

• 集計

• Indexes

• テキスト インデックス（サーバー マニュアルの参照）

• $text （サーバー マニュアルを参照してください）

• サーバー マニュアルの$meta