Table.RenameColumns

Синтаксис

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

О программе

Выполняет указанные переименования в столбцы в таблице table. Операция замены renames состоит из списка двух значений, старого имени столбца и нового имени столбца, предоставленного в списке. Если столбец не существует, возникает исключение, кроме случаев, когда с помощью необязательного параметра missingField указана альтернатива (например, MissingField.UseNull или MissingField.Ignore).

Пример 1

Замените имя столбца CustomerNum на CustomerID в таблице.

Использование

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

Выходные данные

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

Пример 2

Замените имя столбца CustomerNum на CustomerID и "Телефон Num" на "Телефон" в таблице.

Использование

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

Выходные данные

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

Пример 3

Замените имя столбца NewCol на NewColumn в таблице и игнорируйте, не существует ли столбец.

Использование

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

Выходные данные

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