PlanCache.listQueryShapes（）

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 查询计划缓存方法 > PlanCache.listQueryShapes（）

在本页面

定义
所需的访问
例

定义¶

PlanCache.listQueryShapes（）¶

从4.2版开始弃用。

注意

MongoDB 4.2添加了一个新的聚合管道阶段$planCacheStats，该阶段为集合提供计划缓存信息。

的$planCacheStats聚合阶段优选在下面的方法和命令，已在4.2被弃用：

PlanCache.getPlansByQuery() 方法/ planCacheListPlans命令，以及
PlanCache.listQueryShapes() 方法/ planCacheListQueryShapes命令。

显示存在缓存的查询计划的查询形状。

为了帮助识别具有相同查询形状的慢速查询，从MongoDB 4.2开始，每个查询形状都与一个queryHash关联。的queryHash是代表查询形状的散列，并且仅依赖于所述查询形状的十六进制字符串。

注意

与任何哈希函数一样，两个不同的查询形状可能会导致相同的哈希值。但是，不同查询形状之间不会发生哈希冲突。

查询优化器仅缓存那些具有多个可行计划的查询形状的计划。

该方法仅可用于特定集合的；即plan cache object

复制

db.collection.getPlanCache().listQueryShapes()

返回值：	查询形状文档的数组。

该方法包装planCacheListQueryShapes命令。

所需的访问权限¶

在运行的系统上authorization，用户必须具有包含planCacheRead操作的访问权限。

例子¶

以下返回已缓存该集合计划的查询形状orders：

复制

db.orders.getPlanCache().listQueryShapes()

该方法返回当前在缓存中的查询形状的数组。在该示例中，orders集合已缓存与以下形状关联的查询计划：

复制

[
  {
    "query" : { "qty" : { "$gt" : 10 } },
    "sort" : { "ord_date" : 1 },
    "projection" : { },
    "queryHash" : "9AAD95BE" // Available starting in MongoDB 4.2
  },
  {
    "query" : { "$or" :
       [
         { "qty" : { "$gt" : 15 }, "item" : "xyz123" },
         { "status" : "A" }
       ]
    },
    "sort" : { },
    "projection" : { },
    "queryHash" : "0A087AD0"  // Available starting in MongoDB 4.2
  },
  {
    "query" : { "$or" : [ { "qty" : { "$gt" : 15 } }, { "status" : "A" } ] },
    "sort" : { },
    "projection" : { },
    "queryHash" : "DA43B020"
  }
]

注意

并非所有查询都会自动将查询计划放入缓存中。 db.collection.getPlanCache().listQueryShapes()如果当前没有带有查询计划的查询形状，则返回一个空数组。

也可以看看