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