Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

cursor.batchSize()

Nesta página

  • Definição
  • Compatibilidade
  • Exemplo
  • Saiba mais
cursor.batchSize(size)

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação de um driver de idioma específico, como Node.js.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Especifica o número de documentos a serem devolvidos em cada lote da resposta da instância MongoDB. Na maioria dos casos, modificar o tamanho do lote não afetará o usuário ou o aplicativo, pois mongosh e a maioria dos drivers retornam resultados como se o MongoDB retornasse um único lote.

Observação

Se o tamanho do lote for muito grande, o cursor alocará mais recursos do que necessita, o que poderá ter um impacto negativo no desempenho da query. Se o tamanho do lote for muito pequeno, o cursor exigirá mais viagens de ida e volta na rede para recuperar os resultados da query, o que pode impactar negativamente o desempenho da query.

Ajuste batchSize para um valor apropriado às suas necessidades de banco de dados, carga e aplicativo.

O método batchSize() utiliza o seguinte campo:

Campo
Tipo
Descrição
size
inteiro
O número inicial de documentos a retornar para um lote. O tamanho do lote inicial padrão é de 101 documentos. Lotes subsequentes são de 16 megabytes. O padrão se aplica a drivers e ao Mongo Shell. Para obter detalhes, consulte Lotes de cursores.

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 para todos os comandos, consulte Comandos sem suporte.

  • 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

O exemplo a seguir define batchSize para os resultados de uma query (especificamente, find()) como 10:

db.inventory.find().batchSize(10)

Voltar

cursor.allowPartialResults