跳到主要内容

Table.TransformColumnNames

使用给定的函数转换列名。

Syntax​

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

Remarks​

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

MaxLength 指定新列名的最大长度。如果给定函数生成的列名较长，则长名称将被剪裁。

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

以下内置比较器以公式语言提供:

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

Examples​

Example #1​

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

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

Result:

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

Example #2​

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

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

Result:

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

Category​

Table.Column operations