Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /
Cursors

cursor.batchSize()

cursor.batchSize(size)

Importante

Método mongosh

Este es un método mongosh. Esta no es la documentación de Node.js ni de otros métodos de controladores específicos de lenguajes de programación.

En la mayoría de los casos, los métodos mongosh funcionan de la misma manera que los métodos tradicionales mongo métodos shell. Sin embargo, algunos métodos heredados no están disponibles en mongosh.

Para la documentación heredada de mongo shell, revisa la documentación de la versión correspondiente de MongoDB Server:

Para los controladores de la API de MongoDB, consultar la documentación específica del controlador de MongoDB para cada lenguaje.

Especifica la cantidad de documentos que se deben devolver en cada lote de la respuesta de la instancia de MongoDB. En la mayoría de los casos, modificar el tamaño del lote no afectará al usuario ni a la aplicación, ya que mongosh y la mayoría de los controladores devuelven los resultados como si MongoDB devolviera un solo lote.

Nota

Si el tamaño del lote es demasiado grande, el cursor asigna más recursos de los necesarios, lo que puede tener un impacto negativo en el rendimiento de la consulta. Si el tamaño del lote es demasiado pequeño, el cursor necesita más viajes de ida y vuelta a la red para recuperar los resultados de la query, lo que puede afectar negativamente el rendimiento de la query.

Ajuste batchSize a un valor correspondiente a su base de datos, carga y necesidades de la aplicación.

El método batchSize() utiliza el siguiente campo:

Campo
Tipo
Descripción

size

entero

El número inicial de documentos a devolver para un lote. El tamaño inicial por defecto de la tanda es de 101 documentos. Los lotes posteriores son de 16 megabytes. El valor por defecto se aplica a los controladores y Mongo Shell. Para obtener más información, consulta Lotes de Cursor.

Este método está disponible en implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

El siguiente ejemplo establece batchSize para los resultados de una query (específicamente, find()) en 10:

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

Volver

cursor.allowPartialResults

En esta página