Jaa


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 taulukosta table . Palautetun taulukon sarakkeet ovat kohteen columnsluettelossa olevassa järjestyksessä.
  • missingField: (Valinnainen) Mitä tehdä, jos saraketta ei ole olemassa. Esimerkki: MissingField.UseNull tai MissingField.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]})