Table.SelectColumns
Syntaksi
Table.SelectColumns(table as table, columns as any, optional missingField as nullable number) as table
Tietoja
Palauttaa kohteen table
, joka sisältää vain määritetyt -kohteet columns
.
table
: Annettu taulukko.columns
: Luettelo sarakkeista, jotka palautetaan taulukostatable
. Palautetun taulukon sarakkeet ovat kohteencolumns
luettelossa olevassa järjestyksessä.missingField
: (Valinnainen) Mitä tehdä, jos saraketta ei ole olemassa. Esimerkki:MissingField.UseNull
taiMissingField.Ignore
.
Esimerkki 1
Sisällytä vain sarake [Name].
Käyttö
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"
)
Tuloste
Table.FromRecords({
[Name = "Bob"],
[Name = "Jim"],
[Name = "Paul"],
[Name = "Ringo"]
})
Esimerkki 2
Sisällytä vain sarakkeet [CustomerID] ja [Name].
Käyttö
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "Name"}
)
Tuloste
Table.FromRecords({[CustomerID = 1, Name = "Bob"]})
Esimerkki 3
Jos sisällytettyä saraketta ei ole, oletustulos on virhe.
Käyttö
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
"NewColumn"
)
Tuloste
[Expression.Error] The field 'NewColumn' of the record wasn't found.
Esimerkki 4
Jos sisällytettyä saraketta ei ole, vaihtoehto MissingField.UseNull
luo tyhjäarvoja sisältävän sarakkeen.
Käyttö
Table.SelectColumns(
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]}),
{"CustomerID", "NewColumn"},
MissingField.UseNull
)
Tuloste
Table.FromRecords({[CustomerID = 1, NewColumn = null]})