Table.RenameColumns

Syntaks

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

Om

Udfører de angivne omdøbninger til kolonnerne i tabellen table. En erstatningshandling renames består af en liste over to værdier, det gamle kolonnenavn og det nye kolonnenavn, der er angivet på en liste. Hvis kolonnen ikke findes, udløses der en undtagelse, medmindre den valgfri parameter missingField angiver et alternativ (f.eks. MissingField.UseNull eller MissingField.Ignore).

Eksempel 1

Erstat kolonnenavnet "CustomerNum" med "CustomerID" i tabellen.

Brug

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

Output

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

Eksempel 2

Erstat kolonnenavnet "CustomerNum" med "CustomerID" og "PhoneNum" med "Phone" i tabellen.

Brug

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

Output

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

Eksempel 3

Erstat kolonnenavnet "NewCol" med "NewColumn" i tabellen, og ignorer, hvis kolonnen ikke findes.

Brug

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

Output

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