Table.AddColumn is a Power Query M function that adds a new column to a table, with values calculated using the specified columnGenerator function. The function returns a modified table with the new column added.
Compatible with: Power BI Service Power BI Desktop Excel Microsoft 365
Syntax
Table.AddColumn(
table as table,
newColumnName as text,
columnGenerator as function,
optional columnType as nullable type,
) as table
Description
Adds a column named newColumnName
to the table table
. The values for the column are computed using the specified selection function columnGenerator
with each row taken as an input.
Examples
Add a number column named “TotalPrice” to the table, with each value being the sum of the [Price] and [Shipping] columns.
Table.AddColumn(
Table.FromRecords( {
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0, Shipping = 10.00],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0, Shipping = 15.00],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25.0, Shipping = 10.00]
} ),
"TotalPrice",
each [Price] + [Shipping],
type number
)
/* Output:
Table.FromRecords( {
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100, Shipping = 10, TotalPrice = 110],
[OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5, Shipping = 15, TotalPrice = 20],
[OrderID = 3, CustomerID = 2, Item = "Fishing net", Price = 25, Shipping = 10, TotalPrice = 35]
} )
*/
Related functions
Other functions related to Table.AddColumn are:
