Table.FirstN

 

This topic applies to the Power Query Formula Language which can be used with Power Query and Power BI Desktop to build queries that mashup data. See the list of function categories.

Returns the first row(s) of a table, depending on the countOrCondition parameter.

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

ArgumentDescription
TableThe Table to check.
optional countOrConditionDepending on the type, more than one row will be returned.
  • If countOrCondition is a number, 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.

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)  

CustomerIDNamePhone
1Bob123-4567
2Jim987-6543
Show: