Table.RenameColumns

Sintaxe

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

Sobre

Executa os renomeações fornecidas para as colunas na tabela table. Uma operação de substituição renames consiste em uma lista de dois valores, o nome de coluna antigo e o novo, fornecidos em uma lista. Se a coluna não existir, uma exceção será gerada, a menos que o parâmetro opcional missingField especifique uma alternativa (por exemplo, MissingField.UseNull ou MissingField.Ignore).

Exemplo 1

Substituir o nome de coluna "CustomerNum" por "CustomerID" na tabela.

Usage

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

Saída

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

Exemplo 2

Substituir o nome de coluna "CustomerNum" por "CustomerID" e "PhoneNum" por "Phone" na tabela.

Usage

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

Saída

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

Exemplo 3

Substituir o nome de coluna "NewCol" por "NewColumn" na tabela e ignorar se a coluna não existir.

Usage

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

Saída

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