Power Query Formula Language M : Table Functions Part 1

In previous post you’ve learned about Formula language of the Power Query known as "M". you’ve learned that M is a functional language that apply data transformations through script. In examples of previous post you’ve learned some of table functions such as Table.AddColumn, Table.Sort, Table.Join, and Table.PrefixColumns. In this post we will discover more table functions through an example.

In this post you will learn these functions:

Table.AddColumn

Table.RemoveColumns

Table.ReorderColumns

Table.SelectColumns

Table.Sort

Table.ReplaceValue

Table.FillDown

Table.AddIndexColumn

Table.RenameColumns

This function renames one or more columns of a table to desired name(s).

let’s apply this function on a sample table. here is the sample table generated from previous example:

this is the script that generates above table:

let
     TableA = #table({"CustomerId", "TranDate","TranCount"},
    {
    {1,DateTime.FromText("2014-01-01 01:00:00.000"),10},
    {1,DateTime.FromText("2014-01-01 02:00:00.000"),5},
    {1,DateTime.FromText("2014-01-03 01:00:00.000"),5},
    {1,DateTime.FromText("2014-01-04 02:00:00.000"),80}
    }),

    TableB = #table({"CustomerId", "TranDate","TranCount"},
    {
    {1,DateTime.FromText("2014-01-01 02:00:00.000"),10},
    {1,DateTime.FromText("2014-01-01 03:00:00.000"),5},
    {1,DateTime.FromText("2014-01-02 01:00:00.000"),20},
    {1,DateTime.FromText("2014-01-02 03:00:00.000"),15},
    {2,DateTime.FromText("2014-01-01 01:00:00.000"),5},
    {2,DateTime.FromText("2014-01-01 02:00:00.000"),80}
    }),
    TableATransformed=Table.Sort(
                Table.AddColumn(TableA,"Date",each Date.From([TranDate]))
                    ,{"CustomerId","TranDate"}
                                    ) ,
    TableBTransformed=Table.Sort(
                Table.AddColumn(TableB,"Date",each Date.From([TranDate]))
                    ,{"CustomerId","TranDate"}
                                    )  ,
        TableAGrouped=Table.Group(TableATransformed,{"CustomerId","Date"},{"Total",each List.Last([TranCount])}),
        TableBGrouped=Table.Group(TableBTransformed,{"CustomerId","Date"},{"Total",each List.Last([TranCount])}),
    ResultTable=Table.Join(Table.PrefixColumns(TableAGrouped,"TableA"),{"TableA.CustomerId","TableA.Date"},TableBGrouped,{"CustomerId","Date"},JoinKind.FullOuter)
in
    ResultTable

Now we want to rename last three column of the table with a new prefix "TableB.". Here is how we can do that with Table.RenameColumns

let

…..

,RenamedTable=Table.RenameColumns(ResultTable,{ {"CustomerId","TableB.CustomerId"},{"Date","TableB.Date"},{"Total","TableB.Total"} })

in
        RenamedTable

Result would be the below table

Here is the structure of Table.RenameColumns

Table.RenameColumns(<table>,( {<column name before change>,<column name after change>},{repeat for more columns} } )

Table.AddColumn

This function adds a column to the table. You would assign name of the new column and the script to generate new column. the new column generator can be a static value or an expression.

In this example we want to add three columns that be generated based on expressions from existing columns of RenamedTable. we want a new CustomerId Column to be generated from TableA.CustomerId, but if it is null, then it should get its value from TableB.CustomerId.

Here is the script to generate the new CustomerId Column:

,CustomerColumnAddedTable=Table.AddColumn(RenamedTable,"CustomerId",each if [TableA.CustomerId] is null then [TableB.CustomerId] else [TableA.CustomerId])
in
        CustomerColumnAddedTable

 Result table showed below:

As you see in the above expression we used IF structure which is the very handy conditional structure in M. the <IF> structure is simply as below:

If <condition>

then <if true>

else <if false>

The good thing about If is that it can be used within expressions to build the table/record/lists and etc (as you seen in this example).

The EACH keyword is required to generate expression for each record of the dataset.

here is structure of Table.AddColumn function:

Table.AddColumn(<table>,<new column name>,<new column generator>,<data type optional>)

we use AddColumn function to add another column as below:

,CustomerColumnAddedTable=Table.AddColumn(RenamedTable,"CustomerId",each if [TableA.CustomerId] is null then [TableB.CustomerId] else [TableA.CustomerId])
        ,DateColumnAddedTable=Table.AddColumn(CustomerColumnAddedTable,"Date",each if [TableA.Date] is null then [TableB.Date] else [TableA.Date])
in
        DateColumnAddedTable

Result showed below:

Table.RemoveColumns

This function removes one or more columns from the table.

we can use this function to remove extra columns such as TableA.CustomerId, TableB.CustomerId, TableA.Date, and TableB.Date from the table.

Here is the script:

,ColumnsRemoved=Table.RemoveColumns(DateColumnAddedTable,{"TableA.CustomerId","TableB.CustomerId","TableA.Date","TableB.Date"})
in
        ColumnsRemoved

Result would be as below:

structure of Table.RemoveColumns is as below:

Table.RemoveColumn(<table>,{columns to remove separated by comma})

Table.ReorderColumns

changes order of columns in table.

here is the expression that we used to reorder columns of this table:

        ,ColumnsOrdered=Table.ReorderColumns(ColumnsRemoved,{"CustomerId","Date","TableA.Total","TableB.Total"})
in
        ColumnsOrdered

Result would be as below:

here is the structure of Table.ReorderColumns

Table.ReorderColumns(<table>,{order of columns as desired in output})

Table.SelectColumns

This function selects specific columns from a table with the order defined. This function is a combination of Table.RemoveColumns and Table.ReorderColumns.

this script will result same table as above but with only a single function Table.SelectColumns instead of using Table.RemoveColumns and Table.ReorderColumns.

,ColumnsSelected=Table.SelectColumns(DateColumnAddedTable,{"CustomerId","Date","TableA.Total","TableB.Total"})
in
        ColumnsSelected

Result would be the same

Table.Sort

Sorts a table on the desired ordering list

,SortedTable=Table.Sort(ColumnsSelected,{"CustomerId","Date"})
in
        SortedTable

Result would be as below:

Here is the Table.Sort function structure

Table.Sort(<table>,{sorting criteria})

Table.ReplaceValue

This function replace all old values with new value from the specific column in the table.

the expression below would replace all NULL values in TableA.Total with 0.

 ,ValueReplaced=Table.ReplaceValue(SortedTable,null,0,Replacer.ReplaceValue,{"TableA.Total"})
in
        ValueReplaced

Result showed below:

Here is the structure of Table.ReplaceValue function

Table.ReplaceValue(<table>,<old value>,<new value>,<replacer function>,{column name})

replacer function can be Replacer.ReplaceValue or Replacer.ReplaceText

Table.FillDown

This function will fill the value from upper record down to the null values of the records after that.

Here is the example: (we want to fill down the values of columns TableB.Total, that means if a record has null value for this column, then the value would be fetched from the most recent top record that has a not null value)

        ,FilledDown=Table.FillDown(ValueReplaced,"TableB.Total")
in
        FilledDown

result would be as below:

Here is the structure of Table.FillDown function

Table.FillDown(<table>,<Column>)

Table.AddIndexColumn

This function adds an identity auto increment column to the table. you can specify the column name, initial value, and the increment seed.

This is a sample expression:

        ,IndexAdded=Table.AddIndexColumn(FilledDown,"Index",10000,10)
in
        IndexAdded

Result is as below:

Here is the structure for this function:

Table.AddIndexColumn(<table>,<column name>,<initial value>,<increment seed>)

Here is the full script for this example:

let
     TableA = #table({"CustomerId", "TranDate","TranCount"},
    {
    {1,DateTime.FromText("2014-01-01 01:00:00.000"),10},
    {1,DateTime.FromText("2014-01-01 02:00:00.000"),5},
    {1,DateTime.FromText("2014-01-03 01:00:00.000"),5},
    {1,DateTime.FromText("2014-01-04 02:00:00.000"),80}
    }),

    TableB = #table({"CustomerId", "TranDate","TranCount"},
    {
    {1,DateTime.FromText("2014-01-01 02:00:00.000"),10},
    {1,DateTime.FromText("2014-01-01 03:00:00.000"),5},
    {1,DateTime.FromText("2014-01-02 01:00:00.000"),20},
    {1,DateTime.FromText("2014-01-02 03:00:00.000"),15},
    {2,DateTime.FromText("2014-01-01 01:00:00.000"),5},
    {2,DateTime.FromText("2014-01-01 02:00:00.000"),80}
    }),
    TableATransformed=Table.Sort(
                Table.AddColumn(TableA,"Date",each Date.From([TranDate]))
                    ,{"CustomerId","TranDate"}
                                    ) ,
    TableBTransformed=Table.Sort(
                Table.AddColumn(TableB,"Date",each Date.From([TranDate]))
                    ,{"CustomerId","TranDate"}
                                    )  ,
        TableAGrouped=Table.Group(TableATransformed,{"CustomerId","Date"},{"Total",each List.Last([TranCount])}),
        TableBGrouped=Table.Group(TableBTransformed,{"CustomerId","Date"},{"Total",each List.Last([TranCount])}),
    ResultTable=Table.Join(Table.PrefixColumns(TableAGrouped,"TableA"),{"TableA.CustomerId","TableA.Date"},TableBGrouped,{"CustomerId","Date"},JoinKind.FullOuter)
    ,RenamedTable=Table.RenameColumns(ResultTable,{ {"CustomerId","TableB.CustomerId"},{"Date","TableB.Date"},{"Total","TableB.Total"} })
    ,CustomerColumnAddedTable=Table.AddColumn(RenamedTable,"CustomerId",each if [TableA.CustomerId] is null then [TableB.CustomerId] else [TableA.CustomerId])
        ,DateColumnAddedTable=Table.AddColumn(CustomerColumnAddedTable,"Date",each if [TableA.Date] is null then [TableB.Date] else [TableA.Date])
        ,ColumnsRemoved=Table.RemoveColumns(DateColumnAddedTable,{"TableA.CustomerId","TableB.CustomerId","TableA.Date","TableB.Date"})
        ,ColumnsOrdered=Table.ReorderColumns(ColumnsRemoved,{"CustomerId","Date","TableA.Total","TableB.Total"})
        ,ColumnsSelected=Table.SelectColumns(DateColumnAddedTable,{"CustomerId","Date","TableA.Total","TableB.Total"})
        ,SortedTable=Table.Sort(ColumnsSelected,{"CustomerId","Date"})
        ,ValueReplaced=Table.ReplaceValue(SortedTable,null,0,Replacer.ReplaceValue,{"TableA.Total"})
        ,FilledDown=Table.FillDown(ValueReplaced,"TableB.Total")
        ,IndexAdded=Table.AddIndexColumn(FilledDown,"Index",10000,10)
in
        IndexAdded

There are many other table functions in Power Query which we will go through them with more samples in next blog posts.

Reza Rad on FacebookReza Rad on LinkedinReza Rad on TwitterReza Rad on Youtube
Reza Rad
Trainer, Consultant, Mentor
Reza Rad is a Microsoft Regional Director, an Author, Trainer, Speaker and Consultant. He has a BSc in Computer engineering; he has more than 20 years’ experience in data analysis, BI, databases, programming, and development mostly on Microsoft technologies. He is a Microsoft Data Platform MVP for 12 continuous years (from 2011 till now) for his dedication in Microsoft BI. Reza is an active blogger and co-founder of RADACAD. Reza is also co-founder and co-organizer of Difinity conference in New Zealand, Power BI Summit, and Data Insight Summit.
Reza is author of more than 14 books on Microsoft Business Intelligence, most of these books are published under Power BI category. Among these are books such as Power BI DAX Simplified, Pro Power BI Architecture, Power BI from Rookie to Rock Star, Power Query books series, Row-Level Security in Power BI and etc.
He is an International Speaker in Microsoft Ignite, Microsoft Business Applications Summit, Data Insight Summit, PASS Summit, SQL Saturday and SQL user groups. And He is a Microsoft Certified Trainer.
Reza’s passion is to help you find the best data solution, he is Data enthusiast.
His articles on different aspects of technologies, especially on MS BI, can be found on his blog: https://radacad.com/blog.

Leave a Reply