Table.SelectColumns

Syntaxe

Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table

À propos

Retourne la table table avec uniquement les colonnes columns spécifiées.

• table : Table fournie.
• columns : Liste des colonnes de la table table à retourner. Les colonnes de la table retournée sont dans l’ordre indiqué dans columns.
• missingField : (Facultatif) Ce qu’il faut faire quand la colonne n’existe pas. Exemple : MissingField.UseNull ou MissingField.Ignore.

Exemple 1

Inclut uniquement la colonne [Name].

Utilisation

Table.SelectColumns(
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    "Name"
)

Sortie

Table.FromRecords({
    [Name = "Bob"],
    [Name = "Jim"],
    [Name = "Paul"],
    [Name = "Ringo"]
})

Exemple 2

Inclut uniquement les colonnes [CustomerID] et [Name].

Utilisation

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

Sortie

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

Exemple 3

Si la colonne ajoutée n’existe pas, le résultat par défaut est une erreur.

Utilisation

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

Sortie

[Expression.Error] The field 'NewColumn' of the record wasn't found.

Exemple 4

Si la colonne ajoutée n’existe pas, l’option MissingField.UseNull crée une colonne de valeurs null.

Utilisation

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

Sortie

Table.FromRecords({[CustomerID = 1, NewColumn = null]})