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

  1. 云栖社区>
  2. 博客>
  3. 正文

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

技术小甜 2017-11-08 14:17:00 浏览857
展开阅读全文

描述



db.collection.explain()

 

3.0版本的新功能


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

aggregate();

count();

find();

group();

remove();

update();


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

db.collection.explain().<method(...)>


例如:

1
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()来返回查询计划信息:

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

 

executionStats模式


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

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

 

allPlansExecution模式


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


注意:

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

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

 

使用修饰符解析find()


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

1
2
3
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())以返回结果:

1
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/















本文转自UltraSQL51CTO博客,原文链接:http://blog.51cto.com/ultrasql/1655359 ,如需转载请自行联系原作者





网友评论

登录后评论
0/500
评论
技术小甜
+ 关注