Table.RenameColumns

Syntax

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

Informácie

Vykoná zadané premenovanie stĺpcov v tabuľke table. Operácia renames nahradenia pozostáva zo zoznamu dvoch hodnôt, starého názvu stĺpca a nového názvu stĺpca, ktoré sú uvedené v zozname. Ak stĺpec neexistuje, vyskytne sa chyba, pokiaľ voliteľný parameter missingField nemôžu byť alternatívnou hodnotou (napr. MissingField.UseNull alebo MissingField.Ignore).

Príklad č. 1

Nahradenie názvu stĺpca CustomerNum názvom CustomerID v tabuľke.

Použitie

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

Výkon

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

Príklad č. 2

Nahradenie názvu stĺpca CustomerNum názvom CustomerID a názvu PhoneNum názvom Phone v tabuľke.

Použitie

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

Výkon

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

Príklad č. 3

Nahradenie názvu stĺpca NewCol názvom NewColumn v tabuľke a ignorovanie, ak stĺpec neexistuje.

Použitie

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

Výkon

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