カテゴリ:

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

VARIANCE , VARIANCE_SAMP

グループ内のNULL 以外のレコードのサンプル分散を返します。グループ内のすべてのレコードが NULLの場合、 NULLが返されます。

エイリアス:

VAR_SAMP

構文

集計関数

VARIANCE( [ DISTINCT ] <expr1> )

ウィンドウ関数

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

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

引数

式1

式1 は、数値データ型のいずれかに評価されるはずです。

式2

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

式3

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

戻り値

返される値のデータ型は、 NUMBER(<精度>, <スケール>) です。スケールは、処理される値に依存します。

使用上の注意

  • 単一レコード入力の場合、 VAR_SAMP、 VARIANCE、 VARIANCE_SAMP はすべて NULLを返します。これは、単一のレコードに対して VAR_SAMP が NULL を返し、 VARIANCE が0を返すOracleの動作とは異なります。

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

  • この関数がウィンドウ関数(つまり、 OVER 句を使用)として呼び出される場合は、

    • OVER 句に ORDER BY 句が含まれていると次のようになります。

      • ウィンドウフレームが必要です。ウィンドウフレームが明示的に指定されていない場合、 ORDER BY は累積ウィンドウフレームを意味します。

        RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

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

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

      • ウィンドウ関数内でキーワード DISTINCT を使用することは禁止されており、コンパイル時間エラーが発生します。

例については、 VAR_SAMP をご参照ください。