Table.RenameColumns

Składnia

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

Informacje

Wykonuje podane zmiany nazw kolumn w tabeli table. Operacja renames zamiany składa się z listy dwóch wartości, starej nazwy kolumny i nowej nazwy kolumny podanej na liście. Jeśli kolumna nie istnieje, zostanie zgłoszony wyjątek, chyba że opcjonalny parametr missingField określa alternatywę (np. MissingField.UseNull lub MissingField.Ignore).

Przykład 1

Zastąp nazwę kolumny "CustomerNum" nazwą "CustomerID" w tabeli.

Użycie

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

Wyjście

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

Przykład 2

Zastąp nazwę kolumny "CustomerNum" na "CustomerID" i "PhoneNum" na "Phone" w tabeli.

Użycie

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

Wyjście

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

Przykład 3

Zastąp nazwę kolumny "NewCol" na "NewColumn" w tabeli i zignoruj, jeśli kolumna nie istnieje.

Użycie

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

Wyjście

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