Skip to content

Automatic translation — the Portuguese version is the reference. View in Portuguese

SOMA

On this page (10)

Sums the column in the group.

FieldValue
CategoryStatistics
TypeAggregation (operates on a set of rows)
Arity1 argument (fixed)
Compiles to SQL (calculated column)Yes
VersionFormula 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)  →  60

Expected 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.


← Back to the formula index

Related links