Dentro de CALCULAR: se queda solo con las N filas mayores según la expresión — o con los N grupos mayores, si indicas la columna. Un empate en el límite entra completo (puede superar N).
| Campo | Valor |
|---|---|
| Categoría | Contexto y filtro |
| Tipo | Agregación (opera sobre un conjunto de filas) |
| Aridad | 2 a 4 argumentos |
| Se compila a SQL (columna calculada) | No |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: PRIMEIROS_N. Alias aceptados (sin distinguir mayúsculas/minúsculas): topn.
Sintaxis#
PRIMEIROS_N(expr; arg2; [arg3]; [arg4])Todos los argumentos son expresiones.
Retorno#
Modificador de CALCULAR (recorta las N filas/grupos mayores).
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 — solo tiene sentido DENTRO de CALCULAR (o de otra función de contexto que lo acepte). Fuera de eso, avisa en lugar de devolver un número incorrecto.
Diferencias con DAX#
- Equivalente en DAX: TOPN
- Compatibilidad: Compatible con DAX
- Observación: Un empate en el límite entra completo (puede superar N), igual que TOPN. Se usa como modificador de CALCULAR.
Ejemplos#
CALCULAR(SOMA(receita); TUDO(); PRIMEIROS_N(3; SOMA(receita); uf))Ejemplo con valores#
Entrada: suma solo del mayor (SP=60) entre SP y RJ.
CALCULAR(SOMA(receita); PRIMEIROS_N(1; receita)) → 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.