Table.RenameColumns

Syntaxe

Table.RenameColumns(table as table, renames as list, optional missingField as nullable number) as table

Informace

Provede dané přejmenování na sloupce v tabulce table. Operace renames nahrazení se skládá ze seznamu dvou hodnot, starého názvu sloupce a nového názvu sloupce, který je uvedený v seznamu. Pokud sloupec neexistuje, vyvolá se výjimka, pokud volitelný parametr missingField neurčí alternativu (např. MissingField.UseNull nebo MissingField.Ignore).

Příklad 1

Nahraďte název sloupce CustomerNum za CustomerID v tabulce.

Využití

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

Výstup

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

Příklad 2

Nahraďte název sloupce CustomerNum za CustomerID a PhoneNum v tabulce.

Využití

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

Výstup

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

Příklad 3

Nahraďte název sloupce NewCol textem NewColumn v tabulce a ignorujte, pokud sloupec neexistuje.

Využití

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

Výstup

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