Definición
cursor.batchSize(size)Importante
Método mongosh
Esta página documenta una
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 afectar negativamente al rendimiento de las consultas. Si el tamaño del lote es demasiado pequeño, el cursor requiere más recorridos de ida y vuelta por la red para recuperar los resultados de la consulta, lo que puede afectar negativamente al rendimiento de la consulta.
Ajuste
batchSizea un valor apropiado para 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 se pueden devolver en cada lote de resultados de una consulta. El tamaño predeterminado del lote inicial es el menor o
101documentos o 16 mebibytes (MiB) de documentos. Los lotes posteriores tienen un tamaño máximo de 16 MiB. Esta opción puede imponer un límite menor que 16 MiB, pero no mayor. El valor predeterminado se aplica a los controladores y a Mongo Shell. Para obtener más información, 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 consulta (específicamente,)find() 10en:
db.inventory.find().batchSize(10)