Índices de pesquisa do MongoDB

Visão geral

Neste guia, você pode aprender como criar e gerenciar índices de pesquisa MongoDB. Esses índices permitem usar os recursos do MongoDB Search para realizar pesquisas rápidas de texto completo em dados armazenados em um cluster Atlas. Um índice de pesquisa do MongoDB configura o comportamento da pesquisa do MongoDB especificando quais campos indexar, como esses campos são indexados e outras configurações opcionais. Para saber mais sobre os índices de pesquisa do MongoDB, consulte documentação de pesquisa do MongoDB.

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

• Crie um modelo de índice de pesquisa

• Criar um índice de pesquisa

• Criar múltiplos índices de pesquisa

• Listar índices de pesquisa

• Atualizar um Índice de Pesquisa

• Excluir um índice de pesquisa

Crie um modelo de índice de pesquisa

Para criar um índice de pesquisa MongoDB, você deve primeiro criar uma instância do SearchIndexModel que define suas especificações de índice. Para começar a construir uma instância do SearchIndexModel, chame o método SearchIndexModel::builder().

O driver Rust fornece os seguintes métodos de construtor SearchIndexModel :

• definition(), que aceita um parâmetro de documento BSON e define sua definição de índice

• name(), que aceita um parâmetro de string e define o nome do índice

O documento BSON que você passa para o método construtor definition() deve incluir o campo mappings . Para indexar automaticamente todos os campos suportados na sua collection, habilite mapeamentos dinâmicos configurando o campo aninhado mappings.dynamic como true. Para indexar somente campos especificados, habilite mapeamentos estáticos configurando o campo aninhado mappings.dynamic para false e incluindo uma lista de campos que você deseja 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();

Criar um índice de pesquisa

Você pode criar um índice de pesquisa em uma coleção chamando o método create_search_index() em uma instância Collection. Este método aceita os seguintes parâmetros:

• Modelo de índice, especificado em uma instância do SearchIndexModel

• Opções de índice, especificadas em uma instância 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"

Criar múltiplos índices de pesquisa

Você pode criar vários índices de pesquisa do MongoDB de uma só vez, chamando o método create_search_indexes() em uma instância Collection. Este método aceita os seguintes parâmetros:

• Lista de modelos de índice, especificada como um vetor de SearchIndexModel instâncias

• Opções de índice, especificadas em uma instância 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"]

Listar índices de pesquisa

Você pode acessar informações sobre os índices de pesquisa existentes em uma coleção chamando o método list_search_indexes() na coleção. Este método aceita os seguintes parâmetros:

• Nome do índice para recuperar informações sobre

• Opções de aggregation, especificadas em uma instância AggregateOptions

• Opções de índice, especificadas em uma instância 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": [...] }

Atualizar um Índice de Pesquisa

Você pode atualizar um índice de pesquisa chamando o método update_search_index() em uma instância Collection. Este método aceita os seguintes parâmetros:

• Nome do índice a ser atualizado

• Documento de definição de índice modificado

• Opções de índice, especificadas em uma instância UpdateSearchIndexOptions

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

Excluir um índice de pesquisa

Você pode excluir um índice de pesquisa do MongoDB chamando o método delete_search_index() em uma instância Collection. Este método aceita os seguintes parâmetros:

• Nome do índice a ser excluído

• Opções de índice, especificadas em uma instância DropSearchIndexOptions

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

Informações adicionais

Para saber mais sobre outros índices que você pode criar usando o driver Rust, consulte o guia Índices .

Para aprender mais sobre a pesquisa MongoDB, consulte a seguinte documentação do Atlas:

• Práticas recomendadas de pesquisa do MongoDB

• Ajustar o desempenho da pesquisa do MongoDB

• Limitações da pesquisa MongoDB M0, M2 e M5

• Perguntas frequentes: Pesquisa do MongoDB