Table.RenameColumns

Syntaxe

Table.RenameColumns(table as table, renames as list, optional missingField as nullable number) as table

À propos

Effectue les renommages spécifiés des colonnes dans la table table. Une opération de remplacement renames comporte deux valeurs, l’ancien nom de colonne et le nouveau nom de colonne, fournies sous forme de liste. Si la colonne n’existe pas, une exception est levée, sauf si le paramètre facultatif missingField spécifie une alternative (par exemple MissingField.UseNull ou MissingField.Ignore).

Exemple 1

Remplace le nom de colonne « CustomerNum » par « CustomerID » dans la table.

Utilisation

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", Phone = "123-4567"]}),
    {"CustomerNum", "CustomerID"}
)

Sortie

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})

Exemple 2

Remplace le nom de colonne « CustomerNum » par « CustomerID » et « PhoneNum » par « Phone » dans la table.

Utilisation

Table.RenameColumns(
    Table.FromRecords({[CustomerNum = 1, Name = "Bob", PhoneNum = "123-4567"]}),
    {
        {"CustomerNum", "CustomerID"},
        {"PhoneNum", "Phone"}
    }
)

Sortie

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})

Exemple 3

Remplace le nom de colonne « NewCol » par « NewColumn » dans la table, et ignore la requête si la colonne n’existe pas.

Utilisation

Table.RenameColumns(
    Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
    {"NewCol", "NewColumn"},
    MissingField.Ignore
)

Sortie

Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})