Total geral da coluna no visual inteiro.
| Campo | Valor |
|---|---|
| Categoria | Contexto e filtro |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 1 argumento (fixo) |
| Compila para SQL (coluna calculada) | Não |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: SUMTOTAL. Aliases aceitos (maiúsc./minúsc. indiferente): (nenhum).
Assinatura#
código
SUMTOTAL(coluna)O 1º argumento é o nome de uma coluna (identificador nu); os demais são expressões.
Retorno#
Número (total geral do visual).
Tratamento de nulos#
Quando não há linha no contexto trocado, devolve vazio (nunca zero) — um branco é mais honesto que um zero inventado.
Contexto de avaliação#
Soma sobre o visual inteiro (allRows).
Diferenças para DAX#
- Equivalente DAX: —
- Compatibilidade: Sem equivalente direto no DAX
- Observação: Não há função única no DAX; equivale a CALCULATE(SUM(coluna); ALLSELECTED()) do visual.
Exemplos#
código
SUMTOTAL(receita)Exemplo com valores#
Entrada: grupo SP; total do visual = 100.
código
SUMTOTAL(receita) → 100Resultado esperado: 100
Exemplo de negócio#
Medida comparativa — participação no total, ranking, variação contra outro período.
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.