Freigeben über


Tabellenfunktionen

Diese Funktionen erstellen und bearbeiten Tabellenwerte.

Tabellenerstellung (Table construction)

Name Beschreibung
#table Erstellt einen Tabellenwert aus Spalten und Zeilen.
ItemExpression.From Gibt die abstrakte Syntaxstruktur (AST) für den Textkörper 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 (AST) zurück, die den Zugriff auf eine Spalte innerhalb eines Zeilenausdrucks darstellt.
RowExpression.From Gibt die abstrakte Syntaxstruktur (AST) für den Textkörper einer Funktion zurück.
RowExpression.Row Ein Knoten einer abstrakten Syntaxstruktur (Abstract Syntax Tree, AST), der die Zeile in einem Zeilenausdruck darstellt.
Table.FromColumns Erstellt eine Tabelle aus einer Liste von Spalten und angegebenen Werten.
Table.FromList Konvertiert eine Liste in eine Tabelle, indem die angegebene Aufspaltungsfunktion auf jedes Element in der Liste angewendet wird.
Table.FromRecords Konvertiert eine Liste von Datensätzen in eine Tabelle.
Table.FromRows Erstellt eine Tabelle aus einer Liste von Zeilenwerten und optionalen Spalten.
Table.FromValue Erstellt eine Tabelle mit einer Spalte aus dem angegebenen Wert oder werten.
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 geänderten Fehlerdatensatz, der keinen Fallback auslöst, wenn er von einem in einer Ansicht definierten Handler (über Table.View) ausgelöst wird.
Table.ViewFunction Erstellt eine Funktion, die von einem in einer Ansicht definierten Handler abgefangen werden kann (über Table.View).

Umwandlungen

Name Beschreibung
Table.ToColumns Erstellt eine Liste geschachtelter Listen mit Spaltenwerten aus einer Tabelle.
Table.ToList Konvertiert eine Tabelle in eine Liste, indem die angegebene Kombinationsfunktion auf jede Zeile mit Werten in der Tabelle angewendet wird.
Table.ToRecords Konvertiert eine Tabelle in eine Liste von Datensätzen.
Table.ToRows Erstellt eine Liste geschachtelter Listen mit Zeilenwerten aus einer Tabelle.

Informationen

Name Beschreibung
Table.ApproximateRowCount Gibt die ungefähre Anzahl von Zeilen in der Tabelle zurück.
Table.ColumnCount Gibt die Anzahl der Spalten in der Tabelle zurück.
Table.IsEmpty Gibt an, ob die Tabelle Zeilen enthält.
Table.PartitionValues Gibt Informationen zur Partitionierung einer Tabelle zurück.
Table.Profile Gibt ein Profil der Spalten einer Tabelle zurück.
Table.RowCount Gibt die Anzahl der Zeilen in der Tabelle zurück.
Table.Schema Gibt eine Tabelle zurück, die eine Beschreibung der Spalten (d. h. das Schema) der angegebenen Tabelle enthält.
Tables.GetRelationships Ruft die Beziehungen zwischen einem Satz von Tabellen ab.

Zeilenvorgänge (Row operations)

Name Beschreibung
Table.AlternateRows Behält den Ausgangsoffset bei und wechselt dann zwischen Verwendung und Überspringung der anschließenden Zeilen.
Table.Combine Gibt eine Tabelle zurück, die das Ergebnis des Zusammenführens einer Liste von Tabellen ist.
Table.FindText Gibt alle Zeilen zurück, die den angegebenen Text in der Tabelle enthalten.
Table.First Gibt die erste Zeile oder einen angegebenen Standardwert zurück.
Table.FirstN Gibt die ersten count Zeilen 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 das Ergebnis der Kombination einer Gruppe von partitionierten Tabellen ist.
Table.InsertRows Fügt eine Liste von Zeilen an der angegebenen Position in die Tabelle ein.
Table.Last Gibt die letzte Zeile oder einen angegebenen Standardwert zurück.
Table.LastN Gibt die letzte angegebene Anzahl von Zeilen zurück.
Table.MatchesAllRows Gibt an, ob alle Zeilen in der Tabelle die angegebene Bedingung erfüllen.
Table.MatchesAnyRows Gibt an, ob die Zeilen in der Tabelle die angegebene Bedingung erfüllen.
Table.Partition Partitioniert die Tabelle in eine Liste von Tabellen basierend auf der Anzahl der angegebenen Gruppen und Spalten.
Table.Range Gibt die Zeilen zurück, die am angegebenen Offset beginnen.
Table.RemoveFirstN Gibt eine Tabelle mit der angegebenen Anzahl von Zeilen zurück, die aus der Tabelle entfernt wurden, beginnend mit der ersten Zeile.
Table.RemoveLastN Gibt eine Tabelle mit der angegebenen Anzahl von Zeilen zurück, die von der Tabelle entfernt wurden, beginnend mit der letzten Zeile.
Table.RemoveRows Entfernt die angegebene Anzahl von Zeilen.
Table.RemoveRowsWithErrors Gibt eine Tabelle zurück, in der die Zeilen aus der Eingabetabelle entfernt wurden, die einen Fehler in mindestens einer der Zellen enthalten. Wenn eine Spaltenliste angegeben ist, werden nur die Zellen in den angegebenen Spalten auf Fehler überprüft.
Table.Repeat Wiederholt die Zeilen der Tabellen mit einer bestimmten Anzahl von Malen.
Table.ReplaceRows Ersetzt den angegebenen Zeilenbereich durch die angegebenen Zeilen.
Table.ReverseRows Gibt eine Tabelle mit den Zeilen in umgekehrter Reihenfolge zurück.
Table.SelectRows Markiert die Zeilen, die der Bedingungsfunktion entsprechen.
Table.SelectRowsWithErrors Gibt eine Tabelle mit nur den Zeilen der Eingabetabelle zurück, die einen Fehler in mindestens einer der Zellen enthalten. Wenn eine Spaltenliste angegeben ist, werden nur die Zellen in den angegebenen Spalten auf Fehler überprüft.
Table.SingleRow Gibt eine einzelne Zeile in der Tabelle zurück.
Table.Skip Gibt eine Tabelle mit der ersten angegebenen Anzahl übersprungener Zeilen zurück.
Table.SplitAt Gibt eine Liste zurück, die die ersten angegebenen Anzahlzeilen und die verbleibenden Zeilen enthält.

Spaltenvorgänge (Column operations)

Name Beschreibung
Table.Column Gibt eine angegebene Datenspalte aus der Tabelle als Liste zurück.
Table.ColumnNames Gibt die Spaltennamen als Liste zurück.
Table.ColumnsOfType Gibt eine Liste mit den Namen der Spalten zurück, die den angegebenen Typen entsprechen.
Table.DemoteHeaders Stuft die Spaltenüberschriften zur ersten Zeile mit Werten 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 Spalte oder Spalten enthält.
Table.Pivot Wandelt bei Angabe eines Spaltenpaars, das Attribut-Wert-Paare darstellt, die Daten in der Attributspalte in Spaltenüberschriften um.
Table.PrefixColumns Gibt eine Tabelle zurück, in der alle Spalten dem angegebenen Text vorangestellt wurden.
Table.PromoteHeaders Stuft die erste Zeile von Werten als neue Spaltenüberschriften (d. d. s. als Spaltennamen) höher.
Table.RemoveColumns Entfernt die angegebenen Spalten.
Table.ReorderColumns Gibt eine Tabelle mit den Spalten in der angegebenen Reihenfolge zurück.
Table.RenameColumns Gibt eine Tabelle zurück, in der die Spalten wie angegeben umbenannt wurden.
Table.SelectColumns Gibt eine Tabelle mit nur den angegebenen Spalten zurück.
Table.TransformColumnNames Transformiert Spaltennamen mithilfe der angegebenen Funktion.
Table.Unpivot Übersetzt eine Reihe von Spalten in einer Tabelle in Attributwertpaare.
Table.UnpivotOtherColumns Übersetzt alle anderen Spalten als eine angegebene Menge in Attributwertpaare.

Transformation

Name Beschreibung
Table.AddColumn Fügt eine Spalte mit dem angegebenen Namen hinzu. Der Wert wird mithilfe der angegebenen Auswahlfunktion berechnet, wobei jede Zeile als Eingabe verwendet wird.
Table.AddFuzzyClusterColumn Fügt eine neue Spalte mit repräsentativen Werten hinzu, die durch Fuzzy-Gruppierungswerte der angegebenen Spalte in der Tabelle abgerufen werden.
Table.AddIndexColumn Fügt eine Spalte mit expliziten Positionswerten an.
Table.AddJoinColumn Führt eine Verknüpfung zwischen Tabellen in angegebenen Spalten aus und erzeugt das Verknüpfungsergebnis in einer neuen Spalte.
Table.AddKey Fügt einer Tabelle einen Schlüssel hinzu.
Table.AggregateTableColumn Aggregiert eine Spalte mit Tabellen zu mehreren Spalten in der enthaltenden Tabelle.
Table.CombineColumns Kombiniert die angegebenen Spalten in einer neuen Spalte mithilfe der angegebenen Kombinationsfunktion.
Table.CombineColumnsToRecord Kombiniert die angegebenen Spalten in einer neuen Datensatzspalte, 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 Erstellen Sie bei einer Spalte mit Listen in einer Tabelle eine Kopie einer Zeile für jeden Wert in der Liste.
Table.ExpandRecordColumn Erweitert eine Spalte mit Datensätzen in Spalten mit jedem der Werte.
Table.ExpandTableColumn Erweitert eine Spalte mit Datensätzen oder eine Spalte mit Tabellen in mehrere Spalten in der enthaltenden Tabelle.
Table.FillDown Gibt den Wert einer vorherigen Zelle an die zellen mit Nullwerten weiter unten in der Spalte weiter.
Table.FillUp Gibt den Wert einer Zelle an die darüber liegenden Zellen mit NULL-Wert in der Spalte weiter.
Table.FilterWithDataTable Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.FuzzyGroup Gruppiert Zeilen in der Tabelle basierend auf dem Fuzzy-Abgleich von Schlüsseln.
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 eine Fuzzy-Verknüpfung zwischen Tabellen in angegebenen Spalten aus und erzeugt das Verknüpfungsergebnis in einer neuen Spalte.
Table.Group Gruppiert Zeilen in der Tabelle mit demselben Schlüssel.
Table.Join Verknüpft die Zeilen aus den beiden Tabellen, die basierend auf den angegebenen Schlüsseln übereinstimmen.
Table.Keys Gibt die Schlüssel der angegebenen Tabelle zurück.
Table.NestedJoin Führt eine Verknüpfung zwischen Tabellen in angegebenen Spalten aus und erzeugt das Verknüpfungsergebnis in einer neuen Spalte.
Table.ReplaceErrorValues Ersetzt die Fehlerwerte in den angegebenen Spalten durch den entsprechenden angegebenen Wert.
Table.ReplaceKeys Ersetzt die Schlüssel der angegebenen Tabelle.
Table.ReplaceRelationshipIdentity Diese Funktion ist nur für die interne Verwendung vorgesehen.
Table.ReplaceValue Ersetzt einen Wert durch einen anderen in den angegebenen Spalten.
Table.Split Teilt die angegebene Tabelle mithilfe der angegebenen Seitengröße in eine Liste von Tabellen auf.
Table.SplitColumn Teilt die angegebenen Spalten mithilfe der angegebenen Splitterfunktion in eine Reihe zusätzlicher Spalten auf.
Table.TransformColumns Transformiert die Werte einer oder mehrerer Spalten.
Table.TransformColumnTypes Wendet Die Typtransformation(en) des Formulars {Spalte, Typ } mithilfe einer bestimmten Kultur an.
Table.TransformRows Transformiert die Zeilen der Tabelle mithilfe der angegebenen Transformationsfunktion.
Table.Transpose Wandelt Spalten in Zeilen und Zeilen in Spalten um.

Mitgliedschaft

Name Beschreibung
Table.Contains Gibt an, ob der angegebene Datensatz als Zeile in der Tabelle angezeigt wird.
Table.ContainsAll Gibt an, ob alle angegebenen Datensätze als Zeilen in der Tabelle angezeigt werden.
Table.ContainsAny Gibt an, ob eine der angegebenen Datensätze als Zeilen in der Tabelle angezeigt wird.
Table.Distinct Entfernt doppelte Zeilen aus der Tabelle.
Table.IsDistinct Gibt an, ob die Tabelle nur unterschiedliche Zeilen enthält (keine Duplikate).
Table.PositionOf Gibt die Position oder Positionen der Zeile innerhalb der Tabelle zurück.
Table.PositionOfAny Gibt die Position oder Positionen einer oder mehrerer der angegebenen Zeilen innerhalb der Tabelle zurück.
Table.RemoveMatchingRows Entfernt alle Vorkommen der angegebenen Zeilen aus der Tabelle.
Table.ReplaceMatchingRows Ersetzt alle angegebenen Zeilen durch die angegebene Zeile oder Zeilen.

Bestellung

Name Beschreibung
Table.AddRankColumn Fügt eine Spalte mit der Rangfolge einer oder mehrerer anderer Spalten an.
Table.Max Gibt die größte Zeile oder den Standardwert mithilfe der angegebenen Kriterien zurück.
Table.MaxN Gibt die größte Zeile oder die größten Zeilen basierend auf den angegebenen Kriterien zurück.
Table.Min Gibt die kleinste Zeile oder einen Standardwert mit den angegebenen Kriterien zurück.
Table.MinN Gibt die kleinste Zeile oder Zeilen mit den angegebenen Kriterien zurück.
Table.Sort Sortiert die Tabelle mithilfe eines oder mehrerer Spaltennamen und Vergleichskriterien.

Andere

Name Beschreibung
Table.Buffer Puffert eine Tabelle im Arbeitsspeicher und isoliert sie während der Auswertung von externen Änderungen.
Table.StopFolding Verhindert, dass Downstreamvorgänge für die ursprüngliche Quelle der Daten ausgeführt werden.

Parameterwerte

Benennung von Ausgabespalten

Dieser Parameter ist eine Liste von Textwerten, die die Spaltennamen der resultierenden Tabelle angeben. Dieser Parameter wird in der Regel in den Tabellenkonstruktionsfunktionenverwendet, z. B. Table.FromRows und Table.FromList.

Vergleichskriterien

Das Vergleichskriterium kann als eines der folgenden Werte angegeben werden:

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

  • Zum Berechnen eines Schlüssels, der für die Sortierung verwendet werden soll, kann eine Funktion eines Arguments verwendet werden.

  • Um sowohl einen Schlüssel als auch eine Kontrollreihenfolge auszuwählen, kann ein Vergleichskriterium eine Liste sein, die den Schlüssel und die Reihenfolge enthält.

  • Um den Vergleich vollständig zu steuern, kann eine Funktion von zwei Argumenten verwendet werden, die -1, 0 oder 1 zurückgibt, wenn die Beziehung zwischen der linken und rechten Eingabe angegeben ist. Value.Compare kann verwendet werden, um diese Logik zu delegieren.

Beispiele: Gehen Sie zur Beschreibung von Table.Sort.

Zählungs- oder Bedingungskriterien

Diese Kriterien werden in der Regel in Sortier- oder Zeilenvorgängen verwendet. Sie bestimmt die Anzahl der zeilen, die in der Tabelle zurückgegeben werden, und kann zwei Formen annehmen, eine Zahl oder eine Bedingung.

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

  • Wenn eine Bedingung angegeben wird, werden die Zeilen zurückgegeben, die Werte enthalten, die die Bedingung anfänglich erfüllen. Sobald ein Wert die Bedingung nicht erfüllt, werden keine weiteren Werte berücksichtigt.

Weitere Informationen: Table.FirstN, Table.MaxN

Umgang mit zusätzlichen Werten

Zusätzliche Werte werden verwendet, um anzugeben, wie die Funktion zusätzliche Werte in einer Zeile verarbeiten soll. Dieser Parameter wird als Zahl angegeben, die 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 verwendet, um anzugeben, wie die Funktion fehlende Spalten behandeln soll. Dieser Parameter wird als Zahl angegeben, die den folgenden Optionen zugeordnet ist:

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

Dieser Parameter wird in Spalten- oder Transformationsvorgängen, zum Beispiel in Table.TransformColumns, verwendet. Weitere Informationen: MissingField.Type

Sortierreihenfolge

Die Sortierreihenfolge wird verwendet, um anzugeben, wie die Ergebnisse sortiert werden sollen. Dieser Parameter wird als Zahl angegeben, die den folgenden Optionen zugeordnet ist:

Order.Ascending = 0
Order.Descending = 1

Weitere Informationen: Order.Type

Gleichungskriterien

Formelkriterien für Tabellen können als eine der folgenden Kriterien angegeben werden:

  • Ein Funktionswert, der entweder lautet:

    • Eine Schlüsselauswahl, die die Spalte in der Tabelle bestimmt, um die Gleichheitskriterien anzuwenden.

    • Eine Vergleichsfunktion, die zum Angeben der anzuwendenden Vergleichsart verwendet wird. Integrierte Vergleichsfunktionen können angegeben werden. Weitere Informationen: Vergleichsfunktionen

  • Eine Liste der Spalten in der Tabelle, um die Gleichheitskriterien anzuwenden.

Beispiele: Gehen Sie zur Beschreibung von Table.Distinct.