Table.RenameColumns

Sintaxe

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

Acerca de

Executa as renomeações fornecidas para as colunas na tabela table. Uma operação renames de substituição consiste em uma lista de dois valores, o nome da coluna antiga e o nome da nova coluna, 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

Substitua o nome da coluna "CustomerNum" por "CustomerID" na tabela.

Utilização

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

Substitua o nome da coluna "CustomerNum" por "CustomerID" e "PhoneNum" por "Phone" na tabela.

Utilização

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

Substitua o nome da coluna "NewCol" por "NewColumn" na tabela e ignore se a coluna não existir.

Utilização

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"]})