Table.TransformColumnNames

Syntax

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

About

使用给定 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]})