Table.SelectColumnsTable.SelectColumns

SyntaxSyntax

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

InfoAbout

Gibt die table nur mit den angegebenen columns zurück.Returns the table with only the specified columns.

  • table: Die angegebene Tabelle.table: The provided table.
  • columns: Die Liste der Spalten aus der Tabelle table, die zurückgegeben werden soll.columns: The list of columns from the table table to return. Die Spalten in der zurückgegebenen Tabelle sind in der in columns aufgelisteten Reihenfolge.Columns in the returned table are in the order listed in columns.
  • missingField: (Optional) Aktion, wenn die Spalte nicht vorhanden ist.missingField: (Optional) What to do if the columnn does not exist. Beispiel: MissingField.UseNull oder MissingField.Ignore.Example: MissingField.UseNull or MissingField.Ignore.

Beispiel 1Example 1

Einschließen nur der Spalte [Name].Only include column [Name].

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"
)
NameName
BobBob
JimJim
PaulPaul
RingoRingo

Beispiel 2Example 2

Einschließen nur der Spalten [CustomerID] und [Name].Only include columns [CustomerID] and [Name].

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

Beispiel 3Example 3

Wenn die eingeschlossene Spalte nicht vorhanden ist, ist das Standardergebnis ein Fehler.If the included column does not exit, the default result is an error.

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

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

Beispiel 4Example 4

Wenn die eingeschlossene Spalte nicht vorhanden ist, erstellt die Option MissingField.UseNull eine Spalte mit NULL-Werten.If the included column does not exit, option MissingField.UseNull creates a column of null values.

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