类别：

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

VARIANCE、VARIANCE_SAMP

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

别名：

VAR_SAMP

语法

聚合函数

VARIANCE( [ DISTINCT ] <expr1> )
Copy

窗口函数

VARIANCE( [ DISTINCT ] <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 表达式时，此函数会将输入隐式转换为浮点值。如果无法执行转换，则会返回错误。

  • 当此函数作为窗口函数调用时（即带有 OVER 子句）：

    • 如果 OVER 子句包含 ORDER BY 分子句，则：

      • 需要窗口框架。如果未明确指定窗口框架，则 ORDER BY 默认为累积窗口框架：

        RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

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

        有关隐含窗口框架的信息，另请参阅 窗口框架使用说明。

      • 禁止在窗口函数中使用关键字 DISTINCT，否则会导致编译时错误。

示例

有关示例，请参见 VAR_SAMP。

语言: 中文