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