$ stdDevPop（汇总）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道运营商 > $ stdDevPop（汇总）

在本页面

定义
行为
例子

定义¶

$stdDevPop¶

3.2版中的新功能。

计算输入值的总体标准差。如果值包含您要表示的整个数据总体，并且不希望针对较大的总体进行概括，请使用此值。$stdDevPop忽略非数字值。

如果这些值仅代表要概括的总体数据样本，请$stdDevSamp 改用。

$stdDevPop 可在以下阶段使用：

$group
$project
$addFields （从MongoDB 3.4开始可用）
$set （从MongoDB 4.2开始可用）
$replaceRoot （从MongoDB 3.4开始可用）
$replaceWith （从MongoDB 4.2开始可用）
$match包含$expr表达的阶段

在$group阶段中使用时，对于$stdDevPop按键共享同一组并且具有以下语法的一组文档，返回指定表达式的填充标准差：

$stdDevPop 有一个指定的表达式作为其操作数：
复制
```
{ $stdDevPop: <expression> }
```

在其他受支持的阶段中使用时， $stdDevPop为每个文档返回指定表达式或表达式列表的标准偏差，并具有以下两种语法之一：

$stdDevPop 有一个指定的表达式作为其操作数：
复制
```
{ $stdDevPop: <expression> }
```
$stdDevPop 有一个指定表达式的列表作为其操作数：
复制
```
{ $stdDevPop: [ <expression1>, <expression2> ... ]  }
```

只要能解析为数组，for的参数就$stdDevPop可以是任何表达式。有关表达式的更多信息，请参见表达式

行为¶

非数值¶

$stdDevPop忽略非数字值。如果a的所有操作数 $stdDevPop均为非数字，则$stdDevPop返回 null。

单值¶

如果样本包含单个数值，则$stdDevPop 返回0。

数组操作数¶

在此$group阶段，如果表达式解析为数组，$stdDevPop则将操作数视为非数值。

在其他受支持的阶段：

使用单个表达式作为其操作数，如果表达式解析为数组，则$stdDevPop遍历数组以对数组的数字元素进行操作以返回单个值。
使用表达式列表作为其操作数，如果任何表达式解析为数组，$stdDevPop则不会遍历数组，而是将数组视为非数字值。

例子¶

在`$group`舞台上使用¶

名为的集合users包含以下文档：

复制

{ "_id" : 1, "name" : "dave123", "quiz" : 1, "score" : 85 }
{ "_id" : 2, "name" : "dave2", "quiz" : 1, "score" : 90 }
{ "_id" : 3, "name" : "ahn", "quiz" : 1, "score" : 71 }
{ "_id" : 4, "name" : "li", "quiz" : 2, "score" : 96 }
{ "_id" : 5, "name" : "annT", "quiz" : 2, "score" : 77 }
{ "_id" : 6, "name" : "ty", "quiz" : 2, "score" : 82 }

以下示例计算每个测验的标准偏差：

复制

db.users.aggregate([
   { $group: { _id: "$quiz", stdDev: { $stdDevPop: "$score" } } }
])

该操作返回以下结果：

复制

{ "_id" : 2, "stdDev" : 8.04155872120988 }
{ "_id" : 1, "stdDev" : 8.04155872120988 }

在`$project`舞台上使用¶

创建一个quizzes使用以下文档命名的示例集合：

复制

db.quizzes.insertMany([
   {
      "_id" : 1,
      "scores" : [
         { "name" : "dave123", "score" : 85 },
         { "name" : "dave2", "score" : 90 },
         { "name" : "ahn", "score" : 71 }
      ]
   },
   {
      "_id" : 2,
      "scores" : [
         { "name" : "li", "quiz" : 2, "score" : 96 },
         { "name" : "annT", "score" : 77 },
         { "name" : "ty", "score" : 82 }
      ]
   }
])