定義
数値の配列について計算された 1 つ以上のパーセンタイル値を返します。
注意
曖昧さ回避
このページでは、入力値の配列におけるパーセンタイル値を計算する式として使用する場合の$percentileについて説明します。
$percentile は、これらの他のコンテキストでも使用できます。
$percentile (accumulator), 入力ドキュメントのグループで集計してパーセンタイル値を返します。$percentile (window function)は、特定のウィンドウのドキュメントに対してパーセンタイル値の配列を返すために、$setWindowFieldsステージで使用されます。
構文
{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}オプション
フィールド | タイプ | 説明 |
|---|---|---|
| 配列 | 次のいずれかになります。
|
| 式 |
|
| 文字列 | MongoDB がパーセンタイル値を計算するために使用する方法。メソッドは |
動作
式として使用する場合、$percentile は method: 'approximate' が指定されている場合でも、常に近似アルゴリズムではなく正確なパーセンタイル計算アルゴリズムを使用します。これは、式が、すべての入力値をメモリに保持しても問題のないサイズ制限の配列に対して操作するためです。
例
testScores コレクションを作成します。
db.testScores.insertMany( [ { studentId: "2345", scores: [ 62, 81, 80, 75, 68 ] }, { studentId: "2356", scores: [ 60, 83, 79, 72, 65 ] }, { studentId: "2358", scores: [ 67, 82, 78, 70, 84 ] }, { studentId: "2367", scores: [ 64, 72, 77, 58, 91 ] }, { studentId: "2369", scores: [ 60, 53, 72, 85, 63 ] }] )次のパイプラインは $percentile を使用して、各生徒の 25パーセンタイル、50パーセンタイル、75パーセンタイルのテストスコアを計算します。
db.testScores.aggregate( [ { $project: { _id: 0, studentId: 1, testPercentiles: { $percentile: { input: "$scores", p: [ 0.25, 0.5, 0.75 ], method: 'approximate' } } } }] )前のパイプラインでは、$project は $percentile を使用して各生徒の scores 配列の 25パーセンタイル、50パーセンタイル、75パーセンタイルを計算し、testPercentiles として返します。