close() (Fechar Cursor)
Última atualização: 2026-10-09
close() (Fechar Cursor)
close() encerra um cursor antecipadamente e libera recursos do lado do servidor: `db.users.find().close()`. Chame-o quando não precisar mais dos documentos restantes, interrompendo o streaming de mais lotes pelo servidor. Ele retorna null; fechar um cursor já esgotado ou fechado não gera erro.
| Categoria | Cursor |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.find(<filter>).close()Retorno：null.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// close: processa o primeiro doc, depois fecha
const cursor = db.users.find()
if (cursor.hasNext()) {
print(cursor.next().name)
}
cursor.close()Saída：
Alice📌 Notas
- Fechar cedo explicitamente libera recursos do servidor
- Um cursor fechado não pode ser iterado
- O mongosh e a maioria dos drivers fecham automaticamente ao esgotar ou no GC
🏷️ Tags Relacionados
💡 Casos Relacionados
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QPosso iterar depois de close()?
ANão — depois de close() o cursor fica inutilizável; reexecute a consulta.
QO que acontece se eu nunca chamar close()?
ANormalmente tudo bem — cursors se limpam no esgotamento ou timeout; o close manual é apenas mais organizado ao sair cedo.
QO que close() retorna?
ARetorna null; o resultado geralmente é ignorado.
