共用方式為


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