跳至主要内容

Table.ReorderColumns

傳回資料表,其中資料行會按照指定的順序排列。

Syntax

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

Remarks

從輸入 table 傳回資料表,其中的資料行會依 columnOrder 指定的順序排序。清單中未指定的資料行將不會重新排序。 如果資料行不存在,則引發錯誤,除非選用的參數 missingField 指定了替代方案 (例如 MissingField.UseNullMissingField.Ignore)。

Examples

Example #1

切換資料表中 [Phone] 和 [Name] 資料行的順序。

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

切換資料表中 [Phone] 和 [Address] 資料行的順序或使用 "MissingField.Ignore"。這不會變更表格,因為 [Address] 資料行不存在。

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