Tabela.FirstN

Sintaxe

Table.FirstN(table as table, countOrCondition as any) as table

Acerca de

Devolve a(s) primeira(s) linha(s) da tabela table, dependendo do valor de countOrCondition:

• Se countOrCondition for um número, muitas linhas (começando no topo) serão retornadas.
• Se countOrCondition for uma condição, as linhas que atendem à condição serão retornadas até que uma linha não atenda à condição.

Exemplo 1

Encontre as duas primeiras linhas da tabela.

Utilização

Table.FirstN(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"]
    }),
    2
)

Saída

Table.FromRecords({
    [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"]
})

Exemplo 2

Encontre as primeiras linhas onde [a] > 0 na tabela.

Utilização

Table.FirstN(
    Table.FromRecords({
        [a = 1, b = 2],
        [a = 3, b = 4],
        [a = -5, b = -6]
    }),
    each [a] > 0
)

Saída

Table.FromRecords({
    [a = 1, b = 2],
    [a = 3, b = 4]
})