Compartilhar via

Table.TransformColumnNames

  • Artigo

Sintaxe

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

Sobre

Transforma nomes de colunas ao usar a função nameGenerator fornecida. Opções válidas:

MaxLength especifica o comprimento máximo de novos nomes de coluna. Se a função fornecida resultar em um nome de coluna maior, o nome longo será cortado.

Comparer é usado para controlar a comparação ao gerar novos nomes de coluna. Os comparadores podem ser usados para fornecer comparações com detecção de localidade e cultura ou sem diferenciação de maiúsculas e minúsculas.

Os seguintes comparadores internos estão disponíveis na linguagem da fórmula:

  • Comparer.Ordinal: Usado para executar uma comparação ordinal exata
  • Comparer.OrdinalIgnoreCase: Usado para executar uma comparação ordinal exata sem diferenciação de maiúsculas e minúsculas
  • Comparer.FromCulture: usado para executar uma comparação com detecção de cultura

Exemplo 1

Remover o caractere de #(tab) dos nomes de coluna

Usage

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

Saída

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

Exemplo 2

Transforme nomes de coluna para gerar nomes de comprimento 6 sem diferenciação de maiúsculas e minúsculas.

Usage

Table.TransformColumnNames(
    Table.FromRecords({[ColumnNum = 1, cOlumnnum = 2, coLumnNUM = 3]}),
    Text.Clean,
    [MaxLength = 6, Comparer = Comparer.OrdinalIgnoreCase]
)

Saída

Table.FromRecords({[Column = 1, cOlum1 = 2, coLum2 = 3]})