STDDEV_SAMP command format, parameters, and return value - MaxCompute: Central de Documentação do Alibaba Cloud

Limitações

As funções de janela têm as seguintes limitações:

Suportadas apenas em instruções SELECT.
Não podem conter funções de janela ou de agregação aninhadas.
Não podem ser usadas com funções de agregação no mesmo nível de consulta.

Sintaxe

-- Aggregate function
DOUBLE  STDDEV_SAMP(DOUBLE  <colname>)
DECIMAL STDDEV_SAMP(DECIMAL <colname>)

-- Window function
DOUBLE  STDDEV_SAMP([DISTINCT] <expr>) OVER ([partition_clause] [orderby_clause] [frame_clause])
DECIMAL STDDEV_SAMP([DISTINCT] <expr>) OVER ([partition_clause] [orderby_clause] [frame_clause])

Parâmetros

colname

Obrigatório. A coluna a ser agregada. Aceita DOUBLE ou DECIMAL. Valores STRING e BIGINT são convertidos implicitamente para DOUBLE; outros tipos retornam erro.

expr

Obrigatório. A expressão a ser avaliada. Deve resultar em DOUBLE ou DECIMAL.

Valores STRING e BIGINT são convertidos implicitamente para DOUBLE. Outros tipos retornam erro.
Valores NULL são excluídos do cálculo.
Com DISTINCT, a função opera apenas em valores únicos.

partition_clause, orderby_clause, frame_clause

Opcionais. Definem o escopo da janela. Para obter detalhes completos da sintaxe, consulte Window Functions Overview.

Valor de retorno

O tipo de retorno depende da entrada:

Tipo de entrada	Tipo de retorno
TINYINT	DOUBLE
SMALLINT	DOUBLE
INT	DOUBLE
BIGINT	DOUBLE
FLOAT	DOUBLE
DOUBLE	DOUBLE
DECIMAL	DECIMAL

Na forma de função de janela, o tipo de retorno corresponde ao tipo de expr. Se todos os valores de entrada forem NULL, a função retornará NULL.

Comportamento para valor único não NULL: Por padrão, se a janela ou o grupo contiver apenas um valor não NULL, STDDEV_SAMP retorna 0. Para corresponder ao comportamento do BigQuery, execute SET odps.sql.bigquery.compatible=true; antes de executar sua consulta. Isso faz com que a função retorne NULL em vez de 0.

Dados de amostra

Os exemplos a seguir usam uma tabela emp. Crie a tabela e carregue os dados de amostra com estas instruções:

CREATE TABLE IF NOT EXISTS emp (
    empno    BIGINT,
    ename    STRING,
    job      STRING,
    mgr      BIGINT,
    hiredate DATETIME,
    sal      BIGINT,
    comm     BIGINT,
    deptno   BIGINT
);
tunnel upload emp.txt emp; -- Replace emp.txt with the actual path to your data file.

O arquivo emp.txt contém os seguintes dados:

7369,SMITH,CLERK,7902,1980-12-17 00:00:00,800,,20
7499,ALLEN,SALESMAN,7698,1981-02-20 00:00:00,1600,300,30
7521,WARD,SALESMAN,7698,1981-02-22 00:00:00,1250,500,30
7566,JONES,MANAGER,7839,1981-04-02 00:00:00,2975,,20
7654,MARTIN,SALESMAN,7698,1981-09-28 00:00:00,1250,1400,30
7698,BLAKE,MANAGER,7839,1981-05-01 00:00:00,2850,,30
7782,CLARK,MANAGER,7839,1981-06-09 00:00:00,2450,,10
7788,SCOTT,ANALYST,7566,1987-04-19 00:00:00,3000,,20
7839,KING,PRESIDENT,,1981-11-17 00:00:00,5000,,10
7844,TURNER,SALESMAN,7698,1981-09-08 00:00:00,1500,0,30
7876,ADAMS,CLERK,7788,1987-05-23 00:00:00,1100,,20
7900,JAMES,CLERK,7698,1981-12-03 00:00:00,950,,30
7902,FORD,ANALYST,7566,1981-12-03 00:00:00,3000,,20
7934,MILLER,CLERK,7782,1982-01-23 00:00:00,1300,,10
7948,JACCKA,CLERK,7782,1981-04-12 00:00:00,5000,,10
7956,WELAN,CLERK,7649,1982-07-20 00:00:00,2450,,10
7956,TEBAGE,CLERK,7748,1982-12-30 00:00:00,1300,,10

Exemplos

Exemplo 1: Desvio padrão amostral no nível de partição

Calcule o desvio padrão amostral dos salários (sal) para cada departamento (deptno). Como nenhuma cláusula ORDER BY é especificada, a função calcula o desvio padrão sobre todas as linhas em cada partição e retorna o mesmo valor para todas as linhas dessa partição.

SELECT deptno, sal, STDDEV_SAMP(sal) OVER (PARTITION BY deptno)
FROM emp;

Resultado:

+------------+------------+--------------------+
| deptno     | sal        | _c2                |
+------------+------------+--------------------+
| 10         | 1300       | 1693.7138680032904 |
| 10         | 2450       | 1693.7138680032904 |
| 10         | 5000       | 1693.7138680032904 |
| 10         | 1300       | 1693.7138680032904 |
| 10         | 5000       | 1693.7138680032904 |
| 10         | 2450       | 1693.7138680032904 |
| 20         | 3000       | 1123.3320969330487 |
| 20         | 3000       | 1123.3320969330487 |
| 20         | 800        | 1123.3320969330487 |
| 20         | 1100       | 1123.3320969330487 |
| 20         | 2975       | 1123.3320969330487 |
| 30         | 1500       | 668.331255192114   |
| 30         | 950        | 668.331255192114   |
| 30         | 1600       | 668.331255192114   |
| 30         | 1250       | 668.331255192114   |
| 30         | 1250       | 668.331255192114   |
| 30         | 2850       | 668.331255192114   |
+------------+------------+--------------------+

Exemplo 2: Desvio padrão amostral cumulativo

Calcule o desvio padrão amostral cumulativo dos salários (sal) para cada departamento. A janela é particionada por deptno e ordenada por sal, de modo que a função acumula da primeira linha até a linha atual dentro de cada partição.

SELECT deptno, sal, STDDEV_SAMP(sal) OVER (PARTITION BY deptno ORDER BY sal)
FROM emp;

Resultado:

+------------+------------+--------------------+
| deptno     | sal        | _c2                |
+------------+------------+--------------------+
| 10         | 1300       | 0.0                |
| 10         | 1300       | 0.0                |
| 10         | 2450       | 663.9528095680697  |
| 10         | 2450       | 663.9528095680696  |
| 10         | 5000       | 1511.2081259707413 |
| 10         | 5000       | 1693.7138680032904 |
| 20         | 800        | 0.0                |
| 20         | 1100       | 212.13203435596427 |
| 20         | 2975       | 1178.7175234126282 |
| 20         | 3000       | 1182.7536725793752 |
| 20         | 3000       | 1123.3320969330487 |
| 30         | 950        | 0.0                |
| 30         | 1250       | 212.13203435596427 |
| 30         | 1250       | 173.20508075688772 |
| 30         | 1500       | 225.0              |
| 30         | 1600       | 253.4758371127315  |
| 30         | 2850       | 668.331255192114   |
+------------+------------+--------------------+

A primeira linha de cada partição retorna 0.0 porque o desvio padrão de um único valor é zero (comportamento padrão do MaxCompute).

Exemplo 3: Desvio padrão amostral geral

Calcule o desvio padrão amostral dos salários de todos os funcionários.

SELECT STDDEV_SAMP(sal) FROM emp;

Resultado:

+--------------------+
| _c0                |
+--------------------+
| 1301.6180541247609 |
+--------------------+

Exemplo 4: Desvio padrão amostral com GROUP BY

Agrupe os funcionários por departamento e calcule o desvio padrão amostral dos salários para cada grupo.

SELECT deptno, STDDEV_SAMP(sal)
FROM emp
GROUP BY deptno;

Resultado:

+------------+--------------------+
| deptno     | _c1                |
+------------+--------------------+
| 10         | 1693.7138680032901 |
| 20         | 1123.3320969330487 |
| 30         | 668.3312551921141  |
+------------+--------------------+

Funções relacionadas

A função STDDEV_SAMP funciona tanto como função de agregação quanto como função de janela.

Para funções de agregação, consulte Aggregate functions.
Para funções de janela, consulte Window Functions Overview.