La función Table.First devuelve la primera fila de una tabla.
Table.First(
table as table,
optional default as any
) as any
- table: tabla de la que extraer la primera fila
- default: (opcional) valor a devolver en el caso de que la tabla esté vacía.
El argumento default puede ser un valor simple como un número, fecha, etc. o un valor complejo como un registro, tabla, etc.
Si la función devuelve un valor no nulo, éste es un registro.
Podemos extraer la primera fila de una tabla con la siguiente expresión:
Table.First(
Table.FromRecords(
{
[id = 15, name = "John"],
[id = 21, name = "Alfonso"],
[id = 33, name = "Marta"]
}
)
)
En el caso de que se trate de una tabla vacía, la función devuelve por defecto un valor nulo:
Table.First(
Table.FromRecords(
{
}
)
)
...pero el argumento default puede ser usado para especificar un valor diferente:
Table.First(
Table.FromRecords(
{
}
),
"empty table"
)
Podemos confirmar que el tipo devuelto es un registro con el siguiente código:
let
table = Table.FromRecords(
{
[id = 15, name = "John"],
[id = 21, name = "Alfonso"],
[id = 33, name = "Marta"]
}
),
row = Table.First(table)
in
Value.Is(
row,
type record
)
TRUE
