通俗的说,游标(cursor)不是查询结果,而是查询返回的资源或接口,通过此接口可逐条读取,类似PHP中fopen
打开文件获取资源,通过资源可一行行读取。
游标(cursor)可从两个角度来看,客户端游标以及客户端游标表示的数据库游标。
数据库使用游标返回find查询结果,客户端对游标的实现通常能对最终结果进行有效的控制。可限制结果的数量,略过部分结果,根据任意方向任意键的组合对结果进行各种排序,或是执行其他一些功能强大的操作。
当调用find()时,shell并不立即查询数据库,而是等待真正开始要求获取结果的时候才发送查询,这样在执行之前给查询额外的选项。几乎所有游标对象的方法都返回游标本身,这样可按任意顺序组成方法链。
在服务端,游标消耗内存和其他资源,游标遍历尽结果后,或客户端发来消息要求终止,数据库将会释放这些资源。释放的资源可被数据库换做他用以保证尽快释放游标。
# 声明游标
var cursor = db.bar.find();
要想从shell中创建一个游标,首先要对集合填充文档然后对其查询,并将结果分配给一个局部变量。
# 判断游标是否取到尽头
cursor.hasNext()
# 获取游标的下一个单元
cursor.next()
要迭代结果可使用游标的next(),也可使用hasNext()来查看是否有结果。
游标的迭代
var cursor = db.foo.find();
while(cursor.hasNext()){
//do stuff
var next = cursor.next();
}
游标类实现了迭代器接口,可在 foreach 循环中使用。游标中有一个迭代函数,允许自定义回调函数来逐个处理每个单元。
var cursor = db.foo.find();
cursor.forEach(function(item){
var name = item.name;
})
游标在分页中的应用
# 查到10000行跳过100页后取10行
var cursor = db.foo.find().skip(10000).limit(10);
cursor.forEach(function(item){
printjson(item);
})
查询快照
快照后会针对不变的集合进行游标运动
db.users.find({$query:{name:'jim'}, $snapshot:true})
游标的销毁
- 客户端发来信息让其销毁
- 游标迭代完毕
- 默认游标超过10分钟自动清除
导致游标终止随后被清理的情况
首先,当游标完成匹配结果的迭代时,它会清除自身。另外,当游标在客户端已不在作用域内了,驱动会向服务器发送专门的消息,让其销毁。最后,即时用户也没有迭代完所有结果,游标也还在作用域中,10分钟不适用,数据库游标也会自动销毁。这种超时销毁的行为是我们希望的,极少有应用程序希望用户耗费时间等待结果。然而,的确有些适用希望游标持续的时间长一些,这种情况下多数驱动实现了一个叫做immortal()或类似机制,来告知数据库不要让游标超时。若关闭游标的超时时间,则一定要在迭代完结果后将其关闭,否则会一直在数据库中消耗服务器资源。