类别：

/sql-reference/functions-aggregation`（通用）、:doc:/sql-reference/functions-analytic`（通用、窗口框架）

VAR_SAMP

返回组中非 NULL 记录的样本方差。如果组内的所有记录都是 NULL，则返回 NULL。

别名：

VARIANCE、VARIANCE_SAMP

语法

聚合函数

VAR_SAMP( [DISTINCT] <expr1> )
Copy

窗口函数

VAR_SAMP( <expr1> ) OVER (
                         [ PARTITION BY <expr2> ]
                         [ ORDER BY <expr3> [ ASC | DESC ] [ <window_frame> ] ]
                         )
Copy

有关 window_frame 语法的详细信息，请参阅 窗口框架语法和用法。

实参

expr1

expr1 的计算结果应为其中一种数值数据类型。

expr2

这是分区所依据的表达式。

expr3

这是每个分区中作为排序规则的表达式。

返回

返回值的数据类型是 NUMBER(<precision>, <scale>)。比例取决于正在处理的值。

使用说明

  • 对于单条记录输入，VAR_SAMP、VARIANCE 和 VARIANCE_SAMP 都返回 NULL。这与 Oracle 行为不同，在 Oracle 行为中，VAR_SAMP 为单条记录返回 NULL，并且 VARIANCE 返回 0。

  • 传递 VARCHAR 表达式时，此函数会将输入隐式转换为浮点值。如果无法执行转换，则会返回错误。

  • 当作为窗口函数调用时：

    • 关键字 DISTINCT 在语法上允许，但会被忽略。

    • 如果 ORDER BY 分子句在 OVER 子句内使用，则必须使用窗口框架。如果未指定窗口框架，则 ORDER BY 意味着累积窗口框架：

      RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

      有关窗口框架的更多详细信息（包括语法和示例），请参阅 窗口框架语法和用法。

      有关隐式窗口框架的更多信息，请参阅 窗口框架使用说明。

示例

此示例演示如何使用 VAR_SAMP 函数：

创建并填写表：

create table aggr(k int, v decimal(10,2), v2 decimal(10, 2));
insert into aggr values 
   (1, 10, null),
   (2, 10, 11), 
   (2, 20, 22), 
   (2, 25, null), 
   (2, 30, 35);
Copy

查询表，调用 VAR_SAMP()：

SELECT k, var_samp(v), var_samp(v2) 
    FROM aggr 
    GROUP BY k
    ORDER BY k;
+---+---------------+----------------+
| K |   VAR_SAMP(V) |   VAR_SAMP(V2) |
|---+---------------+----------------|
| 1 |          NULL |           NULL |
| 2 | 72.9166666667 | 144.3333333333 |
+---+---------------+----------------+
Copy
语言: 中文