Definición
cursor.batchSize(size)Importante
Método mongosh
Esta página documenta a
mongoshMétodo. Esta no es la documentación de un controlador específico del lenguaje, como Node.js.Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.
El número máximo de documentos que se pueden devolver en cada lote de un resultado de query. Por defecto, el tamaño inicial del grupo es el menor de
101documentos o 16 mebibytes (MiB) en documentos. Los grupos subsiguientes tienen un tamaño máximo de 16 MiB. Esta opción puede aplicar un límite menor que 16 MiB, pero no uno mayor. Cuando se establece,batchSizees el menor debatchSizedocumentos o 16 MiB de documentos.Un
batchSizede0significa que el cursor está establecido, pero no se devuelven documentos en el primer agrupamiento.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
batchSizea un valor correspondiente a su base de datos, carga y necesidades de la aplicación.El método toma el siguiente
batchSize()campo:CampoTipoDescripciónsizeentero
El número máximo de documentos que pueden devolverse en cada lote de un resultado de query. El tamaño inicial de agrupación por defecto es el menor entre
101documentos o 16 mebibytes (MiB) en documentos. Las tandas posteriores tienen un tamaño máximo de 16 MiB. Esta opción puede aplicar un límite menor que 16 MiB, pero no uno mayor. El valor por defecto se aplica a los controladores y Shell de Mongo. Para más detalles, consulte Lotes de Cursor.
Compatibilidad
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.
Ejemplo
El siguiente ejemplo establece batchSize para los resultados de una query (específicamente, find()) en 10:
db.inventory.find().batchSize(10)