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