Pianificatore di query v3

La versione 3.0 di Planner è disponibile Regioni AWS ovunque sia disponibile la versione 8.0 del motore.

La versione 3.0 di Planner è il pianificatore di query predefinito quando è selezionata la versione 8.0 del motore.

Segui i passaggi indicati per modificare il gruppo di parametri del Modifica dei parametri del cluster Amazon DocumentDB cluster.

Per il parametro denominato 'plannerVersion', modifica il valore in 3.0, indicando la versione 3.0 di planner.

Seleziona Applica immediatamente (selezionando Applica al riavvio la selezione sarà inefficace fino al successivo riavvio del cluster).

In un cluster globale, seleziona lo stesso plannerVersion valore (1.0 o 2.0 o 3.0) nei gruppi di parametri del cluster per entrambe le regioni. Tieni presente che la selezione di versioni diverse del planner nelle regioni primarie e secondarie può causare comportamenti e prestazioni delle query incoerenti.

L'aggiornamento alla versione 3.0 di Planner durante una finestra di manutenzione programmata o durante i periodi di traffico ridotto sarà il meno problematico, poiché potrebbe verificarsi un aumento dei tassi di errore se la versione del pianificatore viene modificata quando i carichi di lavoro sono in esecuzione attiva.

La versione 3.0 di Planner non è supportata nei cluster elastici, che torneranno alla versione 1.0 di Planner.

Mentre Planner v1 consente l'uso di «PlanHint» per garantire che un piano di query specifico venga selezionato dall'ottimizzatore di query, Planner v3 non consente l'uso di «PlanHint» e si basa su ottimizzazioni interne per scegliere il piano migliore per la determinata query.

Quando possibile, il planner sposta $match nelle fasi precedenti della pipeline, riducendo il numero di documenti elaborati nelle fasi successive.

//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 } }
])

Il planner combina automaticamente le fasi $lookup e $unwind quando operano sullo stesso campo, riducendo l'elaborazione intermedia dei dati e migliorando le prestazioni.

                 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
             

La versione 3.0 di Planner introduce una nuova strategia di esecuzione di Distinct Scan che migliora significativamente le prestazioni per operazioni distinte su indici a bassa cardinalità.

                 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"
                        }
                }
        }
}

             

Il distinct comando richiede la versione 3.0 di Planner.

Il aggregate comando richiede la versione 3.0 del planner e Amazon DocumentDB 8.0.2. Un filtro si applica quando la pipeline legge la raccolta attraverso una fase principale. $match

Un filtro impostato sulla raccolta esterna di una $lookup o $graphLookup fase determina l'indice utilizzato per scansionare quella raccolta esterna. Ciò richiede anche la versione 3.0 di Planner e Amazon DocumentDB 8.0.2.