# SUM

> Função de agregação SUM no StackQL: o total dos valores não NULL de uma coluna ou agrupamento, retornado como inteiro quando todas as entradas são inteiros.

Source: https://stackql.io/pt-br/language-spec/functions/aggregate/sum

Retorna a soma de todos os valores não `NULL` de uma coluna ou de um agrupamento de colunas.  

Veja também:  
[[` SELECT `]](/language-spec/select) [[` TOTAL `]](/language-spec/functions/aggregate/total)

* * * 

:::tip

Use a função [**TOTAL**](/language-spec/functions/aggregate/total) para somar números de ponto flutuante ou valores longos.

:::

## Sintaxe

```sql
SELECT SUM(columnExpression) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];
```

## Argumentos

__*columnExpression*__  
Uma coluna ou expressão.

> Se todos os valores de *columnExpression* forem `NULL`, `SUM` retorna `NULL`.  

> `SUM` gera uma exceção "integer overflow" se ocorrer um estouro de inteiro em qualquer ponto do cálculo.  A função [`TOTAL`](/language-spec/functions/aggregate/total) nunca gera um estouro de inteiro.  

__*groupByColumn*__  
Uma ou mais colunas usadas para realizar operações de resumo ou de agregação.  A cláusula `GROUP BY` retorna uma linha para cada agrupamento de colunas.

## Valor(es) retornado(s)

Retorna um inteiro que representa a soma de *columnExpression* se todas as entradas não `NULL` forem inteiros. Se alguma entrada não for um inteiro ou for `NULL`, retorna um valor de ponto flutuante que pode ser uma aproximação da soma real.

* * *

## Exemplos

### Retornar a soma de uma expressão de coluna em todo um recurso

```sql
SELECT sum(json_array_length(disks)) as sum_disks
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### Retornar a soma de uma expressão de coluna agrupada por outra expressão de coluna

```sql
SELECT tags, sum(json_array_length(disks)) as sum_disks
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a'
GROUP BY json_extract(tags, '$.instanceType');
```

### Usar `SUM` como função de janela para calcular totais acumulados

```sql
-- Calculate running total and percentage of contributions
SELECT
    login,
    contributions,
    SUM(contributions) OVER (ORDER BY contributions DESC) as running_total,
    SUM(contributions) OVER () as total_contributions,
    ROUND(100.0 * contributions / SUM(contributions) OVER (), 2) as pct_of_total
FROM github.repos.contributors
WHERE owner = 'stackql'
  AND repo = 'stackql';
```

Para obter mais informações, consulte [https://www.sqlite.org/lang_aggfunc.html#sumunc](https://www.sqlite.org/lang_aggfunc.html#sumunc).
