close() (カーソルのクローズ)
最終更新:2026-10-09
close() (カーソルのクローズ)
close() はカーソルを早期に閉じ、サーバー側のリソースを解放します: `db.users.find().close()`。残りのドキュメントが不要になったときに呼び、サーバーがさらなるバッチをストリーム送信するのを止めます。null を返します。使い果たしたカーソルや閉じたカーソルを閉じてもエラーにはなりません。
| カテゴリ | カーソル |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh(シェル) |
📝 構文
db.<collection>.find(<filter>).close()
戻り値:null。
▶ 例
以下のコマンドをローカルの mongosh で実行してください(mongod が起動済みである必要があります):
// close: 最初のドキュメントを処理してから閉じる
const cursor = db.users.find()
if (cursor.hasNext()) {
print(cursor.next().name)
}
cursor.close()
出力:
Alice
📌 注意事項
- 明示的に早期クローズするとサーバーリソースを解放する
- 閉じたカーソルは反復できない
- mongosh と大半のドライバは、使い果たしまたは GC で自動クローズする
🏷️ 関連タグ
💡 関連ケース
📚 関連チュートリアル
❓ よくある質問
Qclose() の後に反復できますか?
Aできません。close() 後はカーソルが使えません。クエリを再実行してください。
Qclose() を呼ばないとどうなりますか?
A通常は問題ありません。カーソルは使い果たしやタイムアウトでクリーンアップされます。手動クローズは早期に抜ける場合にすっきりさせるだけです。
Qclose() は何を返しますか?
Anull を返します。結果は通常無視されます。