Zdieľať cez

Table.SelectColumns

  • Článok

Syntax

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

Informácie

Vráti hodnotu table iba so zadanými parametrami columns.

  • table: Zadaná tabuľka.
  • columns: Zoznam stĺpcov z tabuľky table , ktoré sa majú vrátiť. Stĺpce vo vrátenej tabuľke sú v poradí uvedenom v columnszozname .
  • missingField: (Voliteľné) Postup v prípade, ak stĺpec neexistuje. Príklad: MissingField.UseNull alebo MissingField.Ignore.

Príklad č. 1

Zahrňte iba stĺpec [Name].

Použitie

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

Výkon

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

Príklad č. 2

Zahrňte iba stĺpce [CustomerID] a [Name].

Použitie

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

Výkon

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

Príklad č. 3

Ak zahrnutý stĺpec neexistuje, predvoleným výsledkom je chyba.

Použitie

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

Výkon

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

Príklad č. 4

Ak zahrnutý stĺpec neexistuje, možnosť MissingField.UseNull vytvorí stĺpec s hodnotami null.

Použitie

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

Výkon

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