Table.First

La función Table.First devuelve la primera fila de una tabla.

Sintaxis

Table.First(
    table as table,
    optional default as any
) as any

Parámetros
  • table: tabla de la que extraer la primera fila
  • default: (opcional) valor a devolver en el caso de que la tabla esté vacía.
Información adicional

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.

Ejemplos

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"]
        }
    )
)

Función M Table.First

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(
        {
        }
    )
)

Función M Table.First

...pero el argumento default puede ser usado para especificar un valor diferente:

Table.First(
    Table.FromRecords(
        {
        }
    ),
    "empty table"
)

Función M Table.First

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

Función M Table.First
Categoría
Funciones de tabla
Enviado por admin el Vie, 07/08/2020 - 08:35