Table.SelectColumns

Синтаксис

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

О нас

Возвращает table только с указанным columns.

• table: предоставленная таблица.
• columns: список столбцов из таблицы table для возврата. Столбцы в возвращаемой таблице находятся в порядке, указанном в columns.
• missingField: (Необязательно) Что делать, если столбец не существует. Пример: MissingField.UseNull или MissingField.Ignore.

Пример 1

Включайте только столбец [Имя].

Использование

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

Выходные данные

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

Пример 2

Включают только столбцы [CustomerID] и [Name].

Использование

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

Выходные данные

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

Пример 3

Если включенный столбец не существует, по умолчанию будет возвращена ошибка.

Использование

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

Выходные данные

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

Пример 4

Если включенный столбец не существует, при указании параметра MissingField.UseNull будет создан столбец со значениями NULL.

Использование

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

Выходные данные

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