189 8069 5689

MongoDB3.0集合方法db.collection.explain()

MongoDB 3.0集合方法 db.collection.explain()

为青河等地区用户提供了全套网页设计制作服务,及青河网站建设行业解决方案。主营业务为网站制作、网站设计、青河网站设计,以传统方式定制建设网站,并提供域名空间备案等一条龙服务,秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求,就会得到认可,从而选择与我们长期合作。这样,我们也可以走得更远!

 

描述


db.collection.explain()

 

3.0版本的新功能

返回如下操作的查询计划信息:

aggregate();

count();

find();

group();

remove();

update();

为了使用db.collection.explain(),追加以上可用方法到db.collection.explain()来做解析:

db.collection.explain().

例如:

db.products.explain().remove({category:"apparel"},{justOne:true})

更多例子,查看下面示例部分。使用db.collection.explain()的可用方法列表,查看db.collection.explain().help()部分。

db.collection.explain()方法有如下参数:

参数 类型 描述

verbosity string 可选。指定解析输出的详细信息模式。该模式影响了explain()的行为,决定了返回信息的数量。可能的模式有:“queryPlanner”、“executionStats”和“allPlansExecution”。

默认的模式是“queryPlanner”。

为了cursor.explain()早期版本的向后兼容,MongoDB标识true为“allPlansExecution”,false为“queryPlanner”。

关于模式的更多信息,查看详细信息模式部分。

 

行为


详细信息模式

db.collection.explain()的行为和返回信息数量依赖于verbosity模式。

 

queryPlanner模式


默认情况下,db.collection.explain()运行在queryPlanner详细信息模式。

MongoDB运行查询优化器选择评估操作的最优计划。

db.collection.explain()返回被评估方法的queryPlanner信息。

 

executionStats模式


MongoDB运行查询优化器选择最优计划,执行最优计划来完成操作,并返回描述最优计划执行的统计信息。

对于写操作,db.collection.explain()返回关于将会被执行的更新或删除操作的信息,但不应用修改到数据库。

db.collection.explain()对于被评估的方法返回queryPlanner和executionStats信息。然而,executionStats对于放弃的计划不提供查询执行信息。

 

allPlansExecution模式


MongoDB运行查询优化器选择最优计划,执行最优计划来完成操作。在“allPlansExecution”模式,MongoDB返回描述最优计划的执行统计信息,也返回在计划选择期间其他备选计划的统计信息。

对于写操作,db.collection.explain()返回关于将会被执行的更新或删除操作的信息,但不应用修改到数据库。

db.collection.explain()对于被评估的方法返回queryPlanner和executionStats信息。executionStats对于最优计划博阿含完整的查询执行信息。

如果查询优化器评估了多个计划,对于最优和被放弃的备选计划,executionStats信息也包含在计划选择阶段捕获的部分执行信息。

 

explain()技巧


db.collection.explain()方法包装了explain命令,它是运行explain的更好方式。

db.collection.explain().find()类似于db.collection.find().explain()有如下关键不同:

1.db.collection.explain().find()结构允许增加查询修饰符链。列出查询修饰符列表,查看db.collection.explain().find().help()部分。

2.db.collection.explain().find()返回一个游标,它需要调用.next(),或者它的别名.finish(),以返回explain()结果。如果交互式运行在mongo shell,mongo shell会自动调用.finish()来返回结果。对于脚本,然而,你必须显式调用.next()或.finish()以返回结果。列出游标相关的方法,查看db.collection.explain().find().help()部分。

db.collection.explain().aggregate()等价于传递explain选项到db.collection.aggregate()方法。

 

help()


为了查看db.collection.explain()支持的操作的列表,运行:

db.collection.explain().help()

db.collection.explain().find()返回一个游标,它允许增加查询修饰符链。为了查看db.collection.explain().find()支持的查询修饰符的列表以及游标相关的方法,运行:

db.collection.explain().find().help()

你可以链接多个修饰符到db.collection.explain().find()。示例,可以查看使用修饰符解析find()部分。

 

示例


queryPlanner模式


默认情况下,db.collection.explain()运行在“queryPlanner”详细信息模式。

下面的示例对于指定的count()操作,以“queryPlanner”模式运行db.collection.explain()来返回查询计划信息:

db.products.explain().count( { quantity: { $gt: 50 } } )

 

executionStats模式


下面的示例对于指定的find()操作,以“executionStats”详细信息模式运行db.collection.explain()来返回查询计划和执行信息:

db.products.explain("executionStats").find(
{ quantity: { $gt: 50 }, category: "apparel" }
)

 

allPlansExecution模式


下面的示例以“allPlansExecution”详细信息模式运行db.collection.explain()。对于指定的update()操作,db.collection.explain()返回所有的评估的计划的queryPlanner和executionStats:

注意:

解析的执行将不会修改数据,但是会运行更新操作的预查询。对于备选计划,MongoDB返回在计划选择阶段捕获的执行信息。

db.products.explain("allPlansExecution").update(
{ quantity: { $lt: 1000}, category: "apparel" },
{ $set: { reorder: true } }
)

 

使用修饰符解析find()


db.collection.explain().find()结构允许查询修饰符链。例如,下面的操作提供了使用sort()和hint()查询修饰符的find()方法的信息:

db.products.explain("executionStats").find(
{ quantity: { $gt: 50 }, category: "apparel" }
).sort( { quantity: -1 } ).hint( { category: 1, quantity: -1 } )

获得可用的查询修饰符列表,在mongo shell中运行:

db.collection.explain().find().help()

 

重申explain().find()返回游标


db.collection.explain().find()返回解析结果的游标。如果在mongo shell交互式运行,mongo shell自动使用.next()方法重复这个游标。对于脚本,然而,你必须显式调用.next()(或者它的别名.finish())以返回结果:

var explainResult = db.products.explain().find( { category: "apparel" } ).next();

 

输出


db.collection.explain()操作可以返回相关信息:

1.queryPlanner,它描述了查询优化器选择的计划和列出放弃的计划;

2.executionStats,它描述了最优计划和放弃计划的执行;

3.serverInfo,它提供了关于MongoDB实例的信息。

详细信息模式(例如:queryPlanner、executionStats、allPlansExecution)决定了结果是否包含executionStats,和executionStats是否包含在计划选择阶段捕获的数据。

关于输出的详细信息,查看解析结果部分。

对于一个混合版本的分片集群,带有3.0版本的mongos和至少一个2.6版本的mongod分片,当你在3.0版本的mongo shell运行db.collection.explain(),db.collection.explain()将重试$explain操作以2.6版本格式返回结果。

 

参见:

http://docs.mongodb.org/manual/reference/method/db.collection.explain/

http://docs.mongodb.org/manual/reference/command/explain/

http://docs.mongodb.org/manual/reference/explain-results/

http://docs.mongodb.org/manual/reference/operator/meta/explain/

http://docs.mongodb.org/manual/reference/operator/query-modifier/


当前题目:MongoDB3.0集合方法db.collection.explain()
网页链接:http://cdxtjz.cn/article/geoocs.html

其他资讯