Saltar para o conteúdo principal

Table.TransformColumnNames

Transforma os nomes das colunas utilizando a função especificada.

Syntax​

Table.TransformColumnNames(
    table as table,
    nameGenerator as function,
    optional options as record
) as table

Remarks​

Transforma os nomes das colunas através da função nameGenerator especificada. Opções válidas:

MaxLength especifica o comprimento máximo dos novos nomes de colunas. Se a função especificada resultar num nome de coluna maior, o nome longo será cortado.
Comparer é utilizado para controlar a comparação enquanto são gerados novos nomes de coluna. Os comparadores podem ser utilizados para fornecer comparações não sensíveis a maiúsculas e minúsculas ou comparações baseadas na cultura ou no local.
Os seguintes comparadores incorporados estão disponíveis na linguagem da fórmula:
  • Comparer.Ordinal: utilizado para executar uma comparação ordinal exata
  • Comparer.OrdinalIgnoreCase: utilizado para executar uma comparação ordinal exata não sensível a maiúsculas/minúsculas
  • Comparer.FromCulture: utilizado para executar uma comparação baseada na cultura

Examples​

Example #1​

Remover o caráter <code>#(tab)</code> dos nomes de coluna

Table.TransformColumnNames(Table.FromRecords({[#"Col#(tab)umn" = 1]}), Text.Clean)

Result:

Table.FromRecords({[Column = 1]})

Example #2​

Transformar nomes de coluna para gerar nomes não sensíveis a maiúsculas e minúsculas de comprimento 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