Table.TransformColumnNames

Sintaxe

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

Sobre

Transforma nomes de coluna usando a função fornecida nameGenerator . Opções válidas:

MaxLength especifica o comprimento máximo de novos nomes de coluna. Se a função fornecida resultar com um nome de coluna mais longo, 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 que não diferenciam maiúsculas de minúsculas ou cultura e reconhecimento de localidade.

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

• Comparer.Ordinal: usado para executar uma comparação ordinal exata
• Comparer.OrdinalIgnoreCase: usado para executar uma comparação ordinal exata que não diferencia maiúsculas de minúsculas
• Comparer.FromCulture: usado para executar uma comparação com reconhecimento de cultura

Exemplo 1

Remover o #(tab) caractere de nomes de coluna

Usage

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

Saída

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

Exemplo 2

Transformar nomes de coluna para gerar nomes que não diferenciam maiúsculas de minúsculas de comprimento 6.

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

Conteúdo relacionado

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