Table.RenameColumns

Применяет переименование в форме {old, new}.

Syntax

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

Remarks

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

Examples

Example #1

Замена имени столбца CustomerNum на 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

Замена имени столбца CustomerNum на CustomerID, а имя PhoneNum на 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

Замена имени столбца NewCol на NewColumn в таблице и пропуск замены, если столбца не существует.

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