Dentro de CALCULAR: mantiene solo las filas en las que la condición es verdadera.
| Campo | Valor |
|---|---|
| Categoría | Contexto y filtro |
| Tipo | Agregación (opera sobre un conjunto de filas) |
| Aridad | 1 argumento (fijo) |
| Se compila a SQL (columna calculada) | No |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: FILTRAR. Alias aceptados (sin distinguir mayúsculas/minúsculas): filter.
Sintaxis#
FILTRAR(expr)Todos los argumentos son expresiones.
Retorno#
Modificador/tabla virtual (no devuelve un valor por sí solo).
Tratamiento de nulos#
Cuando no hay filas en el contexto modificado, devuelve vacío (nunca cero) — un vacío es más honesto que un cero inventado.
Contexto de evaluación#
Modificador de CALCULAR (recorta el contexto) O tabla virtual del 1.er argumento de un iterador. Recibe los nodos sin evaluar (evaluación diferida).
Diferencias con DAX#
- Equivalente en DAX: FILTER
- Compatibilidad: DIFIERE de DAX — semántica diferente, atención
- Observación: Recibe solo una CONDICIÓN booleana (no tabla + condición). Se usa como modificador de CALCULAR o como 1.er argumento (tabla virtual) de un iterador.
Ejemplos#
CALCULAR(SOMA(receita); FILTRAR(uf = "SP"))Ejemplo con valores#
Entrada: suma solo del canal loja (60), en un visual loja+site.
CALCULAR(SOMA(receita); FILTRAR(canal = "loja")) → 60Resultado esperado: 60
Ejemplo de negocio#
Medida comparativa — participación en el total, ranking, variación frente a otro período.
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.