Docs Menu
Docs Home
/
Languages
/
Rust
/
Rust Driver
/
Fundamentals
/
Indexes

Atlas Search Indexes

On this page

  • Overview
  • Create a Search Index Model
  • Example
  • Create a Search Index
  • Example
  • Create Multiple Search Indexes
  • Example
  • List Search Indexes
  • Example
  • Update a Search Index
  • Example
  • Delete a Search Index
  • Example
  • Additional Information
  • API Documentation

Overview

In this guide, you can learn how to create and manage Atlas Search indexes. These indexes allow you to use MongoDB's Atlas Search feature to perform fast, full-text searches on data stored in an Atlas cluster. An Atlas Search index configures the behavior of Atlas Search by specifying which fields to index, how these fields are indexed, and other optional settings. To learn more about Atlas Search indexes, see the Atlas Search documentation.

This guide explains how to perform the following actions to manage your Atlas Search indexes:

Note

The examples in this guide access the posts collection in the sample_training database, which is one of the Atlas sample datasets. For instructions on importing the Atlas sample data, see Load Sample Data in the Atlas documentation.

Create a Search Index Model

To create an Atlas Search index, you must first build a SearchIndexModel instance that sets your index specifications. To begin building a SearchIndexModel instance, call the SearchIndexModel::builder() method.

Note

Instantiating Models

The Rust driver implements the Builder design pattern for the creation of some struct types, including SearchIndexModel. You can use the builder() method to construct an instance of each type by chaining option builder methods.

The Rust driver provides the following SearchIndexModel builder methods:

  • definition(), which accepts a BSON document parameter and sets your index definition

  • name(), which accepts a string parameter and sets your index name

The BSON document that you pass to the definition() builder method must include the mappings field. To automatically index all supported fields in your collection, enable dynamic mappings by setting the mappings.dynamic nested field to true. To index only specified fields, enable static mappings by setting the mappings.dynamic nested field to false and including a list of fields you want to index.

Tip

Atlas Search Field Mappings

To learn more about Atlas Search field mappings, see Define Field Mappings in the Atlas documentation.

Example

The following example creates specifications for a index named example_index in a SearchIndexModel instance. The code sets a static mapping to index only the body and date fields:

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

Create a Search Index

You can create an Atlas Search index on a collection by calling the create_search_index() method on a Collection instance. This method accepts an index model as a parameter, specified in a SearchIndexModel instance.

Example

The following example creates an Atlas Search index on the posts collection. The code creates a SearchIndexModel that sets the index name and enables dynamic mapping. Then, the code passes the SearchIndexModel instance to the create_search_index() method to create the Atlas Search index:

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"

Create Multiple Search Indexes

You can create multiple Atlas Search indexes at once by calling the create_search_indexes() method on a Collection instance. This method accepts a list of index models as a parameter, specified as a vector of SearchIndexModel instances.

Example

The following example creates two Atlas Search indexes named dynamic_index and static_index on the posts collection. The code creates SearchIndexModel instances for each index that specify the index names and definitions. Then, the code passes these models as a vector to the create_search_indexes() method and creates the indexes:

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

You can access information about a collection's existing Atlas Search indexes by calling the list_search_indexes() method on the collection.

Example

The following example accesses information about the Atlas Search indexes created in the Create Multiple Search Indexes section of this page. The code calls the list_search_indexes() method and outputs all the Atlas Search indexes on the collection:

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": [...] }

Tip

To learn more about iterating through a cursor, see the Access Data by Using a Cursor guide.

Update a Search Index

You can update an Atlas Search index by calling the update_search_index() method on a Collection instance. This method accepts the following parameters:

  • Name of the index to update

  • Modified index definition document

Example

The following example updates the Atlas Search index named static_index created in the Create Multiple Search Indexes section of this page. The code creates a new index definition document that instructs the index to use dynamic mappings instead of static mappings. Then, the code calls the update_search_index() method to update the index:

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

Delete a Search Index

You can delete an Atlas Search index by calling the delete_search_index() method on a Collection instance. This method accepts the name of the index to delete as a parameter.

Example

The following example deletes the Atlas Search index named example_index created in the Create a Search Index section of this page. The code passes the index name to the delete_search_index() method to delete the index:

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

Additional Information

To learn about other indexes you can create by using the Rust driver, see the Indexes guide.

To learn more about Atlas Search, see the following Atlas documentation:

API Documentation

To learn more about the methods and types mentioned in this guide, see the following API documentation:

Back

Indexes

Next

Transactions