Retrieve Data

Encontre todos os documentos correspondentes

Para encontrar todos os documentos que correspondem aos seus critérios, use o método find() . Este método utiliza um filtro de query como parâmetro. Um filtro de query consiste nos campos e valores que formam critérios para a correspondência de documentos.

O método retorna um tipo de Cursor que você pode iterar para recuperar quaisquer documentos que correspondam aos critérios do filtro.

Para ver um exemplo que usa esse método para recuperar dados, consulte o exemplo find().

Para saber mais sobre como especificar uma query, consulte o guia Especificar uma Consulta .

Encontrar um documento

Para encontrar o primeiro documento que corresponda aos seus critérios, use o método find_one() . Este método utiliza um filtro de query como parâmetro. Um filtro de query consiste nos campos e valores que formam critérios para a correspondência de documentos.

Se um documento corresponder aos critérios de filtro, o método retornará um tipo de Result<Option<T>> com um valor de Some. Se nenhum documento corresponder aos critérios de filtro, find_one() retornará um tipo Result<Option<T>> com um valor de None.

Para ver um exemplo que usa esse método para recuperar dados, consulte o exemplo find_one().

Modificar comportamento de localização

Você pode modificar o comportamento de find() passando uma instância FindOptions como um parâmetro e você pode modificar o comportamento de find_one() passando uma instância FindOneOptions .

Para usar valores padrão para cada configuração, especifique o valor None como o parâmetro de opções.

A tabela abaixo descreve as configurações comumente usadas que você pode especificar em FindOptions e FindOneOptions:

Para obter uma lista completa de configurações que você pode especificar para cada tipo, consulte a documentação da API para FindOptions e FindOneOptions.

Exemplos

As seções seguintes contêm exemplos que utilizam os métodos find() e findOne() para recuperar documentos de amostra que correspondem aos critérios de filtro.

let opts = FindOptions::builder()
    .sort(doc! { "unit_price": -1 })
    .build();
let mut cursor = my_coll.find(
    doc! { "$and": vec!
        [
            doc! { "unit_price": doc! { "$lt": 12.00 } },
            doc! { "category": doc! { "$ne": "kitchen" } }
        ] },
    opts
).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
};

Inventory { item: "watering can", category: "garden", unit_price: 11.99 }
Inventory { item: "candle", category: "decor", unit_price: 2.89 }

let opts = FindOneOptions::builder().skip(2).build();
let result = my_coll.find_one(
    doc! { "unit_price":
        doc! { "$lte": 20.00 } },
    opts
).await?;
println!("{:#?}", result);

Some(
    Inventory {
        item: "watering can",
        category: "garden",
        unit_price: 11.99,
    },
)

Dados agregados do documento

O método aggregate() usa um aggregation pipeline como parâmetro. Um pipeline de agregação inclui um ou mais estágios que especificam como transformar dados. Um estágio inclui um operador de agregação (prefixado com um $) e quaisquer parâmetros exigidos para este operador.

Para saber mais sobre agregações e ver exemplos de agregação, consulte o Guia de agregação .

O método retorna os documentos resultantes em um tipo Cursor . Se o pipeline de agregação não contiver um estágio $match , o pipeline processará todos os documentos na coleção.

Modificar comportamento de agregação

Você pode modificar o comportamento do aggregate() passando uma instância do AggregateOptions como um parâmetro opcional.

Para usar valores padrão para cada configuração, especifique o valor None como o parâmetro de opções.

A tabela a seguir descreve as configurações comumente usadas que você pode especificar em AggregateOptions:

Para obter uma lista completa das configurações, consulte a documentação da API para AggregateOptions.

Exemplo

Este exemplo mostra como chamar o método aggregate() com um pipeline que contém os seguintes estágios:

• Um estágio $group para agrupar documentos pelo campo category e calcular a média do campo unit_price por category

• Um estágio de $sort para avg_price em ordem crescente

let pipeline = vec![
    doc! { "$group": doc! { "_id" : doc! {"category": "$category"} ,
                            "avg_price" : doc! { "$avg" : "$unit_price" } } },
    doc! { "$sort": { "_id.avg_price" : 1 } }
];
let mut cursor = my_coll.aggregate(pipeline, None).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
};

Document({"_id": Document({"category": String("decor")}), "avg_price": Double(2.890000104904175)})
Document({"_id": Document({"category": String("kitchen")}), "avg_price": Double(20.840000867843628)})
Document({"_id": Document({"category": String("garden")}), "avg_price": Double(11.989999771118164)})

Documentação da API

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

• find_one()

• find()

• Encontre opções

• FindOneOptions

• Cursor

• Aggregate()

• AggregateOptions