/ /

$stdDevSamp（累加器操作符）

定义

$stdDevSamp

计算跨一组文档的值的样本标准差。

如果输入值代表全体数据的示例，并且您希望从中推断全体数据的特征，则使用 $stdDevSamp 。如果这些值代表数据的整个总体，请使用 $stdDevPop。

$stdDevSamp 累加器可在以下阶段使用：

注意

消歧

本页介绍了 $stdDevSamp 用作 累加器 时的情况。累加器返回跨一组输入文档的聚合值。

您还可以在这些其他上下文中使用 $stdDevSamp：

$stdDevSamp (expression), 返回数组中数值的示例标准偏差。
$stdDevSamp (window function)，用于在 $setWindowFields 阶段计算窗口中值的示例标准差。

语法

{ $stdDevSamp: <expression> }

行为

结果类型

$stdDevSamp 以double形式返回输入值的示例标准差。

Non-Numeric Values

$stdDevSamp 忽略非数字值、空值和缺失字段。如果所有输入值非数值或缺失，$stdDevSamp 返回 null。

单值

如果输入由单个数值组成，$stdDevSamp 将返回 null。

例子

本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息，请参阅加载示例数据集。如果您对示例数据库进行了任何修改，您可能需要删除并重新创建数据库，才能运行此页面上的示例。

此示例返回 IMDb 评分变化最大的 5 位主管，这些主管至少拍摄了 10 部电影。

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
   }
] )

[
  {
    _id: 'Bob Clark',
    movieCount: 12,
    stdDevSampRating: 1.7167622803617066
  },
  {
    _id: 'John McTiernan',
    movieCount: 10,
    stdDevSampRating: 1.517161091571287
  },
  {
    _id: 'James Cameron',
    movieCount: 10,
    stdDevSampRating: 1.4423745853433652
  },
  {
    _id: 'Sean McNamara',
    movieCount: 13,
    stdDevSampRating: 1.4051188470584879
  },
  {
    _id: 'Robert Rodriguez',
    movieCount: 20,
    stdDevSampRating: 1.303143971526675
  }
]

前面的管道：

使用 $match 过滤器来过滤出具有 directors 字段和数值 imdb.rating 的电影。
使用 $unwind 可为每个主管信用创建单独的文档。
使用 $group 按主管分组，计算具有 $sum 的电影数，并使用 $stdDevSamp 对 imdb.rating 计算 stdDevSampRating。
使用第二个 $match 以保留仅拥有至少 10 部电影的主管。
使用 $sort 按照 stdDevSampRating 降序排序。
使用 $limit 返回前 5 个结果。

了解详情