mongo Shell 迭代游标

一、概述

db.collection.find()方法返回一个游标。 要访问文档，您需要迭代游标。 但是，在mongo shell中，如果未使用var关键字将返回的光标分配给变量，则该光标将自动迭代多达20次，以打印结果中的前20个文档。

以下示例描述了手动迭代游标以访问文档或使用迭代器索引的方法。

二、手动迭代游标

在mongo shell中，当使用var关键字将find()方法返回的游标分配给变量时，游标不会自动进行迭代。

您可以在shell中调用cursor变量以进行多达20次迭代，并打印匹配的文档，如以下示例所示：

mongos> var myCursor = db.inventory.find({"item" : "planner"})
mongos>
mongos> myCursor
{ "_id" : ObjectId("5e7dacb64b82ef4149831c1a"), "item" : "planner", "status" : "D", "size" : { "h" : 22.85, "w" : 30, "uom" : "cm" }, "instock" : [ { "warehouse" : "A", "qty" : 40 } ] }
{ "_id" : ObjectId("5e7dad0e4b82ef4149831c1f"), "item" : "planner", "status" : "D", "size" : { "h" : 22.85, "w" : 30, "uom" : "cm" }, "instock" : [ { "warehouse" : "A", "qty" : 40 } ] }
mongos>
mongos> print(myCursor.size())
2

你也可以使用光标方法next()来访问文档，如下面的例子所示:

var myCursor = db.users.find( { type: 2 } );

while (myCursor.hasNext()) {
   print(tojson(myCursor.next()));
}

作为另一种打印操作，可以考虑使用printjson()帮助方法来替代print(tojson()):

var myCursor = db.users.find( { type: 2 } );

while (myCursor.hasNext()) {
   printjson(myCursor.next());
}

您可以使用游标方法forEach（）来迭代游标并访问文档，如以下示例所示：

var myCursor =  db.users.find( { type: 2 } );
myCursor.forEach(printjson);

三、Iterator Index

在mongo shell中，可以使用toArray()方法迭代游标并返回数组中的文档，如下所示:

var myCursor = db.inventory.find( { type: 2 } );
var documentArray = myCursor.toArray();
var myDocument = documentArray[3];

toArray()方法将游标返回的所有文档加载到RAM中;toArray()方法将耗尽游标。

此外，一些驱动程序通过在游标上使用索引(即游标[索引])来提供对文档的访问。这是一个快捷方式，首先调用toArray()方法，然后在结果数组上使用索引。

考虑下面的例子:

var myCursor = db.users.find( { type: 2 } );
var myDocument = myCursor[1];
#myCursor [1]等效于以下示例：
myCursor.toArray() [1];

四、光标的行为

关闭不活动的游标.
默认情况下，服务器将在10分钟不活动后自动关闭游标，或者客户机已经耗尽游标。
要在mongo shell中覆盖此行为，您可以使用cursor.noCursorTimeout()方法:

var myCursor = db.users.find().noCursorTimeout();

设置noCursorTimeout选项后，您必须使用cursor.close（）手动关闭游标，或者用尽游标的结果。