Table.SelectColumns

Szintaxis

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

Névjegy

A(z) table-t csak a megadott columns-vel adja vissza.

• table: A megadott táblázat.
• columns: A visszaadni kívánt tábla table oszlopainak listája. A visszaadott tábla oszlopai a columns listában megadott sorrendben találhatók.
• missingField: (Nem kötelező) Mi a teendő, ha az oszlop nem létezik. Példa: MissingField.UseNull vagy MissingField.Ignore.

1. példa

Csak a [Név] oszlopot tartalmazza.

Használat

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

Kimenet

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

2. példa

Csak a [CustomerID] és a [Name] oszlopokat tartalmazza.

Használat

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

Kimenet

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

3. példa

Ha a belefoglalt oszlop nem létezik, az alapértelmezett eredmény egy hiba.

Használat

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

Kimenet

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

4. példa

Ha a belefoglalt oszlop nem létezik, a beállítás MissingField.UseNull null értékű oszlopot hoz létre.

Használat

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

Kimenet

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