cursor.batchSize()

Definição

cursor.batchSize(size)

Importante

Método mongosh

Este é um método mongosh . Esta não é a documentação de Node.js ou de outros métodos de driver específicos da linguagem de programação.

Na maioria dos casos, os métodos mongosh funcionam da mesma forma que os métodos legado do shell mongo . No entanto, alguns métodos legado não estão disponíveis em mongosh.

Para a documentação do shell legado mongo, consulte a documentação para a release correspondente do MongoDB Server:

• mongo shell v4.4

• mongo shell v4,2

• mongo shell v4.0

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

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