Analiza la ejecución de consultas con la Explicación de consultas

En esta página, se describe cómo recuperar información sobre la ejecución de consultas cuando ejecutas una consulta.

Usa la función Explicación de consultas

Puedes usar Query Explain para comprender cómo se ejecutan tus consultas. Esto proporciona detalles que puedes usar para optimizar tus consultas.

Puedes usar Query Explain a través de la consola de Google Cloud o el comando explain.

Console

Ejecuta una consulta en el Editor de consultas y abre la pestaña Explicación:

  1. En la consola de Google Cloud , ve a la página Bases de datos.

    Ir a Bases de datos

  2. En la lista de bases de datos, selecciona una base de datos de Firestore con compatibilidad con MongoDB. La consola de Google Cloud abrirá el Explorador de Firestore para esa base de datos.
  3. Ingresa una consulta en el editor de consultas y haz clic en Ejecutar.

  4. Haz clic en la pestaña Explicación para ver el resultado del análisis de la consulta.

    Pestaña Explicación de la consulta en la consola
API de Mongo

La función Query Explain en la API de Mongo se admite a través del comando explain, que puedes usar en herramientas como Mongo Shell y Compass.

El comando explain es compatible con los comandos aggregate, find, distinct y count, por ejemplo:

db.collection.explain.find(...)

También puedes usar el método explain(), por ejemplo:

db.collection.find({QUERY}).explain()
Limitaciones
Ten en cuenta las siguientes limitaciones y diferencias:

  • La función Explicar consulta no admite comandos que devuelven un cursor. Por ejemplo, no se admite invocar explain llamando directamente al siguiente comando:

    db.collection.aggregate(..., explain: true)

  • La función Explicación de la búsqueda solo es compatible con los comandos find, aggregate, count y distinct.

  • Las opciones Verbosity y Comment de Query Explain no se admiten a través de la API de MongoDB. El comportamiento coincide con la opción executionStats. Si se proporcionan, se ignoran las opciones allPlansExecution y queryPlanner.

Análisis

El resultado de Query Explain contiene dos componentes principales: las estadísticas de resumen y el árbol de ejecución. Considera esta consulta como ejemplo:

db.order.aggregate(
 [
   { "$match": { "user_id": 1234 } },
   { "$sort": { "date_placed": 1 } }
 ]
)

Estadísticas de resumen

La parte superior del resultado explicado contiene un resumen de las estadísticas de ejecución. Usa estas estadísticas para determinar si una consulta tiene una latencia o un costo altos. También contiene estadísticas de memoria que te permiten saber qué tan cerca está tu consulta de los límites de memoria.

Billing Metrics:
read units: 1

Execution Metrics:
request peak memory usage: 4.00 KiB (4,096 B)
results returned: 1

Árbol de ejecución

El árbol de ejecución describe la ejecución de la consulta como una serie de nodos. Los nodos inferiores (nodos hoja) recuperan datos de la capa de almacenamiento, que recorre el árbol hacia arriba para generar una respuesta a la consulta.

Para obtener detalles sobre cada nodo de ejecución, consulta la referencia de ejecución.

Si deseas obtener detalles para usar esta información y optimizar tus consultas, consulta Optimiza la ejecución de consultas.

A continuación, se muestra un ejemplo de un árbol de ejecución:

• Drop
|  fields to drop: [__$3__]
|  records returned: 0
|
└── • MajorSort
    |  fields: [__$3__ ASC]
    |  peak memory usage: 4.00 KiB (4,096 B)
    |  records returned: 0
    |
    └── • Extend
        |  expressions: [date_placed AS __$3__]
        |  records returned: 0
        |
        └── • Drop
            |  fields to drop: [__key__]
            |  records returned: 0
            |
            └── • Extend
                |  expressions: [_id(__key__) AS __id__]
                |  records returned: 0
                |
                └── • Filter
                    |  expression: $eq(user, 1,234)
                    |  records returned: 0
                    |
                    └── • TableScan
                           order: UNDEFINED
                           properties: * - { __create_time__, __update_time__ }
                           records returned: 0
                           records scanned: 0
                           source: (default)#/**/collection

¿Qué sigue?