Table.FirstN

语法

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

关于

根据 countOrCondition 的值，返回 table 表的第一行：

• 如果 countOrCondition 是数字，则返回多个行（从顶部开始）。
• 如果 countOrCondition 是条件，则返回满足条件的行，直到某一行不满足条件为止。

示例 1

查找表的前两行。

使用情况

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
)

输出

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

示例 2

查找表中 [a] > 0 的前几行。

使用情况

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

输出

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