查询计划器 v3

Planner 版本 3.0 适用于所有提供引擎版本 8.0 的区域。

选择引擎版本 8.0 时，Planner 版本 3.0 是默认的查询计划器。

按照 修改 Amazon DocumentDB 集群参数 中的步骤修改集群的参数组。

对于名为 “PlannerVersion” 的参数，将值更改为 3.0，表示计划器版本 3.0。

选择立即应用（若选择重启时应用，则在集群下次重启后才会生效）。

在全局群集中，在两个区域的群集参数组中选择相同的plannerVersion值（1.0、2.0 或 3.0）。请注意，在主要区域和辅助区域中选择不同的计划程序版本可能会导致查询行为和性能不一致。

在计划维护时段或流量减少期间更新到计划器版本 3.0 的干扰最小，因为如果在工作负载活跃运行时更改计划器版本，则错误率可能会增加。

弹性集群不支持 Planner 版本 3.0，它将退回到计划器版本 1.0。

虽然 Planner v1 允许使用 “PlanHint” 来确保查询优化器选择特定的查询计划，但 Planner v3 不允许使用 “PlanHint”，而是依靠内部优化来为给定查询选择最佳计划。

如果可能，计划器会将$match阶段移到流程的更早阶段，从而减少后续阶段处理的文档数量。

//Planner v1
db.orders.aggregate([
  { $project: { customerId: 1, orderDate: 1, totalAmount: 1 } },
  { $match: { customerId: { $gt: 1000 } } }
])

// Planner v3 pulls up the match since customerId exists in original documents
// Optimized internally as:
db.orders.aggregate([
  { $match: { customerId: { $gt: 1000 } } },  // Pulled up before project
  { $project: { customerId: 1, orderDate: 1, totalAmount: 1 } }
])

当$lookup和$unwing阶段在同一字段上操作时，规划器会自动将它们组合在一起，从而减少中间数据处理并提高性能。

                 Example query:
//Planner v1
db.orders.aggregate([
  { $lookup: { from: "products", localField: "productId", foreignField: "_id", as: "productInfo" } },
  { $unwind: "$productInfo" },
  { $project: { orderDate: 1, "productInfo.name": 1, "productInfo.price": 1 } }
])

// Planner version 3.0 optimizes this internally by coalescing the $lookup and $unwind stages
             

Planner 版本 3.0 引入了一种新的 Distinct Scan 执行策略，该策略可显著提高低基数索引上不同操作的性能。

                 Example query:
//// If there is a low cardinality index on "category", you may see a query plan like below
db.explain().products.distinct("category")

"queryPlanner" : {
        "plannerVersion" : 3,
        "namespace" : "db.products",
        "winningPlan" : {
                "stage" : "AGGREGATE",
                "inputStage" : {
                        "stage" : "DISTINCT_SCAN",
                        "inputStage" : {
                                "stage" : "IXONLYSCAN",
                                "indexName" : "category_1",
                                "direction" : "forward"
                        }
                }
        }
}