Categorias:

Funções de agregação (Geral) , Funções de janela (Geral, Quadro de janela)

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

Função de janela

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

Para obter mais detalhes sobre a sintaxe window_frame, consulte Sintaxe e utilização do quadro 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 chamado como uma função de janela:

    • A palavra-chave DISTINCT é permitida sintaticamente, mas é ignorada.

    • Se uma subcláusula ORDER BY for usada dentro da cláusula OVER, então deve ser usado no quadro de janela. Se nenhum quadro de janela for especificado, então o ORDER BY implicará um quadro de janela cumulativo:

      RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

      Para obter mais detalhes sobre quadros de janela, incluindo sintaxe e exemplos, consulte Sintaxe e utilização do quadro de janela.

      Para obter mais informações sobre quadros de janela implícitos, consulte Notas de uso dos quadros 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);
Copy

Consulte a tabela, chamando VAR_SAMP():

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 |
+---+---------------+----------------+
Copy
Linguagem: Português