Zum Hauptinhalt springen

Table.RenameColumns

Wendet Umbenennungen im Format "{old, new}" an.

Syntax​

Table.RenameColumns(
    table as table,
    renames as list,
    optional missingField as MissingField.Type
) as table

Remarks​

Nimmt die angegebenen Umbenennungen der Spalten in der Tabelle "table" vor. Ein Ersetzungsvorgang (renames) besteht aus einer Liste mit zwei Werten (alter und neuer Spaltenname), die in einer Liste bereitgestellt wird. Ist die Spalte nicht vorhanden, wird eine Ausnahme ausgelöst, sofern nicht mithilfe des optionalen Parameters "missingField" eine Alternative angegeben wurde (beispielsweise MissingField.UseNull oder MissingField.Ignore).

Examples​

Example #1​

Ersetzt den Spaltennamen "CustomerNum" in der Tabelle durch "CustomerID".

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

Result:

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

Example #2​

Ersetzt den Spaltennamen "CustomerNum" in der Tabelle durch "CustomerID" und "PhoneNum" durch "Phone".

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

Result:

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

Example #3​

Ersetzt den Spaltennamen "NewCol" in der Tabelle durch "NewColumn". Wenn die Spalte nicht vorhanden ist, wird der Vorgang ignoriert.

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

Result:

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

Category​

Table.Column operations