Índices de búsqueda de MongoDB

Overview

En esta guía, puedes aprender cómo crear y gestionar MongoDB Search índices. Estos índices te permiten utilizar las funcionalidades de MongoDB Search para realizar búsquedas rápidas de texto completo en los datos almacenados en un clúster de Atlas. Una configuración de índice de MongoDB Search define el comportamiento de MongoDB Search especificando qué campos indexar, cómo se indexan estos campos y otras configuraciones opcionales. Para obtener más información sobre los índices de búsqueda de MongoDB, consulta la Documentación de MongoDB Search.

Esta guía explica cómo realizar las siguientes acciones para gestionar tus índices de MongoDB Search:

• Crear un modelo de índice de búsqueda

• Crear un índice de búsqueda

• Crear múltiples índices de búsqueda

• listSearchIndexes

• Actualizar un índice de búsqueda

• Eliminar un índice de búsqueda

Crear un modelo de índice de búsqueda

Para crear un índice de búsqueda de MongoDB, primero se debe compilar una instancia de SearchIndexModel que establezca las especificaciones del índice. Para empezar a construir una instancia de SearchIndexModel, llame al método SearchIndexModel::builder().

El controlador de Rust proporciona los siguientes métodos de montaje de SearchIndexModel:

• definition()que acepta un parámetro de documento BSON y establece la definición del índice.

• name(), que acepta un parámetro de string y establece el nombre del índice

El documento BSON que pase al método de construcción definition() debe incluir el campo mappings. Para indexar automáticamente todos los campos admitidos en tu colección, habilita los mapeos dinámicos configurando el campo anidado mappings.dynamic como true. Para indexar solo campos específicos, habilita los mapeos estáticos configurando el campo anidado mappings.dynamic como false e incluyendo una lista de los campos que deseas indexar.

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

Crear un índice de búsqueda

Puedes crear un índice de MongoDB Search en una colección llamando al método create_search_index() en una instancia de Collection. Este método acepta los siguientes parámetros:

• Modelo de índice, especificado en una instancia de SearchIndexModel

• Opciones de índice, especificadas en CrearOpcionesDeÍndiceDeBúsqueda instancia

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"

Crear múltiples índices de búsqueda

Puedes crear varios índices de MongoDB Search a la vez llamando al método create_search_indexes() en una instancia de Collection. Este método acepta los siguientes parámetros:

• Lista de modelos de índices, especificados como un vector de instancias SearchIndexModel

• Opciones de índice, especificadas en una instancia de 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"]

listSearchIndexes

Puedes acceder a la información sobre los índices de búsqueda existentes de una colección en MongoDB Search llamando al método list_search_indexes() en la colección. Este método acepta los siguientes parámetros:

• Nombre del índice sobre el que se va a recuperar información

• Opciones de agregación, especificadas en un AggregateOptions instancia

• Opciones de índice, especificadas en una instancia de 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": [...] }

Actualizar un índice de búsqueda

Puedes actualizar un índice de búsqueda de MongoDB llamando al método update_search_index() en una instancia Collection. Este método acepta los siguientes parámetros:

• Nombre del índice que se actualizará

• Documento de definición de índice modificado

• Opciones de índice, especificadas en una instancia UpdateSearchIndexOptions

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

Eliminar un índice de búsqueda

Puedes borrar un índice de búsqueda de MongoDB llamando al método delete_search_index() en una instancia Collection. Este método acepta los siguientes parámetros:

• Nombre del índice a eliminar

• Opciones de índice, especificadas en una instancia DropSearchIndexOptions

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

Información Adicional

Para aprender sobre otros índices que puedes crear utilizando el driver de Rust, consulta la guía de Índices.

Para obtener más información sobre MongoDB Search, consulta la siguiente documentación de Atlas:

• Mejores prácticas de MongoDB Search

• Optimiza el rendimiento de MongoDB Search

• MongoDB Search M0, M2 y M5 Limitaciones

• FAQ: MongoDB Search