Menu Docs
Página inicial do Docs
/
Idiomas
/
Rust
/
Driver Rust
/
Fundamentals
/
Indexes

Índices de pesquisa do Atlas

Nesta página

  • Visão geral
  • Crie um modelo de índice de pesquisa
  • Exemplo
  • Criar um índice de pesquisa
  • Exemplo
  • Criar múltiplos índices de pesquisa
  • Exemplo
  • Listar índices de pesquisa
  • Exemplo
  • Atualizar um Índice de Pesquisa
  • Exemplo
  • Excluir um índice de pesquisa
  • Exemplo
  • Informações adicionais
  • Documentação da API

Visão geral

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

Este guia explica como executar as seguintes ação para managed seus índice de pesquisa do Atlas Search:

Observação

Os exemplos neste guia acessam a coleção posts no banco de dados sample_training , que é um dos conjuntos de dados de amostra do Atlas. Para obter instruções sobre como importar os dados de amostra do Atlas, consulte Carregar dados de amostra na documentação do Atlas.

Crie um modelo de índice de pesquisa

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

Observação

Instanciação de modelos

O driver Rust implementa o padrão de design Builder para a criação de alguns tipos de estruturas, incluindo SearchIndexModel. Você pode usar o método builder() para construir uma instância de cada tipo encadeando métodos de construtor de opção.

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.

Dica

Mapeamentos de campo do Atlas Search

Para saber mais sobre mapeamentos de campo do Atlas Search, consulte Definir mapeamentos de campo na documentação do Atlas.

Exemplo

O exemplo a seguir cria especificações para um índice denominado example_index em uma instância SearchIndexModel . O código define um mapeamento estático para indexar somente os campos body e date :

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 Atlas Search em uma coleção chamando o método create_search_index() em uma instância Collection. Esse método aceita um modelo de índice como parâmetro, especificado em uma instância SearchIndexModel.

Exemplo

O exemplo a seguir cria um índice de pesquisa do Atlas Search na collection posts . O código cria um SearchIndexModel que define o nome do índice e habilita o mapeamento dinâmico. Em seguida, o código passa a instância SearchIndexModel para o método create_search_index() para criar o índice do Atlas Search:

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"

Criar múltiplos índices de pesquisa

Você pode criar vários índices do Atlas Search de uma só vez chamando o método create_search_indexes() em uma instância Collection. Esse método aceita uma lista de modelos de índice como um parâmetro, especificado como um vetor de instâncias SearchIndexModel.

Exemplo

O exemplo a seguir cria dois índice de pesquisa do Atlas Search denominados dynamic_index e static_index na collection posts . O código cria SearchIndexModel instâncias para cada índice que especifica os nomes e definições do índice. Em seguida, o código passa esses modelos como um vetor para o método create_search_indexes() e cria os índices:

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"]

Listar índices de pesquisa

Você pode acessar informações sobre os índices existentes do Atlas Search de uma coleção chamando o método list_search_indexes() na coleção.

Exemplo

O exemplo a seguir acessa informações sobre os índices de pesquisa do Atlas criados na seção Criar vários índices de pesquisa desta página. O código chama o método list_search_indexes() e gera todos os índices do Atlas Search na coleção:

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

Dica

Para saber mais sobre como iterar por meio de um cursor, consulte o guia Acessar dados usando um cursor.

Atualizar um Índice de Pesquisa

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

  • Nome do índice a ser atualizado

  • Documento de definição de índice modificado

Exemplo

O exemplo a seguir atualiza o índice do Atlas Search denominado static_index criado na seção Criar vários índices de pesquisa desta página. O código cria um novo documento de definição de índice que instrui o índice a usar mapeamentos dinâmicos em vez de mapeamentos estáticos. Em seguida, o código chama o método update_search_index() para atualizar o índice:

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 Atlas Search chamando o método delete_search_index() em uma instância Collection. Esse método aceita o nome do índice a ser excluído como parâmetro.

Exemplo

O exemplo seguinte exclui o índice do Atlas Search denominado example_index criado na seção Criar um Índice do Atlas Search desta página. O código passa o nome do índice para o método delete_search_index() para excluir o índice:

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 Atlas Search, consulte a seguinte documentação do Atlas:

Documentação da API

Para saber mais sobre os métodos e tipos mencionados neste guia, consulte a documentação da API abaixo:

Voltar

Indexes

Próximo

Transações