查詢規劃器 v3

規劃器 3.0 版可在引擎 8.0 版提供的所有區域使用。

選取引擎 8.0 版時，規劃器 3.0 版是預設查詢規劃器。

請依照中的步驟修改 Amazon DocumentDB 叢集參數修改叢集的參數群組。

對於名為「plannerVersion」的參數，將值變更為 3.0，表示規劃器 3.0 版。

選取立即套用 （選取在重新開機時套用會使選取無效，直到叢集下次重新開機為止）。

在全域叢集中，在兩個區域的叢集參數群組中選取相同的plannerVersion值 (1.0 或 2.0 或 3.0)。請注意，在主要和次要區域中選取不同的規劃器版本可能會導致查詢行為和效能不一致。

在排定的維護時段或減少的流量期間更新到規劃器 3.0 版將最不會造成干擾，因為如果在工作負載主動執行時變更規劃器版本，可能會提高錯誤率。

彈性叢集不支援規劃器 3.0 版，這會回到規劃器 1.0 版。

雖然規劃器 v1 允許使用 'planHint' 來確保查詢最佳化工具已選取特定查詢計畫，但規劃器 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 和 $unwind 階段，減少中繼資料處理並改善效能。

                 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
             

規劃器 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"
                        }
                }
        }
}