La función Table.FirstN devuelve las primeras N filas de una tabla o las primeras que satisfagan una cierta condición.
Table.FirstN(
table as table,
countOrCondition as any
) as table
- table: tabla de la que extraer las primeras filas
- countOrCondition: número de filas a extraer o condición que deberán satisfacer para ser seleccionadas
Si el argumento countOrCondition es un valor numérico, se extraerá dicho número de filas del comienzo de la tabla. Si la tabla no tiene tantos elementos como se haya indicado, se devuelve la tabla completa.
Si se trata de una condición, la función extraerá las filas del comienzo de la tabla que la satisfagan hasta que encuentre la primera que no lo haga.
Si se especifica 0 como número de filas a extraer, o si ninguna fila satisface la condición indicada, la función devuelve una tabla vacía.
En este ejemplo estamos extrayendo las dos primeras filas de una tabla:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 35],
[id = 21, name = "Alfonso", age = 58],
[id = 33, name = "Marta", age = 22],
[id = 21, name = "Sonia", age = 40],
[id = 21, name = "Manuel", age = 18]
}
)
in
Table.FirstN(
table,
2
)
Siguiendo con el mismo ejemplo, podríamos extraer los registros del comienzo de la tabla en los que el campo "age" tome un valor superior a 30 con el siguiente código:
let
table = Table.FromRecords(
{
[id = 1, name = "John", age = 35],
[id = 21, name = "Alfonso", age = 58],
[id = 33, name = "Marta", age = 40],
[id = 21, name = "Sonia", age = 22],
[id = 21, name = "Manuel", age = 38]
}
)
in
Table.FirstN(
table,
each [age] > 30
)
