Í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 Atlas cluster. Um índice do MongoDB Search configura o comportamento do MongoDB Search especificando quais campos indexar, como esses campos são indexados e outras configurações opcionais. Para saber mais sobre os índices do MongoDB Search, consulte a documentação do MongoDB Search.

Este guia explica como executar as seguintes ações para gerenciar seus índices de pesquisa MongoDB :

• 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 do MongoDB Search, você deve primeiro construir 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 do MongoDB Search 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).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 do MongoDB Search 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).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 do MongoDB Search existentes em uma collection ligando para o método list_search_indexes() na collection. 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().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 do MongoDB Search 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).await?;

Excluir um índice de pesquisa

Você pode excluir um índice do MongoDB Search 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).await?;

Informações adicionais

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

Para saber mais sobre o MongoDB Search, consulte a seguinte documentação do Atlas :

• Práticas recomendadas de pesquisa do MongoDB

• Ajustar o desempenho da pesquisa do MongoDB

• Limitações do MongoDB Search M0, M2 e M5

• Perguntas frequentes: Pesquisa do MongoDB