Table.FromRecords

Syntax

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

Info

Konvertiert eine angegebene Liste von Datensätzen in eine Tabelle.

• records: Die Liste der Datensätze, die in eine Tabelle konvertiert werden sollen.

• columns: (Optional) Eine Liste der Spaltennamen der Tabelle oder des Tabellentyps.

• missingField: (Optional) Gibt an, wie fehlende Felder in einer Zeile behandelt werden. Verwenden Sie einen der folgenden Werte:

  • MissingField.Error: Fehlende Felder erzeugen einen Fehler (Standard).
  • MissingField.UseNull: Fehlende Felder werden als null Werte eingeschlossen.

  Die Verwendung MissingField.Ignore in diesem Parameter erzeugt einen Fehler.

Beispiel 1

Erstellt eine Tabelle aus Datensätzen mithilfe von Datensatz-Feldnamen als Spaltennamen.

Verwendung

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

Ausgabe

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

Beispiel 2

Erstellt eine Tabelle aus Datensätzen mit typisierten Spalten und wählt die Zahlenspalten aus.

Verwendung

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

Ausgabe

{"CustomerID"}

Beispiel 3

Erstellen Sie eine Tabelle, die den Vornamen, den zweiten Anfangsbuchstaben und den Nachnamen der Kunden aus den spezifizierten Datensätzen enthält. Wenn einer der Werte fehlt, ersetzen Sie den Wert durch null.

Verwendung

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)

Ausgabe

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

Zugehöriger Inhalt

Fehlendes Feld