Table.ReorderColumnsTable.ReorderColumns

SintaxeSyntax

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

SobreAbout

Retorna uma tabela da entrada table, com as colunas na ordem especificada por columnOrder.Returns a table from the input table, with the columns in the order specified by columnOrder. As colunas que não forem especificadas na lista não serão reordenadas.Columns that are not specified in the list will not be reordered. Se a coluna não existir, uma exceção será gerada, a menos que o parâmetro opcional missingField especifique uma alternativa (por exemplo,If the column doesn't exist, an exception is thrown unless the optional parameter missingField specifies an alternative (eg. MissingField.UseNull ou MissingField.Ignore).MissingField.UseNull or MissingField.Ignore).

Exemplo 1Example 1

Alternar a ordem das colunas [Phone] e [Name] na tabela.Switch the order of the columns [Phone] and [Name] in the table.

Table.ReorderColumns(
    Table.FromRecords({[CustomerID = 1, Phone = "123-4567", Name = "Bob"]}),
    {"Name", "Phone"}
)
CustomerIDCustomerID NomeName TelefonePhone
11 BobBob 123-4567123-4567

Exemplo 2Example 2

Alterne a ordem das colunas [Phone] e [Address] ou use "MissingField.Ignore" na tabela.Switch the order of the columns [Phone] and [Address] or use "MissingField.Ignore" in the table. Ele não altera a tabela porque a coluna [Address] não existe.It doesn't change the table because column [Address] doesn't exist.

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