Table.TransformColumnNames

语法

Table.TransformColumnNames(table as table, nameGenerator as function, optional options as nullable record) as table

关于

使用给定的 nameGenerator 函数转换列名。 有效选项:

MaxLength 指定新列名的最大长度。 如果给定函数使得列名较长,则将对较长的名称进行剪裁。

Comparer 用于在生成新列名时控制比较。 比较器可用于提供不区分大小写或区分区域性和区域设置的比较。

以下内置比较器支持公式语言:

  • Comparer.Ordinal:用于执行精确的序号比较
  • Comparer.OrdinalIgnoreCase:用于执行精确的、不区分大小写的序号比较
  • Comparer.FromCulture:用于执行区分区域性的比较

示例 1

从列名中删除 #(tab) 字符

使用情况

Table.TransformColumnNames(Table.FromRecords({[#"Col#(tab)umn" = 1]}), Text.Clean)

输出

Table.FromRecords({[Column = 1]})

示例 2

转换列名以生成不区分大小写的名称(长度为 6)。

使用情况

Table.TransformColumnNames(
    Table.FromRecords({[ColumnNum = 1, cOlumnnum = 2, coLumnNUM = 3]}),
    Text.Clean,
    [MaxLength = 6, Comparer = Comparer.OrdinalIgnoreCase]
)

输出

Table.FromRecords({[Column = 1, cOlum1 = 2, coLum2 = 3]})