Table.TransformColumnNames

Sintaxe

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

Sobre nós

Transforma os nomes das colunas usando a função nameGenerator fornecida. Opções válidas:

MaxLength especifica o comprimento máximo dos novos nomes de coluna. Se a função dada resultar com um nome de coluna mais longo, o nome longo será cortado.

Comparer é usado para controlar a comparação enquanto gera novos nomes de coluna. Os comparadores podem ser usados para fornecer comparações que não diferenciam maiúsculas de minúsculas ou que são sensíveis à cultura e localidade.

Os seguintes comparadores incorporados estão disponíveis no idioma da fórmula:

• Comparer.Ordinal: Usado para realizar uma comparação ordinal exata
• Comparer.OrdinalIgnoreCase: Usado para realizar uma comparação ordinal exata sem diferenciação de maiúsculas e minúsculas
• Comparer.FromCulture: Usado para realizar uma comparação sensível à cultura

Exemplo 1

Remover o caractere #(tab) dos nomes das colunas

Utilização

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

Saída

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

Exemplo 2

Transforme os nomes de colunas para gerar nomes insensíveis a maiúsculas com comprimento de 6.

Utilização

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

Conteúdo relacionado

• Como a cultura afeta a formatação de texto