Table.RenameColumns

語法

Table.RenameColumns(table as table, renames as list, optional missingField as nullable number) as table

關於

對資料表 table 中的資料行執行指定的重新命名。 取代作業 renames 會由兩個值的清單組成，即清單中提供的舊資料行名稱和新資料行名稱。 如果資料行不存在，則會擲回例外狀況；除非選擇性參數 missingField 指定替代方法 (例如：MissingField.UseNull 或 MissingField.Ignore)。

範例 1

以 "CustomerID" 取代資料表中的資料行名稱 "CustomerNum"。

使用方式

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

輸出

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

範例 2

以 "CustomerID" 取代資料表中的資料行名稱 "CustomerNum"，並以 "Phone" 取代 "PhoneNum"。

使用方式

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

輸出

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

範例 3

以 "NewColumn" 取代資料表中的資料行名稱 "NewCol"，如果資料行不存在，則忽略。

使用方式

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

輸出

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