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"]})