# TOTAL

> Função de agregação TOTAL no StackQL: o total dos valores não NULL de uma coluna ou agrupamento, sempre retornado como número de ponto flutuante.

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

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) [[` SUM `]](/language-spec/functions/aggregate/sum)

* * * 

## Sintaxe

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

## Argumentos

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

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

__*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 valor de ponto flutuante que representa a soma de *columnExpression*.

* * *

## Exemplos

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

```sql
SELECT total(json_array_length(disks)) as total_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, total(json_array_length(disks)) as total_disks
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a'
GROUP BY json_extract(tags, '$.instanceType');
```

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