Hoppa till huvudinnehåll

Table.RenameColumns

Tillämpar namnbyten i formatet {old, new}.

Syntax​

Table.RenameColumns(
    table as table,
    renames as list,
    optional missingField as MissingField.Type
) as table

Remarks​

Genomför angivna namnbyten på kolumnerna i tabellen table. En ersättningsåtgärd, renames, består av en lista med två värden, det gamla kolumnnamnet och det nya kolumnnamnet, som anges i en lista. Om kolumnen inte finns genereras ett undantag såvida inte den valfria parametern missingField anger ett alternativ (t.ex. MissingField.UseNull eller MissingField.Ignore).

Examples​

Example #1​

Ersätt kolumnnamnet CustomerNum med CustomerID i tabellen.

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerNum", "CustomerID"}
)

Result:

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})

Example #2​

Ersätt kolumnnamnet CustomerNum med CustomerID och PhoneNum med Phone i tabellen.

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", PhoneNum = "123-4567"]}),
    {
        {"CustomerNum", "CustomerID"},
        {"PhoneNum", "Phone"}
    }
)

Result:

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})

Example #3​

Ersätt kolumnnamnet NewCol med NewColumn i tabellen och ignorera om kolumnen inte finns.

Table.RenameColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"NewCol", "NewColumn"},
    MissingField.Ignore
)

Result:

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})

Category​

Table.Column operations