AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$percentile (式)

$percentile

数値の配列について計算された 1 つ以上のパーセンタイル値を返します。

注意

曖昧さ回避

このページでは、入力値の配列におけるパーセンタイル値を計算する式として使用する場合の$percentileについて説明します。

$percentile は、これらの他のコンテキストでも使用できます。

{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}
フィールド
タイプ
説明

input

配列

次のいずれかになります。

  • 配列に変換される式。例、$scores のように、ドキュメント フィールド $scores に数値の配列が含まれています。

  • 各式が数値に評価される式の配列。例として、[ "$field1", "$field2", "$field3" ] 。

$percentile 配列内のすべての数値についてパーセンタイル値を計算します。非数値は無視されます。

p

式

$percentile p 内の各要素のパーセンタイル値を計算します。これらの要素は計算するクアンタイルを指定します。また、範囲 0.0 から 1.0 までの数値( および を含む)である必要があります。

$percentile は、 pの要素と同じ順序で結果を返します。

method

文字列

MongoDB がパーセンタイル値を計算するために使用する方法。メソッドは 'approximate' でなければなりません。

式として使用する場合、$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 として返します。

このページを評価