Categorias:: Funções de agregação (Geral) , Sintaxe e uso da função de janela (Geral)

VAR_SAMP¶

Retorna a variância da amostra de registros não NULL em um grupo. Se todos os registros dentro de um grupo forem NULL, um NULL é retornado.

Aliases:: VARIANCE , VARIANCE_SAMP

Sintaxe¶

Função de agregação

VAR_SAMP( [DISTINCT] <expr1> )

Função de janela

VAR_SAMP( <expr1> ) OVER (
                         [ PARTITION BY <expr2> ]
                         [ ORDER BY <expr3> [ { ASC | DESC } ] [ NULLS { FIRST | LAST } ] [ <window_frame> ] ]
                         )

Para uma sintaxe window_frame detalhada, consulte Sintaxe e uso da função de janela.

Argumentos¶

expr1: O expr1 deve ser avaliado como um dos tipos de dados numéricos.
expr2: Esta é a expressão para divisão.
expr3: Esta é a expressão a ordenar dentro de cada partição.

Retornos¶

O tipo de dados do valor retornado é NUMBER(<precisão>, <escala>). A escala depende dos valores que estão sendo processados.

Notas de uso¶

Para entradas de registro único, VAR_SAMP, VARIANCE e VARIANCE_SAMP todos retornam NULL. Isto é diferente do comportamento do Oracle, onde VAR_SAMP retorna NULL para um único registro e VARIANCE retorna 0.
Ao passar uma expressão VARCHAR, esta função converte implicitamente a entrada em valores de ponto flutuante. Se a conversão não puder ser executada, um erro é devolvido.
Quando esta função é chamada como uma função de janela:
- A sintaxe permite a palavra-chave DISTINCT, mas ela é ignorada.
- Se você não especificar uma quadro de janela, o seguinte quadro de janela implícito será usado:
  
  RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
  
  Para obter mais informações sobre quadros de janela, incluindo sintaxe, notas de uso e exemplos, consulte Sintaxe e uso da função de janela.

Exemplos¶

Este exemplo mostra como usar a função VAR_SAMP:

Criar e preencher uma tabela:

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);

Consultar a tabela:

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 |
+---+---------------+----------------+