Docs Menu
Docs Home
/
MongoDB Manual
/

Slot-Based Query Execution Engine

On this page

  • Eligible Queries for the Slot-Based Execution Engine
  • Block Processing
  • Determine which Query Engine was Used
  • Check Query Explain Results
  • Check Slow Query Logs

New in version 5.1.

To find and return query results, MongoDB uses one of the following query engines:

  • The classic query engine

  • The slot-based query execution engine, which is available for some queries starting in MongoDB 5.1.

MongoDB automatically selects the engine to execute the query. In MongoDB versions earlier than 8.0, you cannot manually specify an engine for a particular query. Starting in MongoDB 8.0, you can use query settings to specify an engine for queries. For details, see setQuerySettings.

MongoDB can use the slot-based query execution engine for a subset of queries provided certain conditions are met. In most cases, the slot-based execution engine provides improved performance and lower CPU and memory costs compared to the classic query engine.

MongoDB uses the classic engine for queries that are ineligible for the slot-based query execution engine.

MongoDB determines eligibility for using the slot-based execution engine on a per-query basis, and considers support for each operator and expressions present in the query. For example, two common pipelines that use slot-based execution engine are aggregations with $group or $lookup stages. However, support for the slot-based execution engine is version specific and actively changing.

To see whether your query used the slot-based execution engine, refer to the Determine which Query Engine was Used section.

Starting in version 8.0, MongoDB may execute certain time series queries using block processing. This performance improvement processes queries in "blocks" of data, rather than individual values. Block processing improves query execution speed and throughput when working with time series collections.

To learn more, see Querying Time Series Data.

There are a few ways to determine whether the classic engine or the slot-based execution engine was used to execute a query.

The explain results for a query differ based on which query engine was used. For example, explain results for queries executed using the slot-based execution engine include the explain.queryPlanner.winningPlan.slotBasedPlan field.

For more information about the differences in explain results between query engines, see Explain Output Structure.

Starting in MongoDB 6.2, slow operation log messages include a queryFramework field that indicates which query engine executed the query:

  • queryFramework: "classic" indicates that the classic engine executed the query.

  • queryFramework: "sbe" indicates that the slot-based query execution engine executed the query.

To see an example log message for a query that used the slot-based execution engine, see Slow Operation.

Back

Server Sessions