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() Los aggregate() métodos y devuelven un cursor con un lote de resultados. Repita el cursor manualmente o use toArray() para acceder a los documentos. Para más información,consulte "Repita un cursor"mongosh en.
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 crear sesiones implícitas para 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 lotes, limitados por el 16 tamaño máximo de documento BSON de MiB. Use para establecer el límite del cursor.batchSize() documento. find() y aggregate() tienen un tamaño de lote predeterminado 101 de. Las getMore operaciones posteriores no tienen límite predeterminado, solo el 16 tamaño del mensaje de MiB.
Clasificación
Las consultas con una operación de clasificación sin índice deben cargar todos los documentos en la memoria antes de devolver resultados.
Información del cursor
db.serverStatus() devuelve las métricas del cursor en el metrics.cursor campo.metrics.cursor Véase.