STDDEV

功能描述

STDDEV

函数用于计算一组数值的样本标准偏差。它是统计学中常用的聚合函数，用于衡量数据的离散程度。此函数是

STD

聚合函数的同义词,返回值为

DOUBLE

类型。

语法

STDDEV(expr) [FILTER (WHERE condition)]

参数

• expr

  expr
  ：一个计算结果为数值的表达式。该表达式可以是列名、计算公式或其他返回数值的表达式。

返回值

• 返回值为

  DOUBLE

  DOUBLE
  类型,表示样本标准偏差。
• 如果指定了

  DISTINCT

  DISTINCT
  ,则函数仅对

  expr

  expr
  的唯一值进行计算。
• 如果聚合组中仅包含一行数据,则函数返回

  NULL

  NULL
  。

示例

示例 1：计算所有值的标准偏差

SELECT STDDEV(col) FROM VALUES (1), (2), (3), (3) AS tab(col); +--------------------+ | STDDEV(col) | +--------------------+ | 0.9574271077563381 | +--------------------+

示例 2：计算唯一值的标准偏差

SELECT STDDEV(DISTINCT col) FROM VALUES (1), (2), (3), (3) AS tab(col); +----------------------+ | STDDEV(DISTINCT col) | +----------------------+ | 1.0 | +----------------------+

示例 3：使用 FILTER 子句条件性地计算标准偏差

SELECT STDDEV(col) FILTER (WHERE col > 1) FROM VALUES (1), (2), (3), (4) AS tab(col); +----------------------------------------+ | STDDEV(col) FILTER (WHERE (col > 1)) | +----------------------------------------+ | 1.0 | +----------------------------------------+

示例 4：结合 FILTER 子句和 DISTINCT 计算条件标准偏差

SELECT STDDEV(DISTINCT col) FILTER (WHERE col <= 3) FROM VALUES (1), (2), (3), (3), (4) AS tab(col); +-------------------------------------------------------+ | STDDEV(DISTINCT col) FILTER (WHERE (col <= 3)) | +-------------------------------------------------------+ | 1.0 | +-------------------------------------------------------+