定义
返回特定窗口中文档值的总体标准偏差。
注意
消歧
本页介绍了用作窗口函数的 $stdDevPop。
您还可以在其他上下文中使用 $stdDevPop：
$stdDevPop (accumulator)，返回一群组文档值的总体标准偏差。$stdDevPop (expression)，返回大量中数值的总体标准差。
语法
{ $setWindowFields: { ... output: { <field>: { $stdDevPop: <expression> } } } }
行为
结果类型
$stdDevPop 以double形式返回输入值的总体标准差。
Non-Numeric Values
$stdDevPop窗口函数忽略非数值。如果窗口不包含数值，则 $stdDevPop 返回 null。
单值
如果输入由单个数值组成，则 $stdDevPop 返回 0。
例子
本页上的示例使用 sample_mflix 数据集中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载样本数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。
此示例使用 $setWindowFields 向每个文档添加一个字段，其中包含 2009 和 2010 音乐剧的 IMDb 评级的运行总体标准偏差。
db.movies.aggregate( [ { $match: { genres: "Musical", year: { $in: [ 2009, 2010 ] }, "imdb.rating": { $type: "double" } } }, { $setWindowFields: { partitionBy: "$year", sortBy: { title: 1 }, output: { stdDevPopRatingInYear: { $stdDevPop: "$imdb.rating", window: { documents: [ "unbounded", "current" ] } }, rankInYear: { $documentNumber: {} } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.rating": 1, stdDevPopRatingInYear: 1, rankInYear: 1 } }, { $sort: { year: 1, title: 1 } } ] )
上述管道：
使用
$match从 2009 和 2010 中过滤具有 IMDb 数字评分的音乐剧。使用
$setWindowFields按year对电影进行分区，并按title进行排序。该阶段使用$stdDevPop和文档窗口[ "unbounded", "current" ]来创建stdDevPopRatingInYear。stdDevPopRatingInYear字段保存从分区开始到当前文档的imdb.rating运行总体标准偏差。$documentNumber为每个文档分配每个分区的行号(rankInYear)。使用
$project在输出中包含title、year、imdb、stdDevPopRatingInYear和rankInYear。使用
$sort按年份和标题对结果进行排序。