Tabellenfunktionen

  • Artikel

Diese Funktionen erstellen und ändern Tabellenwerte.

Tabellenerstellung (Table construction)

Name Beschreibung
ItemExpression.From Gibt die abstrakte Syntaxstruktur (Abstract Syntax Tree, AST) für den Text einer Funktion zurück.
ItemExpression.Item Ein Knoten einer abstrakten Syntaxstruktur (Abstract Syntax Tree, AST), welcher das Element in einem Elementausdruck darstellt.
RowExpression.Column Gibt eine abstrakte Syntaxstruktur (Abstract Syntax Tree, AST) zurück, welche den Zugriff auf eine Spalte innerhalb eines Zeilenausdrucks darstellt.
RowExpression.From Gibt die abstrakte Syntaxstruktur (Abstract Syntax Tree, AST) für den Text einer Funktion zurück.
RowExpression.Row Ein Knoten einer abstrakten Syntaxstruktur (Abstract Syntax Tree, AST), der die Zeile in einem Zeilenausdruck darstellt.
Table.FromColumns Gibt eine Tabelle aus einer Liste zurück, die die Spaltennamen und -Werte enthält.
Table.FromList Konvertiert eine Liste in eine Tabelle, indem die angegebene Teilungsfunktion auf alle Elemente in der Liste angewendet wird.
Table.FromRecords Gibt eine Tabelle aus einer Liste mit Datensätzen zurück.
Table.FromRows Erstellt eine Tabelle auf der Grundlage der Liste, in der die einzelnen Elemente der Liste eine interne Liste mit den Spaltenwerten für eine einzelne Zeile bilden.
Table.FromValue Gibt eine Tabelle mit einer Spalte zurück, die den angegebenen Wert oder die angegebene Werteliste enthält.
Table.FuzzyGroup Gruppiert die Zeilen von „fuzzily“ zeilenweise nach den Werten in der angegebenen Spalte.
Table.FuzzyJoin Verknüpft die Zeilen aus den beiden Tabellen, die auf der Grundlage der angegebenen Schlüssel ungefähr übereinstimmen.
Table.FuzzyNestedJoin Führt für angegebene Spalten einen Fuzzyjoin zwischen Tabellen aus, und stellt das Join-Ergebnis in einer neuen Spalte bereit.
Table.Split Unterteilt die angegebene Tabelle anhand der angegebenen Seitengröße in eine Liste von Tabellen.
Table.WithErrorContext Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.View Erstellt oder erweitert eine Tabelle mit benutzerdefinierten Handlern für Abfrage- und Aktionsvorgänge.
Table.ViewError Erstellt einen modifizierten Fehlerdatensatz, der keinen Fallback auslöst, wenn er von einem Handler ausgelöst wird, der in einer Ansicht (über Table.View) definiert wurde
Table.ViewFunction Erstellt eine Funktion, die von einem Handler abgefangen werden kann, der in einer Ansicht (über Table.View) definiert wurde.

Konvertierungen

Name Beschreibung
Table.ToColumns Gibt eine Liste mit geschachtelten Listen zurück, von denen jede eine Spalte mit Werten in der Eingabetabelle darstellt.
Table.ToList Gibt eine Tabelle in eine Liste zurück, indem die angegebene Kombinationsfunktion auf die einzelnen Zeilen mit Werten in einer Tabelle angewendet wird.
Table.ToRecords Gibt eine Liste mit Datensätzen aus einer Eingabetabelle zurück.
Table.ToRows Gibt eine geschachtelte Liste mit Zeilenwerten aus einer Eingabetabelle zurück.

Information

Name BESCHREIBUNG
Table.ApproximateRowCount Gibt die ungefähre Anzahl von Zeilen in der Tabelle zurück.
Table.ColumnCount Gibt die Anzahl der Spalten in einer Tabelle zurück.
Table.IsEmpty Gibt TRUE zurück, wenn die Tabelle keine Zeilen enthält.
Table.Profile Gibt ein Profil der Spalten einer Tabelle zurück.
Table.RowCount Gibt die Anzahl der Zeilen in einer Tabelle zurück.
Table.Schema Gibt eine Tabelle mit Beschreibungen der Spalten (d. h. das Schema) der angegebenen Tabelle zurück.
Tables.GetRelationships Gibt die Beziehungen zwischen mehreren Tabellen zurück.

Zeilenvorgänge (Row operations)

Name Beschreibung
Table.AlternateRows Gibt eine Tabelle mit einem wechselnden Muster von Zeilen aus einer Tabelle zurück.
Table.Combine Gibt eine Tabelle zurück, die durch Zusammenführen einer Liste von Tabellen entstanden ist. Dabei müssen alle Tabellen die gleiche Zeilentypstruktur aufweisen.
Table.FindText Gibt eine Tabelle zurück, die nur die Zeilen enthält, die den angegebenen Text innerhalb einer ihrer Zellen oder eines beliebigen Teils davon enthalten.
Table.First Gibt die erste Zeile aus einer Tabelle zurück.
Table.FirstN Gibt die ersten Zeilen einer Tabelle abhängig vom Parameter „countOrCondition“ zurück.
Table.FirstValue Gibt die erste Spalte der ersten Zeile der Tabelle oder einen angegebenen Standardwert zurück.
Table.FromPartitions Gibt eine Tabelle zurück, die durch Kombinieren einer Gruppe partitionierter Tabellen mit neuen Spalten entstanden ist. Der Typ der Spalte kann optional angegeben werden, der Standardwert lautet „any“.
Table.InsertRows Gibt eine Tabelle mit der Liste der in die Tabelle bei einem Index eingefügten Zeilen zurück. Jede einzufügende Zeile muss mit dem Zeilentyp der Tabelle übereinstimmen.
Table.Last Gibt die letzte Zeile einer Tabelle zurück.
Table.LastN Gibt die letzten Zeilen aus einer Tabelle abhängig vom Parameter „countOrCondition“ zurück.
Table.MatchesAllRows Gibt TRUE zurück, wenn alle Zeilen in einer Tabelle eine Bedingung erfüllen.
Table.MatchesAnyRows Gibt TRUE zurück, wenn mindestens eine Zeile in einer Tabelle eine Bedingung erfüllt.
Table.Partition Unterteilt die Tabelle in eine Liste mit Gruppennummern von Tabellen basierend auf dem Wert der Spalte der einzelnen Zeilen und einer Hashfunktion. Die Hashfunktion wird auf den Wert der Spalte einer Zeile angewendet, um einen Hashwert für die Zeile abzurufen. Der Hashwert „modulo groups“ bestimmt, in welche der zurückgegebenen Tabellen die Zeile eingefügt wird.
Table.PartitionValues Gibt Informationen zur Partitionierung einer Tabelle zurück.
Table.Range Gibt beginnend bei einem Offset die angegebene Anzahl Zeilen aus einer Tabelle zurück.
Table.RemoveFirstN Gibt eine Tabelle zurück, bei der die angegebene Anzahl von Zeilen beginnend mit der ersten Zeile aus der Tabelle entfernt wurde. Die Anzahl der entfernten Zeilen hängt vom optionalen Parameter „countOrCondition“ ab.
Table.RemoveLastN Gibt eine Tabelle zurück, bei der die angegebene Anzahl von Zeilen beginnend mit der letzten Zeile aus der Tabelle entfernt wurde. Die Anzahl der entfernten Zeilen hängt vom optionalen Parameter „countOrCondition“ ab.
Table.RemoveRows Gibt eine Tabelle zurück, bei der die angegebene Anzahl von Zeilen beginnend bei einem Offset aus der Tabelle entfernt wurde.
Table.RemoveRowsWithErrors Gibt eine Tabelle zurück, in der alle Zeilen aus der Tabelle entfernt wurden, die in mindestens einer Zelle in einer Zeile einen Fehler enthalten.
Table.Repeat Gibt eine Tabelle mit den Zeilen der Tabelle zurück, die die angegebene Anzahl von Malen wiederholt wurden.
Table.ReplaceRows Gibt eine Tabelle zurück, in der die Zeilen, die bei einem Offset beginnen und für eine bestimmte Anzahl von Malen fortgesetzt werden, durch die angegebenen Zeilen ersetzt werden.
Table.ReverseRows Gibt eine Tabelle zurück, deren Zeilen in umgekehrter Reihenfolge sortiert wurden.
Table.SelectRows Gibt eine Tabelle zurück, die nur die Zeilen enthält, die eine Bedingung erfüllen.
Table.SelectRowsWithErrors Gibt eine Tabelle zurück, die nur die Zeilen aus der Tabelle enthält, die in mindestens einer Zelle in einer Zeile einen Fehler enthalten.
Table.SingleRow Gibt eine einzelne Zeile aus einer Tabelle zurück.
Table.Skip Gibt eine Tabelle zurück, die nicht die ersten Zeilen der Tabelle enthält.
Table.SplitAt Gibt eine Liste zurück, die die ersten angegebenen Zählzeilen und die verbleibenden Zeilen enthält.

Spaltenvorgänge (Column operations)

Name Beschreibung
Table.Column Gibt die Werte aus einer Spalte in einer Tabelle zurück.
Table.ColumnNames Gibt die Namen von Spalten aus einer Tabelle zurück.
Table.ColumnsOfType Gibt eine Liste mit den Namen der Spalten zurück, die mit dem angegebenen Typ übereinstimmen.
Table.DemoteHeaders Stuft die Kopfzeile zur ersten Zeile einer Tabelle herab.
Table.DuplicateColumn Dupliziert eine Spalte mit dem angegebenen Namen. Die Werte und der Typ werden aus der Quellspalte kopiert.
Table.HasColumns Gibt an, ob die Tabelle die angegebene(n) Spalte(n) enthält.
Table.Pivot Erstellt bei einer Tabellen- und Attributspalte mit „pivotValues“ für jeden Pivotwert neue Spalten und weist diesen Werte aus „valueColumn“ zu. Zur Verarbeitung mehrerer Vorkommen eines Schlüsselwerts in der Attributspalte kann optional „aggregationFunction“ angegeben werden.
Table.PrefixColumns Gibt eine Tabelle zurück, in der allen Spalten ein Textwert als Präfix vorangestellt wurde.
Table.PromoteHeaders Stuft die erste Zeile der Tabelle zur Kopfzeile oder zum Spaltennamen herauf.
Table.RemoveColumns Gibt eine Tabelle ohne angegebene Spalten zurück.
Table.ReorderColumns Gibt eine Tabelle mit angegebenen Spalten in einer Reihenfolge relativ zueinander zurück.
Table.RenameColumns Gibt eine Tabelle zurück, in der die Spalten wie angegeben umbenannt wurden.
Table.SelectColumns Gibt eine Tabelle zurück, die nur angegebene Spalten enthält.
Table.TransformColumnNames Transformiert Spaltennamen unter Verwendung der angegebenen Funktion.
Table.Unpivot Transformiert die Spalten einer Liste mit Tabellenspalten in Attribut-Wert-Paare.
Table.UnpivotOtherColumns Übersetzt alle Spalten mit Ausnahme eines angegebenen Satzes in Attribut-Wert-Paare in Kombination mit den restlichen Werten in jeder Zeile.

Transformation

Name Beschreibung
Table.AddColumn Fügt einer Tabelle eine Spalte mit dem Namen „newColumnName“ hinzu.
Table.AddFuzzyClusterColumn Hiermit wird eine neue Spalte mit repräsentativen Werten hinzugefügt, die durch Fuzzygruppierungswerte der angegebenen Spalte in der Tabelle abgerufen wurden.
Table.AddIndexColumn Gibt eine Tabelle mit einer neuen Spalte mit einem bestimmten Namen zurück, die für jede Zeile einen Index der Zeile in der Tabelle enthält.
Table.AddJoinColumn Führt einen geschachtelten Join zwischen „table1“ und „table2“ aus bestimmten Spalten aus, und erzeugt das Joinergebnis für alle Zeilen von „table1“ als „newColumnName“-Spalte.
Table.AddKey Fügt einen Schlüssel zur Tabelle hinzu.
Table.AggregateTableColumn Aggregiert in einer bestimmten Spalte geschachtelte Tabellen in mehrere Spalten, die Aggregatwerte für diese Tabellen enthalten.
Table.CombineColumns „Table.CombineColumns“ führt Spalten mithilfe einer Kombinationsfunktion zu einer neuen Spalte zusammen. „Table.CombineColumns“ ist die Umkehrung von „Table.SplitColumns“.
Table.CombineColumnsToRecord Kombiniert die angegebenen Spalten in einer neuen Spalte mit Datensatzwerten, in der jeder Datensatz Feldnamen und Werte enthält, die den Spaltennamen und Werten der kombinierten Spalten entsprechen.
Table.ConformToPageReader Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.ExpandListColumn Erstellt auf der Grundlage einer Spalte mit Listen in einer Tabelle je eine Zeilenkopie für die einzelnen Werte in der Liste.
Table.ExpandRecordColumn Erweitert eine Spalte mit Datensätzen in Spalten mit den einzelnen Werten.
Table.ExpandTableColumn Erweitert eine Spalte mit Datensätzen oder eine Spalte mit Tabellen zu mehreren Spalten in der enthaltenden Tabelle.
Table.FillDown Ersetzt NULL-Werte in den angegebenen Spalten der Tabelle durch den zuletzt verwendeten Wert ungleich NULL in der Spalte.
Table.FillUp Gibt eine Tabelle aus der angegebenen Tabelle zurück, wobei der Wert der nächsten Zelle an die darüber liegenden Zellen mit NULL-Werten in der angegebenen Spalte weitergegeben wird.
Table.FilterWithDataTable Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.Group Gruppiert Tabellenzeilen nach den Werten der Schlüsselspalten für jede Zeile.
Table.Join Verknüpft die Zeilen von „table1“ mit den Zeilen von „table2“. Grundlage hierfür bildet die Übereinstimmung der Werte der Schlüsselspalten, die durch „table1“, „key1“ und „table2“, „key2“ ausgewählt wurden.
Table.Keys Gibt die Schlüssel der angegebenen Tabelle zurück.
Table.NestedJoin Verknüpft die Zeilen der Tabellen. Grundlage hierfür bildet die Übereinstimmung der Schlüssel. Die Ergebnisse werden in eine neue Spalte eingegeben.
Table.ReplaceErrorValues Ersetzt die Fehlerwerte in den angegebenen Spalten durch den entsprechenden angegebenen Wert.
Table.ReplaceKeys Ersetzt die Schlüssel der benannten Tabelle.
Table.ReplaceRelationshipIdentity Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.ReplaceValue Ersetzt „oldValue“ in bestimmten Spalten einer Tabelle durch „newValue“, und verwendet dabei die bereitgestellte Ersetzungsfunktion, z. B. „text.Replace“ oder „Value.Replace“.
Table.SplitColumn Gibt neue Spalten aus einer einzelnen Spalte zurück. Dabei wird auf alle Werte eine Teilungsfunktion angewendet.
Table.TransformColumns Transformiert die Werte einer oder mehrerer Spalten
Table.TransformColumnTypes Transformiert die Spaltentypen aus einer Tabelle mithilfe eines Typs.
Table.TransformRows Transformiert die Zeilen aus einer Tabelle mithilfe einer Transformationsfunktion.
Table.Transpose Gibt aus der Eingabetabelle eine Tabelle zurück, in der die Spalten in Zeilen und die Zeilen in Spalten konvertiert wurden.

Membership

Name BESCHREIBUNG
Table.Contains Bestimmt, ob ein Datensatz als Zeile in der Tabelle vorkommt.
Table.ContainsAll Bestimmt, ob alle angegebenen Datensätze als Zeilen in der Tabelle vorkommen.
Table.ContainsAny Bestimmt, ob mindestens einer der angegebenen Datensätze als Zeile in der Tabelle vorkommt.
Table.Distinct Entfernt doppelte Zeilen aus einer Tabelle, womit sichergestellt wird, dass alle verbleibenden Zeilen unterschiedlich sind.
Table.IsDistinct Bestimmt, ob eine Tabelle nur unterschiedliche Zeilen enthält.
Table.PositionOf Bestimmt die Position einer Zeile in einer Tabelle.
Table.PositionOfAny Bestimmt die Position von angegebenen Zeilen in der Tabelle.
Table.RemoveMatchingRows Entfernt alle Vorkommen von Zeilen aus einer Tabelle.
Table.ReplaceMatchingRows Ersetzt bestimmte Zeilen aus einer Tabelle durch die neuen Zeilen.

Sortieren

Name BESCHREIBUNG
Table.Max Gibt die größten Zeilen aus einer Tabelle mithilfe von „comparisonCriteria“ zurück.
Table.MaxN Gibt die größten N Zeilen aus einer Tabelle zurück. Nachdem die Zeilen sortiert wurden, muss der Parameter „countOrCondition“ angegeben werden, um das Ergebnis weiter zu filtern.
Table.Min Gibt die kleinsten Zeilen aus einer Tabelle mithilfe von „comparisonCriteria“ zurück.
Table.MinN Gibt die kleinsten N Zeilen in der angegebenen Tabelle zurück. Nachdem die Zeilen sortiert wurden, muss der Parameter „countOrCondition“ angegeben werden, um das Ergebnis weiter zu filtern.
Table.AddRankColumn Fügt eine Spalte mit der Rangfolge einer oder mehrerer anderer Spalten hinzu.
Table.Sort Sortiert die Zeilen in einer Tabelle mithilfe von „comparisonCriteria“ oder anhand einer Standardreihenfolge, wenn kein Wert angegeben ist.

Andere

Name BESCHREIBUNG
Table.Buffer Puffert eine Tabelle im Arbeitsspeicher, und schützt sie so während der Auswertung vor externen Änderungen.

Parameterwerte

Benennung von Ausgabespalten

Bei diesem Parameter handelt es sich um eine Liste mit Textwerten, die die Spaltennamen der resultierenden Tabelle angeben. Dieser Parameter wird in der Regel in den Funktionen für die Tabellenerstellung verwendet, z. B. in Table.FromRows und Table.FromList.

Vergleichskriterien

Als Vergleichskriterium kann einer der folgenden Werte angegeben werden:

  • Ein Zahlenwert, der eine Sortierreihenfolge angibt. Weitere Informationen: Sortierreihenfolge

  • Zum Berechnen eines Schlüssels für die Sortierung kann eine Funktion aus einem einzigen Argument verwendet werden.

  • Um sowohl einen Schlüssel auszuwählen als auch die Reihenfolge zu steuern, kann das Vergleichskriterium als Liste mit Schlüssel und Reihenfolge angegeben werden.

  • Zur vollständigen Steuerung des Vergleichs kann eine Funktion mit zwei Argumenten verwendet werden, die abhängig von der Beziehung zwischen der linken und rechten Eingabe -1, 0 oder 1 zurückgibt. Diese Logik kann mithilfe von Value.Compare delegiert werden.

Beispiele finden Sie in der Beschreibung von Table.Sort.

Zählungs- oder Bedingungskriterien

Diese Kriterien werden in der Regel bei Sortier- oder Zeilenvorgängen verwendet. Sie bestimmen die Anzahl der in der Tabelle zurückgegebenen Zeilen, und können zwei Formen annehmen, die einer Zahl oder die einer Bedingung.

  • Eine Zahl zeigt an, wie viele Werte Inline mit der entsprechenden Funktion zurückgegeben werden sollen.

  • Wenn eine Bedingung angegeben wird, werden die Zeilen mit Werten zurückgegeben, die die Bedingung zunächst erfüllen. Wenn ein Wert die Bedingung nicht erfüllt, werden keine weiteren Werte berücksichtigt.

Weitere Informationen: Table.FirstN, Table.MaxN

Verarbeitung zusätzlicher Werte

Zusätzliche Werte werden genutzt um anzugeben, wie die Funktion zusätzliche Werte in einer Zeile verarbeiten soll. Dieser Parameter wird als Zahl angegeben, welche den folgenden Optionen zugeordnet ist:

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

Weitere Informationen: Table.FromList, ExtraValues.Type

Umgang mit fehlenden Spalten

Dieser Parameter wird genutzt um anzuzeigen, wie die Funktion mit fehlenden Spalten umgehen soll. Dieser Parameter wird als Zahl angegeben, welche den folgenden Optionen zugeordnet ist:

MissingField.Error = 0 MissingField.Ignore = 1 MissingField.UseNull = 2;

Dieser Parameter wird in Spalten- oder Transformations-Vorgängen verwendet, z. B. in Table.TransformColumns. Weitere Informationen: MissingField.Type

Sortierreihenfolge

Mit Sortierreihenfolge wird angegeben, wie die Ergebnisse sortiert werden sollen. Dieser Parameter wird als Zahl angegeben, welche den folgenden Optionen zugeordnet ist:

Order.Ascending = 0 Order.Descending = 1

Weitere Informationen: Order.Type

Gleichungskriterien

Gleichungskriterien für Tabellen können angegeben werden als:

  • Ein Funktionswert, der entweder:

    • Einen Schlüsselselektor darstellt, der jene Spalte in der Tabelle bestimmt, auf welche die Gleichheitskriterien angewendet werden sollen.

    • Eine Vergleichsfunktion darstellt, mit der die Art des anzuwendenden Vergleichs angegeben wird. Es können integrierte Vergleichsfunktionen angegeben werden. Weitere Informationen: Vergleichsfunktionen

  • Eine Liste der Spalten in der Tabelle, auf welche die Gleichheitskriterien angewendet werden sollen.

Beispiele finden Sie in der Beschreibung von Table.Distinct.