Pular para o conteúdo principal

Table.RenameColumns

Aplica renomeações do formulário {old, new}.

Syntax​

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

Remarks​

Executa a renomeação especificadas nas colunas da tabela table. Uma operação de substituição renames consiste em uma lista de dois valores, os nomes de coluna antigo e 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).

Examples​

Example #1​

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

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​

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

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​

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

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