跳至主要内容

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