Table.FromRecords

Синтаксис

Table.FromRecords(
    records as list,
    optional columns as any,
    optional missingField as nullable number
) as table

О нас

Преобразует указанный список записей в таблицу.

• records: список записей для преобразования в таблицу.
• columns: (Необязательно) Список имен столбцов таблицы или типа таблицы.
• missingField: (Необязательно) Указывает, как обрабатывать отсутствующие поля в строке. Используйте одно из следующих значений:
  • MissingField.Error: любые отсутствующие поля создают ошибку (по умолчанию).
  • MissingField.UseNull: все отсутствующие поля включаются в качестве null значений.

Использование MissingField.Ignore этого параметра приводит к ошибке.

Пример 1

Создайте таблицу из записей, используя имена полей записи в качестве имен столбцов.

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

Table.FromRecords({
    [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
    [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
    [CustomerID = 3, Name = "Paul", Phone = "543-7890"]
})

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

#table(type table[CustomerID = any, Name = any, Phone = any],
{
    {1, "Bob", "123-4567"},
    {2, "Jim", "987-6543"},
    {3, "Paul", "543-7890"}
})

Пример 2

Создайте таблицу из записей с типизированными столбцами и выберите числовой столбец.

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

Table.ColumnsOfType(
    Table.FromRecords(
        {[CustomerID = 1, Name = "Bob"]},
        type table[CustomerID = Number.Type, Name = Text.Type]
    ),
    {type number}
)

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

{"CustomerID"}

Пример 3

Создайте таблицу, содержащую имя, инициал отчества и фамилию клиентов из указанных записей. Если отсутствуют какие-либо из значений, замените значение nullна .

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

Table.FromRecords({
        [CustomerID = 1, FirstName = "Bob", MiddleInitial = "C", LastName = "Smith"],
        [CustomerID = 2, FirstName = "Sarah", LastName = "Jones"],
        [CustomerID = 3, FirstName = "Harry", MiddleInitial = "H"]
    },
    type table [FirstName = nullable text, MiddleInitial = nullable text, LastName = nullable text],
    MissingField.UseNull)

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

#table(type table[FirstName = text, MiddleInitial = text, LastName = text],
{
    {"Bob", "C", "Smith"},
    {"Sarah", null, "Jones"},
    {"Harry", "H", null}
})

Связанный контент

Отсутствует поле