Table.RenameColumnsTable.RenameColumns

SyntaxSyntax

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

InfoAbout

Führt die angegebenen Umbenennungen für die Spalten in Tabelle table aus.Performs the given renames to the columns in table table. Ein Ersetzungsvorgang renames besteht aus einer Liste von zwei Werten: dem alten Spaltennamen und dem neuen Spaltennamen, die in einer Liste bereitgestellt werden.A replacement operation renames consists of a list of two values, the old column name and new column name, provided in a list. Wenn die Spalte nicht existiert, wird eine Ausnahme ausgelöst, es sei denn, der optionale Parameter missingField gibt eine Alternative an (z. B.If the column doesn't exist, an exception is thrown unless the optional parameter missingField specifies an alternative (eg. MissingField.UseNull oder MissingField.Ignore).MissingField.UseNull or MissingField.Ignore).

Beispiel 1Example 1

Ersetzen des Spaltennamens „CustomerNum“ in der Tabelle durch „CustomerID“Replace the column name "CustomerNum" with "CustomerID" in the table.

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerNum", "CustomerID"}
)
CustomerIDCustomerID NameName PhonePhone
11 BerndBob 12 34 56 7123-4567

Beispiel 2Example 2

Ersetzen des Spaltennamens „CustomerNum“ in der Tabelle durch „CustomerID“ und „PhoneNum“ durch „Phone“Replace the column name "CustomerNum" with "CustomerID" and "PhoneNum" with "Phone" in the table.

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", PhoneNum = "123-4567"]}),
    {
        {"CustomerNum", "CustomerID"},
        {"PhoneNum", "Phone"}
    }
)
CustomerIDCustomerID NameName PhonePhone
11 BerndBob 12 34 56 7123-4567

Beispiel 3Example 3

Ersetzen des Spaltennamens „NewCol“ in der Tabelle durch „NewColumn“. Wenn die Spalte nicht vorhanden ist, wird der Vorgang ignoriert.Replace the column name "NewCol" with "NewColumn" in the table, and ignore if the column doesn't exist.

Table.RenameColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"NewCol", "NewColumn"},
    MissingField.Ignore
)
CustomerIDCustomerID NameName PhonePhone
11 BerndBob 12 34 56 7123-4567