/ /

$top (창 함수)

정의

$top

지정된 정렬 순서에 따라 창 내 최상위 요소를 반환합니다.

참고

명확화

이 페이지에서는 창 함수로 사용되는 경우의 $top에 대해 설명합니다. 다음과 같은 다른 컨텍스트에서도 $top을 사용할 수 있습니다.

$top (expression operator)지정된 정렬 순서에 따라 배열 의 최상위 요소를 반환합니다.
$top (accumulator)지정된 정렬 순서에 따라 그룹 내 최상위 요소를 반환합니다.

구문

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $top: {
               sortBy: { <field1>: <sort order>, <field2>: <sort order> ... },
               output: <expression>
            }
         }
      }
   }
}

필드	필요성	설명
sortBy	필수 사항	`$sort`와 유사한 구문을 사용하여 창 내 요소의 순위 순서를 정의합니다. 파이프라인 출력의 문서 순서에는 영향을 주지 않습니다.
출력	필수 사항	창 각 요소에 대한 출력을 지정합니다. 모든 표현식 가능합니다.

행동

$top 창 함수는 null 및 누락된 값에 대해 다음과 같은 동작을 합니다.

$top null 값을 필터링하지 않습니다.
$top 누락된 값을 null로 변환합니다.

예시

이 페이지의 예제에서는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB deployment 에 로드하는 방법에 대한 자세한 내용은 샘플 데이터 세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우 이 페이지의 예제를 실행 하려면 데이터베이스를 삭제하고 다시 만들어야 할 수 있습니다.

창을 통해 연간 최고 평점 영화 찾기

이 예시 $top을 창 함수로 사용하여 각 영화 문서 에 대해 같은 해 최고 평점을 받은 영화를 식별합니다. 1980~1982의 PG 등급 가족 영화만 포함하도록 데이터 세트가 필터링됩니다.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1980, 1981, 1982 ] },
         "imdb.rating": { $exists: true, $ne: null },
         genres: "Family",
         rated: "PG"
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         output: {
            highestRatedInYear: {
               $top: {
                  output: { title: "$title", rating: "$imdb.rating" },
                  sortBy: { "imdb.rating": -1 }
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         rating: "$imdb.rating",
         highestRatedInYear: 1
      }
   },
   {
      $limit: 10
   }
] )

[
  {
    title: 'My Bodyguard',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 7
  },
  {
    title: 'Popeye',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 5.2
  },
  {
    title: 'The Watcher in the Woods',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 6.5
  },
  {
    title: 'Clash of the Titans',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 6.9
  },
  {
    title: 'Going Ape!',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 3.6
  },
  {
    title: 'Night Crossing',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.4
  },
  {
    year: 1982,
    title: 'Annie',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.5
  },
  {
    title: 'Author! Author!',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.1
  },
  {
    title: 'The Dark Crystal',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.2
  },
  {
    year: 1982,
    title: 'E.T. the Extra-Terrestrial',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.9
  }
]

이 예시에서는

$match 단계는 PG 등급의 패밀리 영화를 1980~1982 까지 필터링하여 작고 집중된 결과 설정하다 생성합니다.
$setWindowFields는 year로 문서를 파티셔닝합니다.
이 창 은 unbounded에서 unbounded까지이며, 이는 $top가 최고 평점 영화를 결정할 때 파티션에 있는 모든 문서를 고려한다는 의미입니다.
$top 각 파티션의 최고 평점 영화를 title 및 rating 필드가 포함된 내장된 문서 로 반환합니다.
$project는 출력에 title, year, rating 및 highestRatedInYear 필드만 포함합니다.
$limit 출력을 10 문서로 제한합니다.

이 접근 방식은 모든 개별 영화 문서를 보존하고 매년 최고 출연자에 대한 참조를 포함합니다.

돌아가기

$sum

topN