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

VARIANCE , VARIANCE_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:: VAR_SAMP

Sintaxe¶

Função de agregação

VARIANCE( [ DISTINCT ] <expr1> )

Copy

Função de janela

VARIANCE( [ DISTINCT ] <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 esta função é chamada como uma função de janela (ou seja, com uma cláusula OVER):
- Se a cláusula OVER contiver uma subcláusula ORDER BY, então:
  - O quadro de janela é exigido. Se nenhum quadro de janela for especificado explicitamente, então o ORDER BY implicará um quadro de janela cumulativo:
    
    RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
    
    Para obter mais informações sobre quadros de janelas, incluindo sintaxe e exemplos, consulte Sintaxe e utilização do quadro de janela.
    
    Para obter mais informações sobre quadros de janelas implícitos, consulte também Notas de uso dos quadros de janela.
  - O uso da palavra-chave DISTINCT dentro da função de janela é proibido e resulta em um erro de tempo de compilação.

Exemplos¶

Para exemplos, consulte VAR_SAMP.