Atlas Search インデックス

Overview

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

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

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

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

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

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

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

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

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

Atlas Search インデックスを作成するには、まずインデックス仕様を設定する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();

検索インデックスを作成

コレクションに Atlas Search インデックスを作成するには、 Collectionインスタンスでcreate_search_index()メソッドを呼び出します。 このメソッドは、 SearchIndexModelインスタンスで指定されたインデックスモデルをパラメータとして受け入れます。

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).await?;
println!("Created Atlas Search index:\n{}", result);

Created Atlas Search index:
"example_index"

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

Collectionインスタンスでcreate_search_indexes()メソッドを呼び出すと、一度に複数の Atlas Search インデックスを作成できます。 このメソッドは、インデックス モデルのリストをパラメーターとして受け入れます。これはSearchIndexModelインスタンスのベクトルとして指定されます。

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).await?;
println!("Created Atlas Search indexes:\n{:?}", result);

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

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

コレクションでlist_search_indexes()メソッドを呼び出すと、コレクションの既存の Atlas Search インデックスに関する情報にアクセスできます。

let mut cursor = my_coll.list_search_indexes().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": [...] }

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

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

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

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

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

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

Atlas Search インデックスを削除するには、 Collectionインスタンスでdelete_search_index()メソッドを呼び出します。 このメソッドは、削除するインデックスの名前をパラメータとして受け入れます。

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

詳細情報

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

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

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

• Atlas Search のパフォーマンス調整

• Atlas Search M0、M2、M5 の制限

• FAQ: Atlas Search