Sums the column in the group.
| Field | Value |
|---|---|
| Category | Statistics |
| Type | Aggregation (operates on a set of rows) |
| Arity | 1 argument (fixed) |
| Compiles to SQL (calculated column) | Yes |
| Version | Formula engine v3. |
Aliases#
Canonical name: SOMA. Accepted aliases (case-insensitive): sum.
Syntax#
code
SOMA(coluna)The 1st argument is the name of a column (bare identifier); the others are expressions.
Returns#
Number.
Null handling#
Blank rows are ignored; an all-blank group returns blank.
Evaluation context#
Aggregation — goes through the rows of the visual's current group.
Differences from DAX#
- DAX equivalent: SUM
- Compatibility: Compatible with DAX
- Note: Sums the column in the visual's current group (not in a model Table[Column]).
Examples#
code
SOMA(receita)Example with values#
Input: column v = 10, 20, 30.
code
SOMA(v) → 60Expected result: 60
Business example#
Total monthly revenue on the KPI card.
Common errors#
Typos in a column name, an incompatible type, or an invalid argument become a friendly message (pt-BR) — the engine never silently returns a wrong number.