Soma a coluna no grupo.
| Campo | Valor |
|---|---|
| Categoria | Estatística |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 1 argumento (fixo) |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: SOMA. Aliases aceitos (maiúsc./minúsc. indiferente): sum.
Assinatura#
código
SOMA(coluna)O 1º argumento é o nome de uma coluna (identificador nu); os demais são expressões.
Retorno#
Número.
Tratamento de nulos#
Linhas vazias são ignoradas; grupo todo vazio devolve vazio.
Contexto de avaliação#
Agregação — percorre as linhas do grupo atual do visual.
Diferenças para DAX#
- Equivalente DAX: SUM
- Compatibilidade: Compatível com DAX
- Observação: Soma a coluna no grupo atual do visual (não numa Tabela[Coluna] do modelo).
Exemplos#
código
SOMA(receita)Exemplo com valores#
Entrada: coluna v = 10, 20, 30.
código
SOMA(v) → 60Resultado esperado: 60
Exemplo de negócio#
Faturamento total do mês no cartão de KPI.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.