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.