$match (agregación)

Optimización del pipeline

• Coloqcar el $match lo más temprano posible en el pipeline de agregación. Debido a que $match limita el número total de documentos en el pipeline de agregación, las operaciones anteriores $match minimizan la cantidad de procesamiento posterior.

• Si colocas un $match al principio de un pipeline, el query puede aprovechar los índices como cualquier otro db.collection.find() o db.collection.findOne().

Expresiones en predicados de query

Para incluir expresiones en un predicado de query, utiliza el operador $expr.

0, valores nulos, falsos o faltantes

Una etapa $match filtra un documento de los resultados del pipeline si se aplica una de las siguientes condiciones:

• El predicado de query $match devuelve un valor 0, null o false en ese documento.

• El predicado de query $match utiliza un campo que falta en ese documento.

Restricciones

• La $match sintaxis de consulta es idéntica a la de la operación de lectura; es decir, $match no acepta expresiones de agregación sin formato. Para incluir una expresión de agregación en,$match utilice una $expr expresión de consulta:

  { $match: { $expr: { <aggregation expression> } } }

• No puedes usar $where en $match queries como parte de la pipeline de agregación.

• No se pueden usar $near ni $nearSphere en consultas como parte del flujo de agregación. Como alternativa, se $match puede:

  • Utiliza la etapa $geoNear en lugar de la etapa $match.

  • Utilice el operador del query $geoWithin con $center o $centerSphere en la etapa $match.

• Para usar $text en la etapa $match, la etapa $match debe ser la primera etapa de la pipeline.

  Las vistas no son compatibles con $text.

  Nota

  $text proporciona capacidades de query de texto para implementaciones autogestionadas (no pertenecientes a Atlas). Para los datos alojados en MongoDB Atlas, MongoDB ofrece una solución mejorada de búsqueda de texto completo, Búsqueda de Atlas.

Filtra datos en Atlas utilizando Atlas búsqueda

Para los datos almacenados en MongoDB Atlas, puedes usar el Atlas Search operador compuesto opción filter para hacer coincidir o filtrar documentos al ejecutar consultas $search. Ejecutar $match después de $search es menos eficiente que ejecutar $search con el operador compuesto operador filter opción.

Para obtener más información sobre la opción filter, consulta operador compuesto en la documentación de Atlas.

Coincidencia exacta

La siguiente operación utiliza $match para realizar una coincidencia exacta:

db.articles.aggregate(
    [ { $match : { author : "dave" } } ]
);

El $match selecciona los documentos donde el campo author es igual a dave, y la agregación devuelve lo siguiente:

{ "_id" : ObjectId("512bc95fe835e68f199c8686"), "author" : "dave", "score" : 80, "views" : 100 }
{ "_id" : ObjectId("512bc962e835e68f199c8687"), "author" : "dave", "score" : 85, "views" : 521 }

Realizar un recuento

El siguiente ejemplo selecciona documentos para procesar utilizando el operador de pipeline $match y luego canaliza los resultados al operador de pipeline $group para calcular un conteo del documento:

db.articles.aggregate( [
  { $match: { $or: [ { score: { $gt: 70, $lt: 90 } }, { views: { $gte: 1000 } } ] } },
  { $group: { _id: null, count: { $sum: 1 } } }
] );

En el pipeline de agregación, $match selecciona los documentos donde el score es mayor que 70 y menor que 90, o el views es mayor o igual que 1000. Estos documentos se canalizan al $group para realizar un conteo. La agregación devuelve lo siguiente:

{ "_id" : null, "count" : 5 }