$match (agregação)

Otimização de pipeline

• Coloque $match o mais cedo possível no aggregation pipeline . Como o $match limita o número total de documentos no pipeline de agregação, as operações $match anteriores minimizam a quantidade de processamento no pipeline.

• Se você colocar $match no início de um pipeline, a query poderá aproveitar os índices como qualquer outro db.collection.find() ou db.collection.findOne().

Restrições

• A sintaxe de query $match é idêntica à sintaxe de query da operação de leitura ; ou seja, $match não aceita expressões de aggregation brutas. Para incluir uma expressão de aggregation em $match, use uma expressão de query $expr :

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

• Não é possível usar $where em queries $match como parte do aggregation pipeline.

• Não é possível usar $near nem $nearSphere em queries $match como parte do aggregation pipeline. Como alternativa, você pode:

  • Use o estágio $geoNear em vez do $match .

  • Use $geoWithin operador de query com $center ou $centerSphere no estágio $match .

• Para usar $text no estágio $match , o estágio $match deve ser o primeiro do pipeline.

  Os modos de exibição não oferecem suporte à pesquisa de texto.

Filtrar dados no Atlas usando o Atlas Search

Para dados armazenados no MongoDB Atlas, você pode usar a opção filter do operador composto do Atlas Search para corresponder ou filtrar documentos ao executar queries $search . Executar $match após $search tem menos desempenho do que executar $search com a opção de operador composto filter .

Para saber mais sobre a opção filter , consulte composto na documentação do Atlas.

Correspondência de qualidade

A operação a seguir usa $match para realizar uma correspondência de igualdade simples:

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

$match seleciona os documentos onde o campo author é igual a dave, e a aggregation retorna o seguinte:

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

Fazer uma contagem

O exemplo a seguir seleciona documentos a serem processados usando o operador de pipeline $match e, em seguida, encaminha os resultados para o operador de pipeline $group para calcular a contagem dos documentos:

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

No aggregation pipeline, $match seleciona os documentos em que score é maior que 70 e menor que 90 ou em que views é maior ou igual que 1000. Esses documentos são então encaminhados para $group para a realização da contagem. A aggregation retorna o seguinte:

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