Saltar para o conteúdo principal

Table.ReorderColumns

Devolve uma tabela com as colunas pela ordem especificada.

Syntax

Table.ReorderColumns(
table as table,
columnOrder as list,
optional missingField as MissingField.Type
) as table

Remarks

Devolve uma tabela a partir da entrada table, com as colunas pela ordem especificada por columnOrder. As colunas que não forem especificadas na lista não serão reordenadas. Se a coluna não existir, é emitida uma exceção a menos que o parâmetro opcional missingField especifique uma alternativa (por ex.: MissingField.UseNull ou MissingField.Ignore).

Examples

Example #1

Alternar a ordem das colunas [Telefone] e [Nome] na tabela.

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

Result:

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

Example #2

Alternar a ordem das colunas [Telefone] e [Endereço] ou utilizar "MissingField.Ignore" na tabela. Não altera a tabela por a coluna [Endereço] não existir.

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

Result:

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

Category

Table.Column operations