Table.FirstN

Updated on

Table.FirstN is a Power Query M function that returns the first row(s) of a table depending on the value of countOrCondition. The function returns the first N rows or rows that meet a specific condition.

Compatible with: Power BI Service Power BI Desktop Excel Microsoft 365

Syntax

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

Description

Returns the first row(s) of the table table, depending on the value of countOrCondition:

  • If countOrCondition is a number, that many rows (starting at the top) will be returned.
  • If countOrCondition is a condition, the rows that meet the condition will be returned until a row does not meet the condition.

Examples

Find the first two rows of the table.

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
 )

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

Find the first rows where [a] > 0 in the table.

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

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

Other functions related to Table.FirstN are:

Contribute » | Contributors: Rick de Groot
Microsoft documentation: https://learn.microsoft.com/en-us/powerquery-m/table-firstn