Limite o número de resultados retornados

Visão geral

Neste guia, você pode aprender como usar o MongoDB Rust Driver para executar operações de limite. Estas operações especificam o número de documentos retornados de uma operação de leitura.

Use o método limit() para limitar o número de documentos que uma operação de leitura pode gerar. A operação retornará menos documentos se não houver documentos suficientes presentes para atingir o limite especificado.

Se você usar o método limit() com o método skip(), o salto será aplicado primeiro e o limite será aplicado somente aos documentos restantes. Para saber mais sobre pular operações, consulte o guia Ignorar resultados retornados.

Dados de amostra para exemplos

Os exemplos deste guia utilizam o seguinte Book estruturado como um modelo para documentos na coleção books:

#[derive(Debug, Serialize, Deserialize)]
struct Book {
    name: String,
    author: String,
    length: i32,
}

O seguinte código mostra como inserir dados de amostra na coleção books:

let uri = "connection string";
let client = Client::with_uri_str(uri).await?;
let my_coll: Collection<Book> = client.database("db").collection("books");
let books = vec![
    Book {
        name: "The Brothers Karamazov".to_string(),
        author: "Dostoyevsky".to_string(),
        length: 824,
    },
    Book {
        name: "Atlas Shrugged".to_string(),
        author: "Rand".to_string(),
        length: 1088,
    },
    Book {
        name: "Les Misérables".to_string(),
        author: "Hugo".to_string(),
        length: 1462,
    },
    Book {
        name: "A Dance with Dragons".to_string(),
        author: "Martin".to_string(),
        length: 1104,
    },
];
my_coll.insert_many(books, None).await?;

Limitar documentos

Você pode especificar o número máximo de documentos para retornar em uma query ou em um pipeline de agregação .

Exemplo de resultados da query

Para limitar o número de documentos retornados, você pode inicializar uma instância FindOptions e especificar o número de documentos que deseja limitar usando o método limit(). Em seguida, passe sua estrutura FindOptions como parâmetro para o método find().

Este exemplo executa uma operação find() que executa as seguintes ações:

Filtra os resultados para incluir apenas documentos em que o campo length é maior que 1000
Classifica os resultados em ordem crescente de seus valores de campo length
Limita os resultados aos dois primeiros documentos

let filter = doc! { "length": { "$gt": 1000 } };
let find_options = FindOptions::builder()
    .sort(doc! { "length": 1 })
    .limit(2)
    .build();
let mut cursor = my_coll.find(filter, find_options).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
}

Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }
Book { name: "A Dance with Dragons", author: "Martin", length: 1104 }

Exemplo de agregação

Você pode usar o estágio $limit em um pipeline de agregação para limitar os resultados retornados. Para saber mais sobre as operações de agregação , consulte o Guia de agregação.

Este exemplo executa um pipeline de agregação que executa as seguintes ações:

Classifica os resultados em ordem decrescente de seus valores de campo length
Limita os resultados retornados aos dois primeiros documentos

let pipeline = vec![
    doc! { "$match": {} },
    doc! { "$sort": { "length": -1 } },
    doc! { "$limit": 2 },
];
let mut cursor = my_coll.aggregate(pipeline, None).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
}

Document({"_id": ObjectId("..."), "name": String("Les Misérables"), "author": String("Hugo"), "length": Int32(1462)})
Document({"_id": ObjectId("..."), "name": String("A Dance with Dragons"), "author": String("Martin"), "length": Int32(1104)})

Informações adicionais

Para saber mais sobre as operações mencionadas neste guia, consulte os seguintes guias:

Documentação da API

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

Ignorar resultados

Escrever