Table.RemoveLastN

Updated on

Table.RemoveLastN is a Power Query M function that removes a specified number or condition-matching rows from the end of a table. The function returns a new table with the rows removed according to the countOrCondition parameter.

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

Syntax

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

Description

Returns a table that does not contain the last countOrCondition rows of the table table. The number of rows removed depends on the optional parameter countOrCondition.

  • If countOrCondition is omitted only the last row is removed.
  • If countOrCondition is a number, that many rows (starting at the bottom) will be removed.
  • If countOrCondition is a condition, the rows that meet the condition will be removed until a row does not meet the condition.

Examples

Remove the last row of the table.

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

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

Remove the last rows where [CustomerID] > 2 of the table.

// Output: Table.FromRecords( {[CustomerID = 1, Name = "Bob", Phone = "123-4567"]} )
Table.RemoveLastN( 
    Table.FromRecords( {
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    } ),
    each [CustomerID] >= 2
 )

Other functions related to Table.RemoveLastN are:

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