Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Mongosh
/
Métodos de cursor

cursor.batchSize()

Nesta página

  • Definição
  • Exemplo
  • Saiba mais

Definição

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 é 101 documentos. Os lotes subsequentes são 16 megabytes. O padrão se aplica a drivers e Mongo Shell. Para obter detalhes, consulte Lotes de cursores.

Exemplo

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

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

Saiba mais

← cursor.allowPartialResults()
cursor.close() →

Nesta página