/ /

$ 백분위 (창 함수)

정의

$percentile

창 내에서 지정된 백분위 백분위 값의 배열 반환합니다.

참고

명확화

이 페이지에서는 창 함수로 사용되는 경우의 $percentile에 대해 설명합니다.

다음과 같은 다른 컨텍스트에서도 $percentile를 사용할 수 있습니다.

$percentile (accumulator)입력 문서 그룹 전체에 걸쳐 백분위 값의 애그리게이션된 배열 반환합니다.
$percentile (expression)입력 값 배열 에 대한 백분위 값을 계산합니다.

구문

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $percentile: {
               input: <expression>,
               p: [ <expression1>, <expression2>, ... ],
               method: <string>
            },
         }
      }
   }
}

옵션

필드	유형	설명
`input`	표현식	`$percentile`이 (백분위 값을 계산하는 필드 입니다. `input`은 숫자 유형으로 평가되는 표현식 이어야 합니다. 표현식 숫자 유형으로 평가되지 않는 경우 `$percentile` 계산은 해당 값을 무시합니다.
`p`	표현식	`$percentile` `p`의 각 요소에 대한 백분위 값을 계산합니다. 이러한 요소는 계산할 분위수를 지정하며 `0.0` ~ `1.0` 범위 의 숫자 값이어야 합니다. `$percentile` `p`의 요소와 동일한 순서로 결과를 반환합니다.
`method`	문자열	MongoDB 백분위 값을 계산하는 데 사용하는 방법입니다. 메서드는 `'approximate'`이어야 합니다.

행동

$setWindowFields에서 $percentile은 각 문서 에 대한 결과를 반환하지만, 결과는 문서 창 에서 계산됩니다.

계산 고려 사항

창 함수로 사용되는 경우, $percentile은(는) method: 'approximate'이(가) 지정된 경우에도 근사치보다 항상 정확한 백분위 계산 알고리즘 사용합니다.

예시

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

다음 예시 에서는 $setWindowFields 단계에서 $percentile을(를) 사용하여 2002부터 2004까지 각 연도에 대해 IMDB 평점의 상위 10%에 속하는 액션 영화를 찾습니다.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 2002, 2003, 2004 ] },
         genres: "Action",
         "imdb.votes": { $gte: 5000 },
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         output: {
            top10PctRatingForYear: {
               $percentile: {
                  input: "$imdb.rating",
                  p: [ 0.9 ],
                  method: "approximate"
               },
               window: { documents: [ "unbounded", "unbounded" ] }
            }
         }
      }
   },
   {
      $match: {
         $expr: {
            $gte: [
               "$imdb.rating",
               { $arrayElemAt: [ "$top10PctRatingForYear", 0 ] }
            ]
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         imdb_rating: "$imdb.rating",
         top10PctRatingForYear: 1
      }
   },
   {
      $sort: { year: 1, imdb_rating: -1 }
   }
] )

[
  {
    title: 'Company',
    year: 2002,
    top10PctRatingForYear: [
      7.5
    ],
    imdb_rating: 8.1
  },
  {
    year: 2002,
    title: 'Hero',
    top10PctRatingForYear: [
      7.5
    ],
    imdb_rating: 7.9
  },
  {
    year: 2002,
    title: 'The Bourne Identity',
    top10PctRatingForYear: [
      7.5
    ],
    imdb_rating: 7.9
  },
  {
    year: 2002,
    title: 'Minority Report',
    top10PctRatingForYear: [
      7.5
    ],
    imdb_rating: 7.7
  },
  {
    year: 2002,
    title: 'Equilibrium',
    top10PctRatingForYear: [
      7.5
    ],
    imdb_rating: 7.5
  },
  {
    title: 'Battlestar Galactica',
    year: 2003,
    top10PctRatingForYear: [
      7.6
    ],
    imdb_rating: 8.7
  },
  {
    year: 2003,
    title: 'Pirates of the Caribbean: The Curse of the Black Pearl',
    top10PctRatingForYear: [
      7.6
    ],
    imdb_rating: 8.1
  },
  {
    year: 2003,
    title: 'Kill Bill: Vol. 1',
    top10PctRatingForYear: [
      7.6
    ],
    imdb_rating: 8.1
  },
  {
    year: 2003,
    title: 'The Last Samurai',
    top10PctRatingForYear: [
      7.6
    ],
    imdb_rating: 7.7
  },
  {
    title: 'The Blind Swordsman: Zatoichi',
    year: 2003,
    top10PctRatingForYear: [
      7.6
    ],
    imdb_rating: 7.6
  },
  {
    title: 'Tae Guk Gi: The Brotherhood of War',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 8.2
  },
  {
    title: 'Farscape: The Peacekeeper Wars',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 8.2
  },
  {
    title: 'Kill Bill: Vol. 2',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 8
  },
  {
    title: 'The Incredibles',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 8
  },
  {
    title: 'Kung Fu Hustle',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 7.8
  },
  {
    title: 'The Bourne Supremacy',
    year: 2004,
    top10PctRatingForYear: [
      7.8
    ],
    imdb_rating: 7.8
  }
]

이전 파이프라인:

$match를 사용하여 2002, 2003 또는 2004에서 최소 5,000 IMDB 투표로 개봉된 액션 영화를 필터하다 합니다.
$setWindowFields를 사용하여 year별로 영화를 분할합니다. 각 파티션 내에서 $percentile 연산자 p: [0.9]와 top10PctRatingForYear에 저장된 무제한 창 사용하여 90번째 백분위 IMDB 등급을 계산합니다.
$match와 $expr를 함께 사용하여 해당 연도의 IMDB 등급이 90번째 백분위 등급 이상인 영화를 필터하다 합니다.
$project를 사용하여 출력에 title, year, imdb_rating 및 top10PctRatingForYear 필드를 포함합니다.
$sort를 사용하여 연도별로 오름차순으로 결과를 정렬한 다음 IMDB 등급을 내림차순으로 정렬합니다.

돌아가기

$minN

$push