Computes the statistical variance of a sample consisting of a numeric-expression, as a DOUBLE.

Syntax 1

VAR_SAMP( numeric-expression )

Syntax 2

VAR_SAMP( numeric-expression ) OVER ( window-spec )

window-spec : see Syntax 2 instructions in the Remarks section below

Parameters

Returns

DOUBLE

Remarks

This function converts its argument to DOUBLE, performs the computation in double-precision floating point, and returns a DOUBLE as the result.

The variance (s²) of numeric-expression (x) is computed according to the following formula, which assumes a normal distribution:

s² = (1/( N - 1 )) * SUM( x_I - mean( x ) )²

This variance does not include rows where numeric-expression is NULL. It returns NULL for a group containing either 0 or 1 rows.

Syntax 2 represents usage as a window function in a SELECT statement. As such, elements of window-spec can be specified either in the function syntax (inline), or in conjunction with a WINDOW clause in the SELECT statement. See the window-spec definition provided in WINDOW clause.

For more information about using window functions in SELECT statements, including working examples, see Window functions.

See also

• Aggregate functions
• VARIANCE function [Aggregate]

Standards and compatibility

Example

The following statement lists the average and variance in the number of items per order in different time periods:

SELECT YEAR( ShipDate ) AS Year,
    QUARTER( ShipDate ) AS Quarter,
    AVG( Quantity ) AS Average,
    VAR_SAMP( quantity ) AS Variance
FROM SalesOrderItems
GROUP BY Year, Quarter
ORDER BY Year, Quarter;