Definição
cursor.limit()Importante
Método mongosh
Esta página documenta um método.
mongoshEsta não é a documentação para um driver específico de idioma, como Node.js.Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.
Use o método
limit()em um cursor para especificar o número máximo de documentos que o cursor retornará.limit()é análogo à declaraçãoLIMITem um banco de dados SQL.Observação
Você deve aplicar ao cursor antes de recuperar quaisquer documentos do banco de
limit()dados.Use para maximizar o desempenho e impedir que o MongoDB retorne mais resultados do que o necessário para o
limit()processamento.O
limit()método tem o seguinte formulário de protótipo:db.collection.find(<query>).limit(<number>)
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
- MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Observação
Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Comportamento
Valores suportados
O comportamento de é indefinido para valores menores que limit() -2 31 e maiores 2 31 que.
Você deve especificar um valor numérico limit() para.
Valor zero
Um valor limit() de 0 (ou seja, ) é equivalente a não definir nenhum.limit(0) limite.
Valores negativos
Um limite negativo é semelhante a um limite positivo, mas fecha o cursor após retornar um único lote de resultados. Assim, com um limite negativo, se o set limitado não se encaixar em um único lote, o número de documentos recebidos será menor do que o limite especificado. Ao passar um limite negativo, o cliente indica ao servidor que ele não solicitará um lote subsequente via getMore.
Usando limit() com sort()
Se estiver usando com, certifique-se de incluir pelo menos um campo em sua classificação que contenha valores exclusivos, antes de passar os limit() sort()resultados limit() para.
A classificação em campos que contêm valores duplicados pode retornar uma ordem de classificação inconsistente para esses campos duplicados em várias execuções, especialmente quando a **coleção** está recebendo gravações ativamente.
A maneira mais fácil de garantir consistência de classificação é incluir o campo _id em sua query de classificação.
Consulte Classificação consistente com o método sort() para obter mais informações.
Usando limit() com skip()
Quando você agrupa e, o método de ordem de cadeia não afeta os resultados. O servidor sempre aplica a operação de ignorar com base na ordem de classificação antes de aplicar o limite de quantos documentos devem ser skip() limit()devolvidos.
O seguinte exemplo de código mostra diferentes pedidos de cadeia skip() para e limit() que sempre produzem os mesmos resultados de querypara o mesmo conjunto de dados:
db.myColl.find().sort({_id: 1}).skip(3).limit(6); db.myColl.find().sort({_id: 1}).limit(6).skip(3);