Table.RenameColumns

Syntax

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

Info

Führt die angegebenen Umbenennungen für die Spalten in Tabelle table aus. Ein Ersetzungsvorgang renames besteht aus einer Liste von zwei Werten: dem alten Spaltennamen und dem neuen Spaltennamen, die in einer Liste bereitgestellt werden. Wenn die Spalte nicht vorhanden ist, wird eine Ausnahme ausgelöst, es sei denn, der optionale Parameter missingField gibt eine Alternative an (z. B. MissingField.UseNull oder MissingField.Ignore).

Beispiel 1

Ersetzen des Spaltennamens „CustomerNum“ in der Tabelle durch „CustomerID“

Verwendung

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

Ausgabe

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

Beispiel 2

Ersetzen des Spaltennamens „CustomerNum“ in der Tabelle durch „CustomerID“ und „PhoneNum“ durch „Phone“

Verwendung

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

Ausgabe

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

Beispiel 3

Ersetzen des Spaltennamens „NewCol“ in der Tabelle durch „NewColumn“. Wenn die Spalte nicht vorhanden ist, wird der Vorgang ignoriert.

Verwendung

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

Ausgabe

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