$match (집계 단계)

정의

$match: 지정된 쿼리 조건자를 기준으로 문서를 필터링합니다. 일치하는 문서는 다음 파이프라인 단계로 전달됩니다.

호환성

다음 환경에서 호스팅되는 배포에 $match 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

{ $match: { <query predicate> } }

$match 쿼리 조건의 구문은 find() 명령의 쿼리 인수에 사용되는 구문과 동일합니다.

행동

파이프라인 최적화

$match를 집계 파이프라인의 가능한 한 앞부분에 배치합니다. $match는 집계 파이프라인의 총 문서 수를 제한하기 때문에 $match 연산을 앞쪽에 배치하면 파이프라인의 처리량을 최소화할 수 있습니다.
파이프라인의 맨 처음에 $match를 배치하면 쿼리는 다른 db.collection.find() 또는 db.collection.findOne()과 같은 인덱스를 활용할 수 있습니다.

쿼리 조건자의 표현식

쿼리 술어에 표현식을 포함하려면 $expr 연산자를 사용하세요.

0, Null, False 또는 누락된 값

$match 단계는 다음 조건 중 하나가 적용되는 경우 파이프라인 결과에서 문서 를 필터링합니다.

$match 쿼리 조건자는 해당 문서 에 대한 0, null 또는 false 값을 반환합니다.
$match 쿼리 조건자가 해당 문서 에서 누락된 필드 를 사용합니다.

제한 사항

$match 단계에서는 $where을 사용할 수 없습니다.
$match 단계에서 $near 또는 $nearSphere를 사용할 수 없습니다. 대신 다음 중 하나를 사용할 수 있습니다.
- $match 단계 대신 $geoNear 단계를 사용합니다.
- $match 단계에서 $center 또는 $centerSphere를 $geoWithin 쿼리 술어 연산자와 함께 사용합니다.
$match 단계에서 $text를 사용하려면 $match 단계가 파이프라인의 첫 번째 단계여야 합니다.
보기는 $text을(를) 지원하지 않습니다.
참고
$text 자체 관리(비Atlas) 배포를 위한 텍스트 쿼리 기능을 제공합니다. MongoDB 에서 호스팅되는 데이터의 경우, MongoDB 향상된 전체 텍스트 쿼리 솔루션인 MongoDB Search.도 제공합니다.

MongoDB Search를 사용하여 Atlas 에서 데이터 필터링

MongoDB Atlas 에 저장된 데이터의 경우, filter 쿼리를 실행 때 MongoDB Search $search 복합 연산자 연산자 옵션을 사용하여 문서를 일치시키거나 필터하다 수 있습니다. $match $search 다음에 를 실행하는 $search 것은 복합 연산자 연산자 filter 옵션을 사용하여 를 실행 보다 성능이 떨어집니다.

filter 옵션에 대해 자세히 알아보려면 Atlas 설명서에서 복합 연산자를 참조하세요.

예시

이 예시에서는 다음 문서와 함께 articles(이)라는 collection을 사용합니다.

{ "_id" : ObjectId("512bc95fe835e68f199c8686"), "author" : "dave", "score" : 80, "views" : 100 }
{ "_id" : ObjectId("512bc962e835e68f199c8687"), "author" : "dave", "score" : 85, "views" : 521 }
{ "_id" : ObjectId("55f5a192d4bede9ac365b257"), "author" : "ahn", "score" : 60, "views" : 1000 }
{ "_id" : ObjectId("55f5a192d4bede9ac365b258"), "author" : "li", "score" : 55, "views" : 5000 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b259"), "author" : "annT", "score" : 60, "views" : 50 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b25a"), "author" : "li", "score" : 94, "views" : 999 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b25b"), "author" : "ty", "score" : 95, "views" : 1000 }

동등성 매치

다음 작업에서는 $match를 사용하여 동등성 매치를 수행합니다.

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

$match는 author 필드가 dave인 문서를 선택하며 집계는 다음을 반환합니다.

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

카운트 수행

다음 예시에서는 $match 파이프라인 연산자를 사용하여 프로세싱할 문서를 선택한 다음 결과를 $group 파이프라인 연산자로 파이프하여 문서 수를 계산합니다.

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

집계 파이프라인에서 $match는 score가 70보다 크고 90보다 작거나 views가 1000보다 크거나 같은 문서를 선택합니다. 그런 다음 이러한 문서를 $group으로 전달하여 집계를 수행합니다. 집계는 다음을 반환합니다.

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

배열 요소 일치

배열 의 요소를 기반으로 컬렉션 또는 이전 집계 단계의 문서를 필터하다 하려면 $match 단계의 쿼리 조건자에 $elemMatch 연산자 사용합니다.

db.aggregate( [
   {
      $documents: [
         { student_id: 1, scores: [ 0.75, 0.65, 0.73 ] },
         { student_id: 2, scores: [ 0.9, 0.88, 0.98 ] },
         { student_id: 3, scores: [ 0.9, 0.84, 0.93 ] }
      ]
   }, {
      $match: {
         scores: { $elemMatch: { $gte: 0.9 } }
      }
   }
] )

[
   { student_id: 2, scores: [ 0.9, 0.88, 0.98 ] },
   { student_id: 3, scores: [ 0.9, 0.84, 0.93 ] }
]

이 페이지의 C# 예제에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB .NET/ C# 드라이버 문서에서 시작하기 를 참조하세요.

다음 Movie 클래스는 sample_mflix.movies 컬렉션의 문서를 모델링합니다.

public class Movie
{
    public ObjectId Id { get; set; }
    public int Runtime { get; set; }
    
    public string Title { get; set; }
    public string Rated { get; set; }
    public List<string> Genres { get; set; }
    public string Plot { get; set; }
    
    public ImdbData Imdb { get; set; }
    public int Year { get; set; }
    public int Index { get; set; }
    
    public string[] Comments { get; set; }
   
    [BsonElement("lastupdated")]
    public DateTime LastUpdated { get; set; }
}

참고

Pascal Case를 위한 ConventionPack

이 페이지의 C# 클래스는 속성 이름에 파스칼 표기법을 사용하지만, MongoDB 컬렉션의 필드 이름은 카멜 표기법을 사용합니다. 이 차이를 해결하기 위해 애플리케이션이 시작될 때 다음 코드를 사용하여 ConventionPack을 등록할 수 있습니다.

var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);

MongoDB .NET/ C# 운전자 사용하여 $match 집계 파이프라인 에 단계를 추가하려면 PipelineDefinition 객체 에서 Match() 메서드를 호출합니다.

다음 예시 Title 필드 "The Shawshank Redemption"와 같은 모든 Movie 문서와 일치하는 파이프라인 단계를 만듭니다.

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Match(m => m.Title == "The Shawshank Redemption");

이 페이지의 Node.js 예제에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB Node.js 운전자 설명서에서 시작하기 를 참조하세요.

MongoDB Node.js 운전자 사용하여 집계 파이프라인 에 $match 단계를 추가하려면 파이프라인 객체 에서 $match 연산자 사용합니다.

다음 예시에서는 movie 문서 중 title 필드가 "The Shawshank Redemption"와 같은 모든 문서와 일치하는 파이프라인 단계를 만듭니다. 그런 다음 예시가 집계 파이프라인을 실행합니다:

const pipeline = [
  {
    $match: {
      title: "The Shawshank Redemption"
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

자세히 알아보기

집계에 대한 자세한 정보와 사용 사례는 완전한 집계 파이프라인 튜토리얼을 참조하세요.

돌아가기

$lookup

$merge

정의

호환성

구문

행동