Table.RenameColumns

Syntaks

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

Om

Utfører de gitte gine nytt navn til kolonnene i tabellen table. En erstatningsoperasjon renames består av en liste med to verdier, det gamle kolonnenavnet og det nye kolonnenavnet, angitt i en liste. Hvis kolonnen ikke finnes, oppstår det et unntak med mindre den valgfrie parameteren missingField angir et alternativ (f.eks. MissingField.UseNull eller MissingField.Ignore).

Eksempel 1

Erstatt kolonnenavnet CustomerNum med CustomerID i tabellen.

Bruk

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

Utdata

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

Eksempel 2

Erstatt kolonnenavnet CustomerNum med «CustomerID» og «PhoneNum» med «Phone» i tabellen.

Bruk

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

Utdata

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

Eksempel 3

Erstatt kolonnenavnet «NewCol» med «NewColumn» i tabellen, og ignorer hvis kolonnen ikke finnes.

Bruk

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

Utdata

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