$ stdDevSamp（汇总）

定义¶

$stdDevSamp¶

3.2版中的新功能。

计算输入值的样本标准偏差。如果值包含总体样本的数据样本，以用于对该总体进行概括，则使用。$stdDevSamp忽略非数字值。

如果这些值代表整个数据种群，或者您不希望对更大的种群进行概括，请 $stdDevPop改用。

$stdDevSamp 可在以下阶段使用：

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

在$group阶段中使用时，$stdDevSamp具有以下语法，并为通过键共享同一组的一组文档返回指定表达式的样本标准差：

复制

{ $stdDevSamp: <expression> }

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

• $stdDevSamp 有一个指定的表达式作为其操作数：

  复制

  { $stdDevSamp: <expression> }
  

• $stdDevSamp 有一个指定表达式的列表作为其操作数：

  复制

  { $stdDevSamp: [ <expression1>, <expression2> ... ]  }
  

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

行为¶

例子¶

集合users包含具有以下字段的文档：

{_id: 0, username: "user0", age: 20}
{_id: 1, username: "user1", age: 42}
{_id: 2, username: "user2", age: 28}
...

为了计算用户样本的标准差，以下聚合操作首先使用$sample管道对100个用户进行采样，然后使用$stdDevSamp计算样本用户的标准差。

db.users.aggregate(
   [
      { $sample: { size: 100 } },
      { $group: { _id: null, ageStdDev: { $stdDevSamp: "$age" } } }
   ]
)

该操作返回如下结果：

{ "_id" : null, "ageStdDev" : 7.811258386185771 }