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

在表中将列名“CustomerNum”替换为“CustomerID”。

使用情况

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

输出

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

示例 2

在表中将列名“CustomerNum”替换为“CustomerID”，并将“PhoneNum”替换为“Phone”。

使用情况

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

在表中将列名“NewCol”替换为“NewColumn”；如果列不存在，则忽略。

使用情况

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

输出

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