/ /

$percentile（ウィンドウ関数）

定義

$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デプロイにロードする方法の詳細については、「サンプルデータセットをロードする」を参照してください。サンプルデータベースに変更を加えた場合、このページの例を実行するには、データベースを削除して再作成する必要がある場合があります。

次の例では、$percentile $setWindowFields10ステージで2002 を使用して、からまでの各年の IMDB 評価の上位 %2004 に含まれるアクション映画を検索します。

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
  }
]

先行するパイプライン:

$match2002を使用して、、2003 、または2004 にリリースされ、少なくとも5 、000 IMDB 投票権を持つアクション映画をフィルタリングします。
$setWindowFieldsyearを使用して、で映画を分割します。各パーティション内で、$percentile 90演算子は、p: [0.9] とに保存されている無制限のウィンドウを使用して、パーセンタイルtop10PctRatingForYear IMDB 評価を計算します。
$match$exprと90 を使用して、その年の IMDB 評価がパーセンタイル評価以上の映画をフィルタリングします。
$projecttitleを使用して、year 、、imdb_rating 、top10PctRatingForYear フィールドを出力に含めます。
$sortを使用して、結果を年の昇順、次に IMDB 評価の降順で並べ替えます。

戻る

$minN

$push