Atlas Search e índices de Vector Search

Visão geral

Neste guia, você pode aprender como criar e gerenciar índices Atlas Search e Vector Search. Esses índices permitem usar as seguintes funcionalidades:

• Atlas Search: realize pesquisas rápidas de texto completo

• Atlas Vector Search: Executar pesquisas semânticas (semelhança) em incorporações vetoriais

Os índices do Atlas Search e Vector Search especificam quais campos indexar, especificam como esses campos são indexados e definem outras configurações opcionais.

Este guia explica como executar as seguintes ações para gerenciar seus índices do Atlas Search e Vector Search :

• 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 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() .

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

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

Para saber mais sobre como definir índices do Atlas Vector Search, consulte Como indexar campos para o Vector Search na documentação do Atlas.

let def = doc! { "mappings": doc! {
    "dynamic": false,
    "fields": {
        "title": {"type": "string"},
        "released": {"type": "date"}
    }
}};
let idx_model = SearchIndexModel::builder()
    .definition(def)
    .name("search_idx".to_string())
    .index_type(SearchIndexType::Search)
    .build();

let def = doc! {
    "fields": [{
        "type": "vector",
        "path": "plot_embedding",
        "numDimensions": 1536,
        "similarity": "euclidean",
    }]
};
let idx_model = SearchIndexModel::builder()
    .definition(def)
    .name("vs_idx".to_string())
    .index_type(SearchIndexType::VectorSearch)
    .build();

Criar um índice de pesquisa

Você pode criar um índice do Atlas Search ou Vector Search em uma coleção chamando o método create_search_index() em uma instância Collection . Este método aceita um modelo de índice como um parâmetro, especificado em uma instância do SearchIndexModel.

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 múltiplos índices do Atlas Search e Vector Search chamando o método create_search_indexes() em uma instância Collection. Este método aceita um vetor de instâncias do SearchIndexModel como um parâmetro.

let as_idx = SearchIndexModel::builder()
    .definition(doc! { "mappings": doc! {"dynamic": true} })
    .name("as_idx".to_string())
    .build();
let vs_idx = SearchIndexModel::builder()
    .definition(doc! {
        "fields": [{
            "type": "vector",
            "path": "plot_embedding",
            "numDimensions": 1536,
            "similarity": "euclidean",
        }]
    })
    .name("vs_idx".to_string())
    .index_type(SearchIndexType::VectorSearch)
    .build();
let models = vec![as_idx, vs_idx];
let result = my_coll.create_search_indexes(models).await?;
println!("Created indexes:\n{:?}", result);

Created Atlas Search indexes:
["as_idx", "vs_idx"]

Listar índices de pesquisa

Você pode acessar informações sobre os índices Atlas Search e Vector Search existentes de uma coleção ligando para o método list_search_indexes() 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": "as_idx", "status": "READY", "queryable":
true, "latestDefinitionVersion": {...}, "latestDefinition": {
"mappings": { "dynamic": true } }, "statusDetail": [...] }
{ "id": "...", "name": "vs_idx", "type": "vectorSearch", "status":
"READY", "queryable": true, ..., "latestDefinition": { "fields": [{
"type": "vector", "path": "plot_embedding", "numDimensions": 1536,
"similarity": "euclidean" }] }, "statusDetail": [...] }

Atualizar um Índice de Pesquisa

Você pode atualizar um índice do Atlas Search ou Vector 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

let name = "vs_index";
let updated_def = doc! {
    "fields": [{
        "type": "vector",
        "path": "plot_embedding",
        "numDimensions": 1536,
        "similarity": "dotProduct",
    }]
};
my_coll.update_search_index(name, updated_def).await?;

Excluir um índice de pesquisa

Você pode excluir um índice do Atlas Search ou Vector Search chamando o método delete_search_index() em uma instância Collection. Este método aceita o nome do índice a ser excluído como um parâmetro.

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:

• Práticas recomendadas do Atlas Search

• Ajustar o desempenho do Atlas Search

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

• FAQ: Atlas Search

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

• Melhorar o desempenho da pesquisa vetorial

• Início rápido do Atlas Vector Search

• Como medir a precisão dos resultados da sua query