定義
ドキュメントのグループ間の値のサンプル標準偏差を計算します。
入力値がデータの母集団のサンプルであり、その母集団について一般化したい場合は、$stdDevSamp を使用します。値がデータの全体を表す場合は、代わりに $stdDevPop を使用します。
$stdDevSamp アキュムレータは次のステージで使用可能です。
注意
曖昧さ回避
このページでは、$stdDevSamp をアキュムレータとして使用する場合について説明します。アキュムレータは、入力ドキュメントのグループ全体で集計値を返します。
$stdDevSamp は、これらの他のコンテキストでも使用できます。
$stdDevSamp (expression), 配列内の数値のサンプル標準偏差を返します。$stdDevSamp (window function)$setWindowFieldsウィンドウ内の値のサンプル標準偏差を計算するために、 ステージで使用される 。
構文
{ $stdDevSamp: <expression> }
動作
結果の型
$stdDevSamp 入力値のサンプル標準偏差をdoubleとして返します。
Non-Numeric Values
$stdDevSamp 数値以外の値、null 値、および欠落しているフィールドを無視します。すべての入力値が数値以外であるか、または存在しない場合、$stdDevSamp は null を返します。
単一の値
入力が単一の数値で構成されている場合、$stdDevSampはnullを返します。
例
このページの例では、sample_mflix データセット のデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプル データセットのロード」を参照してください。サンプル データベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。
この例では、10 本以上の映画を手がけた役員の中から、IMDb レーティングの変動が最も大きい 5 人の役員が返されます。
db.movies.aggregate( [ { $match: { directors: { $exists: true }, "imdb.rating": { $type: "double" } } }, { $unwind: "$directors" }, { $group: { _id: "$directors", movieCount: { $sum: 1 }, stdDevSampRating: { $stdDevSamp: "$imdb.rating" } } }, { $match: { movieCount: { $gte: 10 } } }, { $sort: { stdDevSampRating: -1 } }, { $limit: 5 } ] )
以前のパイプライン:
使用します
$matchを使用して、directorsフィールドと数値のimdb.ratingを持つ映画をフィルターします。$unwindを使用して、各役員クレジットに個別のドキュメントを作成します。「
$group」を使用して役員でグループ化し、「$sum」を持つ映画の数をカウントし、「imdb.rating」の「$stdDevSamp」を使用して「stdDevSampRating」を計算します。2番目の
$matchを使用して、少なくとも 10 本の映画を持つ役員のみを維持します。$sortを使用してstdDevSampRatingを降順にソートします。$limitを使用して上位 5 件の結果を返します。