カテゴリ:

集計関数 (一般)、 ウィンドウ関数 (一般、ウィンドウフレーム)

STDDEV

NULL 以外の値のサンプル標準偏差(サンプル分散の平方根)を返します。グループ内のすべてのレコードが NULLの場合、 NULLを返します。

エイリアス:

STDDEV_SAMP

構文

集計関数

STDDEV( [DISTINCT] <expr> )

ウィンドウ関数

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

ウィンドウフレーム 構文の詳細については、 ウィンドウフレームの構文と使用法 をご参照ください。

引数

式1

数値に評価される式です。

式2

これは、パーティションを分割するオプションの式です。

式3

これは、各パーティション内で並べ替えるオプションの式です。

戻り値

返される値のデータ型は DOUBLE です。

使用上の注意

  • 単一レコード入力の場合、 STDDEV_SAMP と STDDEV は両方とも NULLを返します。これは、単一のレコードに対して STDDEV_SAMP が NULL を返し、 STDDEV が0を返すOracleの動作とは異なります。

  • VARCHAR 式が渡されると、この関数は入力を暗黙的に浮動小数点値にキャストします。キャストを実行できない場合、エラーが返されます。

  • ウィンドウ関数として呼び出された場合:

    • キーワード DISTINCT は構文的に許可されていますが、無視されます。

    • OVER 句内で ORDER BY サブ句を使用する場合、ウィンドウフレームを使用する必要があります。ウィンドウフレームが指定されていない場合、 ORDER BY は累積ウィンドウフレームを意味します。

      RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

      構文や例を含むウィンドウフレームの詳細については、 ウィンドウフレームの構文と使用法 をご参照ください。

      暗黙的なウィンドウフレームの詳細については、 ウィンドウフレームの使用上の注意 をご参照ください。

これは、整数の小さなサンプルの標準偏差を示しています。

CREATE TABLE devious (i INTEGER);
INSERT INTO devious (i) VALUES
    (6),
   (10),
   (14)
   ;

SELECT STDDEV(i) FROM devious;

出力:

+----------+
| STDDEV() |
|----------|
|        4 |
+----------+