cursor.batchSize()

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 é 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.

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

• 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

Exemplo

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

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

Saiba mais

• Lotes de cursores

• cursor.next()

• getMore