云原生大数据计算服务 MaxCompute：STDDEV_SAMP

使用限制

窗口函数的使用限制如下：

• 窗口函数只能出现在select语句中。

• 窗口函数中不能嵌套使用窗口函数和聚合函数。

• 窗口函数不能和同级别的聚合函数一起使用。

命令格式

--计算样本标准差
double stddev_samp(double <colname>)
decimal stddev_samp(decimal <colname>)

--计算窗口中expr的标准差
double stddev_samp([distinct] <expr>) over([partition_clause] [orderby_clause] [frame_clause])
decimal stddev_samp([distinct] <expr>) over([partition_clause] [orderby_clause] [frame_clause])

参数说明

• colname：必填。列值可以为DOUBLE或DECIMAL类型。如果输入为STRING或BIGINT类型，会隐式转换为DOUBLE类型后参与运算。

• expr：必填。待计算样本标准差的表达式。DOUBLE类型或DECIMAL类型。

  • 当输入值为STRING类型或BIGINT类型时，会隐式转换为DOUBLE类型后参与运算，其他类型返回报错。

  • 当输入值为NULL时，该行不参与计算。

  • 当指定distinct关键字时，表示计算唯一值的样本标准差。

• partition_clause、orderby_clause及frame_clause：详情请参见windowing_definition。

返回值说明

• 如果colname值为NULL时，该行不参与计算。其他类型返回规则如下：

  输入类型	返回类型
  TINYINT	DOUBLE
  SMALLINT	DOUBLE
  INT	DOUBLE
  BIGINT	DOUBLE
  FLOAT	DOUBLE
  DOUBLE	DOUBLE
  DECIMAL	DECIMAL

• 返回值类型同expr类型。所有expr为NULL时，返回结果为NULL。窗口仅包含1条expr值非NULL的数据时，结果为0。

示例数据

create table if not exists emp
   (empno bigint,
    ename string,
    job string,
    mgr bigint,
    hiredate datetime,
    sal bigint,
    comm bigint,
    deptno bigint);
tunnel upload emp.txt emp;   --请根据您上传数据文件的实际path(路径以及名称)替换emp.txt

7369,SMITH,CLERK,7902,1980-12-17 00:00:00,800,,20
7499,ALLEN,SALESMAN,7698,1981-02-20 00:00:00,1600,300,30
7521,WARD,SALESMAN,7698,1981-02-22 00:00:00,1250,500,30
7566,JONES,MANAGER,7839,1981-04-02 00:00:00,2975,,20
7654,MARTIN,SALESMAN,7698,1981-09-28 00:00:00,1250,1400,30
7698,BLAKE,MANAGER,7839,1981-05-01 00:00:00,2850,,30
7782,CLARK,MANAGER,7839,1981-06-09 00:00:00,2450,,10
7788,SCOTT,ANALYST,7566,1987-04-19 00:00:00,3000,,20
7839,KING,PRESIDENT,,1981-11-17 00:00:00,5000,,10
7844,TURNER,SALESMAN,7698,1981-09-08 00:00:00,1500,0,30
7876,ADAMS,CLERK,7788,1987-05-23 00:00:00,1100,,20
7900,JAMES,CLERK,7698,1981-12-03 00:00:00,950,,30
7902,FORD,ANALYST,7566,1981-12-03 00:00:00,3000,,20
7934,MILLER,CLERK,7782,1982-01-23 00:00:00,1300,,10
7948,JACCKA,CLERK,7782,1981-04-12 00:00:00,5000,,10
7956,WELAN,CLERK,7649,1982-07-20 00:00:00,2450,,10
7956,TEBAGE,CLERK,7748,1982-12-30 00:00:00,1300,,10

示例

• 示例1：指定部门（deptno）为开窗列，计算薪水（sal）样本标准差，不排序，返回当前窗口（相同deptno）的累计样本标准差。命令示例如下：

  select deptno, sal, stddev_samp(sal) over (partition by deptno) from emp;

  返回结果如下：

  +------------+------------+------------+
  | deptno     | sal        | _c2        |
  +------------+------------+------------+
  | 10         | 1300       | 1693.7138680032904 |   --窗口开始行，第1行到第6行的累计样本标准差。
  | 10         | 2450       | 1693.7138680032904 |   --从第1行到第6行的累计样本标准差。
  | 10         | 5000       | 1693.7138680032904 |   --从第1行到第6行的累计样本标准差。
  | 10         | 1300       | 1693.7138680032904 |     
  | 10         | 5000       | 1693.7138680032904 |
  | 10         | 2450       | 1693.7138680032904 |
  | 20         | 3000       | 1123.3320969330487 |
  | 20         | 3000       | 1123.3320969330487 |
  | 20         | 800        | 1123.3320969330487 |
  | 20         | 1100       | 1123.3320969330487 |
  | 20         | 2975       | 1123.3320969330487 |
  | 30         | 1500       | 668.331255192114 |
  | 30         | 950        | 668.331255192114 |
  | 30         | 1600       | 668.331255192114 |
  | 30         | 1250       | 668.331255192114 |
  | 30         | 1250       | 668.331255192114 |
  | 30         | 2850       | 668.331255192114 |
  +------------+------------+------------+

• 示例2：指定部门（deptno）为开窗列，计算薪水（sal）样本标准差，并排序，返回当前窗口（相同deptno）从开始行到当前行的累计样本标准差。命令示例如下：

  select deptno, sal, stddev_samp(sal) over (partition by deptno order by sal) from emp;

  返回结果如下：

  +------------+------------+------------+
  | deptno     | sal        | _c2        |
  +------------+------------+------------+
  | 10         | 1300       | 0.0        |          --窗口开始行。
  | 10         | 1300       | 0.0        |          --从第1行到第2行的累计样本标准差。
  | 10         | 2450       | 663.9528095680697 |   --从第1行到第3行的累计样本标准差。
  | 10         | 2450       | 663.9528095680696 |
  | 10         | 5000       | 1511.2081259707413 |
  | 10         | 5000       | 1693.7138680032904 |
  | 20         | 800        | 0.0        |
  | 20         | 1100       | 212.13203435596427 |
  | 20         | 2975       | 1178.7175234126282 |
  | 20         | 3000       | 1182.7536725793752 |
  | 20         | 3000       | 1123.3320969330487 |
  | 30         | 950        | 0.0        |
  | 30         | 1250       | 212.13203435596427 |
  | 30         | 1250       | 173.20508075688772 |
  | 30         | 1500       | 225.0      |
  | 30         | 1600       | 253.4758371127315 |
  | 30         | 2850       | 668.331255192114 |
  +------------+------------+------------+

• 示例3：计算所有职工的薪资（sal）的样本标准差。命令示例如下：

  select stddev_samp(sal) from emp;

  返回结果如下：

  +------------+
  | _c0        |
  +------------+
  | 1301.6180541247609 |
  +------------+

• 示例4：与group by配合使用，对所有职工按照部门（deptno）进行分组，计算各部门员工的薪资（sal）样本标准差。命令示例如下：

  select deptno, stddev_samp(sal) from emp group by deptno;

  返回结果如下：

  +------------+------------+
  | deptno     | _c1        |
  +------------+------------+
  | 10         | 1693.7138680032901 |
  | 20         | 1123.3320969330487 |
  | 30         | 668.3312551921141 |
  +------------+------------+

相关函数

STDDEV_SAMP函数属于聚合函数或窗口函数。

• 更多将多条输入记录进行求平均值、参数聚合的相关函数请参见聚合函数。

• 更多对指定开窗列的数据进行求和、数值排序的相关函数请参见窗口函数。