Table.RenameColumns

Applique les attributions de noms sous la forme {old, new}.

Syntax

Table.RenameColumns(
    table as table,
    renames as list,
    optional missingField as MissingField.Type
) as table

Remarks

Effectue les attributions de noms spécifiées sur les colonnes dans la table table. Une opération de remplacement renames comprend une liste de deux valeurs, l'ancien nom de colonne et le nouveau nom de colonne, fournies dans une liste. Si la colonne n'existe pas, une exception est levée à moins que le paramètre facultatif missingField ne spécifie une alternative (c'est-à-dire MissingField.UseNull ou MissingField.Ignore).

Examples

Example #1

Remplace le nom de la colonne " CustomerNum " de la table par " CustomerID ".

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

Result:

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

Example #2

Remplace les noms de colonne de la table " CustomerNum " par " CustomerID " et " PhoneNum " par " Phone ".

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

Result:

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

Example #3

Remplace le nom de colonne de la table " NewCol " par " NewColumn ", et ignore cette requête si la colonne n'existe pas.

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

Result:

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

Category

Table.Column operations