Suma la columna en el grupo.
| Campo | Valor |
|---|---|
| Categoría | Estadística |
| Tipo | Agregación (opera sobre un conjunto de filas) |
| Aridad | 1 argumento (fijo) |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: SOMA. Alias aceptados (sin distinguir mayúsculas/minúsculas): sum.
Sintaxis#
código
SOMA(coluna)El 1.er argumento es el nombre de una columna (identificador simple); los demás son expresiones.
Retorno#
Número.
Tratamiento de nulos#
Las filas vacías se ignoran; un grupo todo vacío devuelve vacío.
Contexto de evaluación#
Agregación — recorre las filas del grupo actual del visual.
Diferencias con DAX#
- Equivalente en DAX: SUM
- Compatibilidad: Compatible con DAX
- Observación: Suma la columna en el grupo actual del visual (no en una Tabla[Columna] del modelo).
Ejemplos#
código
SOMA(receita)Ejemplo con valores#
Entrada: columna v = 10, 20, 30.
código
SOMA(v) → 60Resultado esperado: 60
Ejemplo de negocio#
Facturación total del mes en la tarjeta de KPI.
Errores comunes#
Errores de escritura en el nombre de una columna, un tipo incompatible o un argumento inválido se convierten en un mensaje claro (pt-BR) — el motor nunca devuelve un número incorrecto en silencio.