Table.RenameColumns

Sintaxe

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

Sobre

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