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á lançada, a menos que o parâmetro missingField opcional 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"]})