Compartilhar via


Table.ReorderColumns

Sintaxe

Table.ReorderColumns(table as table, columnOrder as list, optional missingField as nullable number) as table

Sobre

Retorna uma tabela da entrada table, com as colunas na ordem especificada por columnOrder. As colunas que não forem especificadas na lista não serão reordenadas. 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

Alternar a ordem das colunas [Phone] e [Name] na tabela.

Usage

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

Saída

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

Exemplo 2

Alterne a ordem das colunas [Phone] e [Address] ou use "MissingField.Ignore" na tabela. Ele não altera a tabela porque a coluna [Address] não existe.

Usage

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

Saída

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