A el cursor apunta a los resultados de una query. Los cursores te permiten iterar sobre los resultados de la base de datos un lote a la vez.
Casos de uso
La find() y los métodos aggregate() devuelven un cursor con un agrupar de resultados. Iterar el cursor manualmente o usar toArray() para acceder a documentos. Para más información, consulta Iterar un cursor en mongosh.
Para colecciones limitadas, utiliza un cursor con seguimiento para recuperar documentos a medida que se insertan. Para más información, consulte cursores con seguimiento.
Comportamiento
MongoDB cierra los cursores creados dentro de una sesión de cliente cuando:
El cliente agota el cursor.
Cierra manualmente el cursor.
Se termina manualmente la sesión.
La sesión expira.
cursorTimeoutMillis establece el tiempo de espera para cursores inactivos (por defecto: 10 minutos). MongoDB cierra cursores inactivos fuera de sesiones después de este tiempo. Retornar un grupo extiende el tiempo de espera. Usar killCursors para cerrar manualmente los cursores.
localLogicalSessionTimeoutMinutes establece el tiempo de espera de la sesión (por defecto: 30 minutos). Utilice refreshSessions para extender una sesión y killSessions para finalizarla.
Controladores y mongosh Cree sesiones implícitas para los cursores abiertos fuera de sesiones explícitas.
Actualizaciones concurrentes mientras se utiliza un cursor
A medida que un cursor devuelve documentos, otras operaciones pueden ejecutarse en segundo plano y afectar los resultados, dependiendo del nivel de consistencia de lectura. Para más detalles, consulte Aislamiento de lectura, coherencia y actualidad.
Resultados del cursor para bases de datos mongos inexistentes
A partir de MongoDB 7.2, las consultas de la canalización de agregación que intentan utilizar bases de datos inexistentes en implementaciones de mongos devuelven errores de validación.
En versiones anteriores, estas consultas de agregación devolvían cursores vacíos.
Empezar
Detalles
Las operaciones find y aggregate se ejecutan hasta llenar un lote. Luego la query se pausa. Esta paused query es un cursor, identificado por una ID de cursor.
La base de datos devuelve el lote y el ID del cursor. Los controladores y mongosh lo almacenan en un cursor del lado del cliente. Si existen más documentos, el cursor recupera el siguiente lote mediante getMore. Utiliza cursor.objsLeftInBatch() para comprobar los resultados de los lotes restantes y cursor.hasNext() para obtener más resultados.
Agrupaciones de cursores
Los cursores devuelven resultados en agrupar, limitados por el tamaño máximo del documento BSON de 16 MiB. Usa cursor.batchSize() para establecer el límite de documentos. find() y aggregate() por defecto tienen un tamaño de lote de 101. Las operaciones getMore posteriores no tienen un límite por defecto, solo el tamaño de mensaje de 16 MiB.
Clasificación
Las consultas con una operación de ordenación sin un índice deben cargar todos los documentos en memoria antes de devolver los resultados.
Información del cursor
db.serverStatus() devuelve las métricas del cursor en el campo metrics.cursor. Ver metrics.cursor.