Tabellenfunktionen

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.