- Reference >
- mongo Shell Methods >
- Cursor Methods >
- cursor.count()
cursor.count()¶
说明¶
- cursor.count()¶
返回游标引用的文档记录数。在 find() 方法后追加 count() 方法来查询匹配的文档记录数。这个操作并没有执行完整的查询,它只取得本次查询可以返回的结果的数量。
The count() method has the following prototype form:
db.collection.find(<query>).count()
The count() method has the following parameter:
Parameter Type Description applySkipLimit Boolean Optional. Specifies whether to consider the effects of the cursor.skip() and cursor.limit() methods in the count. By default, the count() method ignores the effects of the cursor.skip() and cursor.limit(). Set applySkipLimit to true to consider the effect of these methods. MongoDB 提供了与 db.collection.count() 方法效果相同的 db.collection.find(<query>).count() 方法,可以任选一个使用。
行为¶
分片集群¶
在分片集群中, |计数操作| 如果存在孤立的文档记录( orphaned documents )或分片移动 ( chunk migration )进程正在运行,会返回一个 错误的 数值。
为了避免这些情况,在分片集群中,可以使用聚合函数( db.collection.aggregate() )中的 $group 操作符对集合执行求和( $sum )。例如,下面的操作计算集合中的文档数量:
db.collection.aggregate(
[
{ $group: { _id: null, count: { $sum: 1 } } }
]
)
如果想要进行带查询条件的计数,使用 $match 操作符是个好方法:
db.collection.aggregate(
[
{ $match: <query condition> },
{ $group: { _id: null, count: { $sum: 1 } } }
]
)
参见 Perform a Count 中的例子。
使用索引¶
参考包含如下索引的集合:
{ a: 1, b: 1 }
正在执行计数时,如果满足以下条件,MongoDB 会返回只用索引计算出来的数量:
查询可以使用索引
查询条件中只包含创建过索引的键,并且
查询只需要使用索引中一块连续的区域:
例如:下面的操作会返回只用索引计算的数量:
db.collection.find( { a: 5, b: 5 } ).count()
db.collection.find( { a: { $gt: 5 } } ).count()
db.collection.find( { a: 5, b: { $gt: 10 } } ).count()
无论何时,如果查询可以使用索引但不是只访问索引中一块连续的区域,或者查询条件中包含索引以外的字段,这时就不能使用索引,MongoDB 只能读取文档来返回计算的数量。
db.collection.find( { a: 5, b: { $in: [ 1, 2, 3 ] } } ).count()
db.collection.find( { a: { $gt: 5 }, b: 5 } ).count()
db.collection.find( { a: 5, b: 5, c: 5 } ).count()
在这些应用中,在一开始读取文档的时候,MongoDB 会把文档记录写到内存中,后续再次执行相同的查询时,性能会更好。
例子¶
下面是 count() 方法的一些例子。
按匹配查询计算文档数量:¶
下面的操作计算 orders 集合中 ord_dt 字段大于 new Date('01/01/2012') 的文档数量:
db.orders.find( { ord_dt: { $gt: new Date('01/01/2012') } } ).count()
计数时使用 limit 方法¶
下面的操作计算 orders 集合中 ord_dt 大于 new Date('01/01/2012') 的文档数, 体现了 limit(5) 的影响:
db.orders.find( { ord_dt: { $gt: new Date('01/01/2012') } } ).limit(5).count(true)
指定使用的索引¶
下面的操作在 orders 集合中使用 { status: 1 } 索引查询并返回 ord_dt 字段大于 new Date('01/01/2012') 并且 status 字段等于 "D" 的文档记录数。
db.orders.find(
{ ord_dt: { $gt: new Date('01/01/2012') }, status: "D" }
).hint( { status: 1 } ).count()