MongoDB Search インデックス

Overview

このガイドでは、MongoDB Search 検索インデックスを作成および管理する方法を学習できます。これらのインデックスを使用すると、 MongoDB Search 機能を使用して、Atlas クラスターに保存されているデータに対して高速で全文検索を実行できます。MongoDB Searchインデックスは、インデックスを作成するフィールド、これらのフィールドのインデックス作成方法、その他の任意設定を指定してMongoDB Searchの動作を構成します。MongoDB Search インデックスの詳細については、MongoDB Search のドキュメントを参照してください。

このガイドでは、次のアクションを実行してMongoDB 検索インデックスを管理する方法について説明します。

• 検索インデックスモデルの作成

• 検索インデックスを作成

• 複数の検索インデックスの作成

• 検索インデックスをリストする

• 検索インデックスをアップデートする

• 検索インデックスを削除する

検索インデックスモデルの作成

MongoDB検索インデックスを作成するには、まずインデックス仕様を設定する SearchIndexModelインスタンスをビルドする必要があります。SearchIndexModelインスタンス の構築を開始するには、SearchIndexModel::builder() メソッドを呼び出します。

Rust ドライバーは、次のSearchIndexModelビルダ メソッドを提供します。

• definition()は、 BSON ドキュメント パラメータを受け入れ、インデックス定義を設定します

• name()は、string パラメータを受け入れ、インデックス名を設定します

definition()ビルダー メソッドに渡す BSON ドキュメントには、 mappingsフィールドを含める必要があります。 コレクション内のサポートされているすべてのフィールドを自動的にインデックス化するには、 mappings.dynamicのネストされたフィールドをtrueに設定して動的マッピングを有効にします。 指定されたフィールドのみをインデックス化するには、 mappings.dynamicのネストされたフィールドをfalseに設定し、インデックスを作成するフィールドのリストを含めて静的マッピングを有効にします。

let def = doc! { "mappings": doc! {
    "dynamic": false,
    "fields": {
        "body": {"type": "string"},
        "date": {"type": "date"}
    }
}};
let idx_model = SearchIndexModel::builder()
    .definition(def)
    .name("example_index".to_string())
    .build();

検索インデックスを作成

MongoDBの検索インデックスは、Collectionインスタンスでcreate_search_index()メソッドを呼び出すことで、コレクションに作成できます。このメソッドは次のパラメーターを受け入れます:

• インデックス モデル（ SearchIndexModelインスタンスで指定）

• インデックス オプション（CreateSearchIndexOptionsインスタンスで指定）

let idx_model = SearchIndexModel::builder()
    .definition(doc! { "mappings": doc! {"dynamic": true} })
    .name("example_index".to_string())
    .build();
let result = my_coll.create_search_index(idx_model, None).await?;
println!("Created MongoDB Search index:\n{}", result);

Created MongoDB Search index:
"example_index"

複数の検索インデックスの作成

Collectionインスタンスで create_search_indexes() メソッドを呼び出すと、一度に複数のMongoDB 検索インデックスを作成できます。このメソッドは次のパラメーターを受け入れます:

• インデックス モデルのリスト（ SearchIndexModelインスタンスのベクトルとして指定）

• インデックス オプション（ CreateSearchIndexOptionsインスタンスで指定）

let dyn_idx = SearchIndexModel::builder()
    .definition(doc! { "mappings": doc! {"dynamic": true} })
    .name("dynamic_index".to_string())
    .build();
let static_idx = SearchIndexModel::builder()
    .definition(doc! {"mappings": doc! { "dynamic": false, "fields": {
    "title": {"type": "string"}}}})
    .name("static_index".to_string())
    .build();
let models = vec![dyn_idx, static_idx];
let result = my_coll.create_search_indexes(models, None).await?;
println!("Created MongoDB Search indexes:\n{:?}", result);

Created MongoDB Search indexes:
["dynamic_index", "static_index"]

検索インデックスをリストする

コレクションで list_search_indexes() メソッドを呼び出すと、コレクションの既存のMongoDB 検索インデックスに関する情報にアクセスできます。このメソッドは次のパラメーターを受け入れます:

• に関する情報を検索するインデックスの名前

• AggregateOptionsインスタンスで指定される集計オプション

• インデックス オプション（ ListSearchIndexOptionsインスタンスで指定）

let mut cursor = my_coll.list_search_indexes(None, None, None).await?;
while let Some(index) = cursor.try_next().await? {
    println!("{}\n", index);
}

{ "id": "...", "name": "dynamic_index", "status": "READY", "queryable": true, "latestDefinitionVersion": {...},
"latestDefinition": { "mappings": { "dynamic": true } }, "statusDetail": [...] }
{ "id": "...", "name": "static_index", "status": "READY", "queryable": true, "latestDefinitionVersion": {...},
"latestDefinition": { "mappings": { "dynamic": false, "fields": { "title": { "type": "string" } } } },
"statusDetail": [...] }

検索インデックスをアップデートする

MongoDBの検索インデックスを更新するには、Collectionインスタンスでupdate_search_index()メソッドを呼び出します。このメソッドは次のパラメーターを受け入れます:

• 更新するインデックスの名前

• 変更されたインデックス定義ドキュメント

• UpdateSearchIndexOptionsインスタンスで指定される インデックス オプション

let name = "static_index";
let definition = doc! { "mappings": doc! {"dynamic": true} };
my_coll.update_search_index(name, definition, None).await?;

検索インデックスを削除する

MongoDBの検索インデックスを削除するには、Collectionインスタンスでdelete_search_index()メソッドを呼び出します。このメソッドは次のパラメーターを受け入れます:

• 削除するインデックスの名前

• DropSearchIndexOptionsインスタンスで指定される インデックス オプション

let name = "example_index";
my_coll.drop_search_index(name, None).await?;

詳細情報

Rust ドライバーを使用して作成できるその他のインデックスの詳細については、「インデックスのガイド 」を参照してください。

MongoDB Search の詳細については、次の Atlas ドキュメントを参照してください。

• MongoDB Search のベストプラクティス

• MongoDB 検索するのパフォーマンス調整

• MongoDB 検索する M0、M2、M5 の制限

• FAQ: MongoDB Search