Table.SelectColumns

Syntax

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

Info

Gibt die table nur mit den angegebenen columns zurück.

• table: Die angegebene Tabelle.
• columns: Die Liste der Spalten aus der Tabelle table, die zurückgegeben werden soll. Die Spalten in der zurückgegebenen Tabelle sind in der in columns aufgelisteten Reihenfolge.
• missingField: (Optional) Aktion bei Nichtvorhandensein der Spalte Beispiele sind MissingField.UseNull oder MissingField.Ignore.

Beispiel 1

Einschließen nur der Spalte [Name].

Verwendung

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"
)

Ausgabe

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

Beispiel 2

Einschließen nur der Spalten [CustomerID] und [Name].

Verwendung

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

Ausgabe

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

Beispiel 3

Wenn die eingeschlossene Spalte nicht vorhanden ist, wird standardmäßig ein Fehler als Ergebnis zurückgegeben.

Verwendung

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

Ausgabe

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

Beispiel 4

Wenn die eingeschlossene Spalte nicht vorhanden ist, erstellt die Option MissingField.UseNull eine Spalte mit NULL-Werten.

Verwendung

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

Ausgabe

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