Table.RenameColumns

Syntaxis

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

Over

Voert de gegeven hernoemingen uit van de kolommen in tabel table. Een vervangingsbewerking renames bestaat uit een lijst met twee waarden, de oude kolomnaam en de nieuwe kolomnaam, opgegeven in een lijst. Als de kolom niet bestaat, wordt er een fout gegenereerd, tenzij de optionele parameter missingField een alternatief opgeeft (bijvoorbeeld MissingField.UseNull of MissingField.Ignore).

Voorbeeld 1

Vervang de kolomnaam 'CustomerNum' door 'CustomerID' in de tabel.

Gebruik

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

Uitvoer

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

Voorbeeld 2

Vervang de kolomnaam 'CustomerNum' door 'CustomerID' en 'PhoneNum' door 'Phone' in de tabel.

Gebruik

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

Uitvoer

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

Voorbeeld 3

Vervang de kolomnaam 'NewCol' door 'NewColumn' in de tabel en negeer als de kolom niet bestaat.

Gebruik

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

Uitvoer

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