Udostępnij za pośrednictwem

Funkcje tabeli

  • Artykuł

Te funkcje tworzą wartości tabeli i manipulują nimi.

Konstrukcja tabeli

Nazwa Opis
#table Tworzy wartość tabeli na podstawie kolumn i wierszy.
ItemExpression.From Zwraca drzewo składni abstrakcyjnej (AST) dla treści funkcji.
ItemExpression.Item Węzeł drzewa składni abstrakcyjnej (AST) reprezentujący element w wyrażeniu elementu.
RowExpression.Column Zwraca abstrakcyjne drzewo składni (AST), które reprezentuje dostęp do kolumny w wyrażeniu wiersza.
RowExpression.From Zwraca drzewo składni abstrakcyjnej (AST) dla treści funkcji.
RowExpression.Row Węzeł drzewa składni abstrakcyjnej (AST) reprezentujący wiersz w wyrażeniu wiersza.
Table.FromColumns Tworzy tabelę na podstawie listy kolumn i określonych wartości.
Table.FromList Konwertuje listę na tabelę, stosując określoną funkcję podziału do każdego elementu na liście.
Table.FromRecords Konwertuje listę rekordów na tabelę.
Table.FromRows Tworzy tabelę na podstawie listy wartości wierszy i opcjonalnych kolumn.
Table.FromValue Tworzy tabelę z kolumną na podstawie podanej wartości lub wartości.
Table.WithErrorContext Ta funkcja jest przeznaczona tylko do użytku wewnętrznego.
Table.View Tworzy lub rozszerza tabelę za pomocą procedur obsługi zdefiniowanych przez użytkownika na potrzeby operacji zapytań i akcji.
Table.ViewError Tworzy zmodyfikowany rekord błędu, który nie wyzwoli rezerwowego podczas zgłaszania przez program obsługi zdefiniowany w widoku (za pośrednictwem Table.View).
Table.ViewFunction Tworzy funkcję, która może zostać przechwycona przez program obsługi zdefiniowany w widoku (za pośrednictwem Table.View).

Konwersje

Nazwa Opis
Table.ToColumns Tworzy listę zagnieżdżonych list wartości kolumn z tabeli.
Table.ToList Konwertuje tabelę na listę, stosując określoną funkcję łączącą do każdego wiersza wartości w tabeli.
Table.ToRecords Konwertuje tabelę na listę rekordów.
Table.ToRows Tworzy listę zagnieżdżonych list wartości wierszy z tabeli.

Informacja

Nazwa Opis
Table.ApproximateRowCount Zwraca przybliżoną liczbę wierszy w tabeli.
Table.ColumnCount Zwraca liczbę kolumn w tabeli.
Table.IsEmpty Wskazuje, czy tabela zawiera jakiekolwiek wiersze.
Table.PartitionValues Zwraca informacje o sposobie partycjonowania tabeli.
Table.Profile Zwraca profil kolumn tabeli.
Table.RowCount Zwraca liczbę wierszy w tabeli.
Table.Schema Zwraca tabelę zawierającą opis kolumn (czyli schemat) określonej tabeli.
Tables.GetRelationships Pobiera relacje między zestawem tabel.

Operacje na wierszach

Nazwa Opis
Table.AlternateRows Zachowuje początkowe przesunięcie, a następnie naprzemiennie pobiera i pomija kolejne wiersze.
Table.Combine Zwraca tabelę, która jest wynikiem scalania listy tabel.
Table.FindText Zwraca wszystkie wiersze zawierające dany tekst w tabeli.
Table.First Zwraca pierwszy wiersz lub określoną wartość domyślną.
Table.FirstN Zwraca liczbę pierwszych określonych wierszy.
Table.FirstValue Zwraca pierwszą kolumnę pierwszego wiersza tabeli lub określoną wartość domyślną.
Table.FromPartitions Zwraca tabelę, która jest wynikiem połączenia zestawu tabel partycjonowanych.
Table.InsertRows Wstawia listę wierszy do tabeli w określonej pozycji.
Table.Last Zwraca ostatni wiersz lub określoną wartość domyślną.
Table.LastN Zwraca ostatnią określoną liczbę wierszy.
Table.MatchesAllRows Wskazuje, czy wszystkie wiersze w tabeli spełniają dany warunek.
Table.MatchesAnyRows Wskazuje, czy jakiekolwiek wiersze w tabeli spełniają dany warunek.
Table.Partition Dzieli tabelę na listę tabel na podstawie liczby określonych grup i kolumn.
Table.Range Zwraca wiersze zaczynające się od określonego przesunięcia.
Table.RemoveFirstN Zwraca tabelę z określoną liczbą wierszy usuniętych z tabeli, zaczynając od pierwszego wiersza.
Table.RemoveLastN Zwraca tabelę z określoną liczbą wierszy usuniętych z tabeli, zaczynając od ostatniego wiersza.
Table.RemoveRows Usuwa określoną liczbę wierszy.
Table.RemoveRowsWithErrors Zwraca tabelę z wierszami usuniętymi z tabeli wejściowej, która zawiera błąd w co najmniej jednej komórce. Jeśli zostanie określona lista kolumn, tylko komórki w określonych kolumnach są sprawdzane pod kątem błędów.
Table.Repeat Powtarza wiersze tabel określoną liczbę razy.
Table.ReplaceRows Zamienia określony zakres wierszy na podany wiersz lub wiersze.
Table.ReverseRows Zwraca tabelę z wierszami w odwrotnej kolejności.
Table.SelectRows Wybiera wiersze spełniające funkcję warunku.
Table.SelectRowsWithErrors Zwraca tabelę zawierającą tylko te wiersze tabeli wejściowej, które zawierają błąd w co najmniej jednej komórce. Jeśli zostanie określona lista kolumn, tylko komórki w określonych kolumnach są sprawdzane pod kątem błędów.
Table.SingleRow Zwraca pojedynczy wiersz w tabeli.
Table.Skip Zwraca tabelę z pierwszą określoną liczbą pominiętych wierszy.
Table.SplitAt Zwraca listę zawierającą określone pierwsze wiersze zliczania i pozostałe wiersze.

Operacje na kolumnach

Nazwa Opis
Table.Column Zwraca określoną kolumnę danych z tabeli jako listę.
Table.ColumnNames Zwraca nazwy kolumn jako listę.
Table.ColumnsOfType Zwraca listę z nazwami kolumn, które są zgodne z określonymi typami.
Table.DemoteHeaders Obniża nagłówki kolumn do pierwszego wiersza wartości.
Table.DuplicateColumn Duplikuje kolumnę o określonej nazwie. Wartości i typ są kopiowane z kolumny źródłowej.
Table.HasColumns Wskazuje, czy tabela zawiera określoną kolumnę lub kolumny.
Table.Pivot Biorąc pod uwagę parę kolumn reprezentujących pary atrybutów i wartości, przekształca dane w kolumnie atrybutu w nagłówki kolumn.
Table.PrefixColumns Zwraca tabelę, w której wszystkie kolumny zostały poprzedzone danym tekstem.
Table.PromoteHeaders Promuje pierwszy wiersz wartości jako nowe nagłówki kolumn (czyli jako nazwy kolumn).
Table.RemoveColumns Usuwa określone kolumny.
Table.ReorderColumns Zwraca tabelę z kolumnami w określonej kolejności.
Table.RenameColumns Zwraca tabelę ze zmienionymi nazwami kolumn zgodnie z określoną specyfikacją.
Table.SelectColumns Zwraca tabelę z tylko określonymi kolumnami.
Table.TransformColumnNames Przekształca nazwy kolumn przy użyciu danej funkcji.
Table.Unpivot Tłumaczy zestaw kolumn w tabeli na pary atrybut-wartość.
Table.UnpivotOtherColumns Tłumaczy wszystkie kolumny inne niż określony zestaw na pary atrybut-wartość.

Przekształcenie

Nazwa Opis
Table.AddColumn Dodaje kolumnę o określonej nazwie. Wartość jest obliczana przy użyciu określonej funkcji zaznaczenia z każdym wierszem traktowanym jako dane wejściowe.
Table.AddFuzzyClusterColumn Dodaje nową kolumnę z reprezentatywnymi wartościami uzyskanymi przez grupowanie rozmyte wartości określonej kolumny w tabeli.
Table.AddIndexColumn Dołącza kolumnę z jawnymi wartościami pozycji.
Table.AddJoinColumn Wykonuje sprzężenia między tabelami w podanych kolumnach i generuje wynik sprzężenia w nowej kolumnie.
Table.AddKey Dodaje klucz do tabeli.
Table.AggregateTableColumn Agreguje kolumnę z wielu tabel w kilka kolumn w tabeli zbiorczej.
Table.CombineColumns Łączy określone kolumny w nową kolumnę przy użyciu określonej funkcji łączenia.
Table.CombineColumnsToRecord Łączy określone kolumny w nową kolumnę wartości rekordu, w której każdy rekord ma nazwy pól i wartości odpowiadające nazwom kolumn i wartościom kolumn, które zostały połączone.
Table.ConformToPageReader Ta funkcja jest przeznaczona tylko do użytku wewnętrznego.
Table.ExpandListColumn Mając kolumnę list w tabeli, utwórz kopię wiersza dla każdej wartości z tej listy.
Table.ExpandRecordColumn Rozwija kolumnę rekordów w kolumny z każdą z wartości.
Table.ExpandTableColumn Rozwija kolumnę rekordów lub kolumnę tabel do wielu kolumn w tabeli zawierającej.
Table.FillDown Propaguje wartość poprzedniej komórki do komórek o pustej wartości poniżej w kolumnie.
Table.FillUp Propaguje wartość komórki do komórek, które mają wartość null w kolumnie powyżej.
Table.FilterWithDataTable Ta funkcja jest przeznaczona tylko do użytku wewnętrznego.
Table.FuzzyGroup Grupuje wiersze w tabeli na podstawie dopasowania kluczy przy użyciu metody rozmytej.
Table.FuzzyJoin Łączy wiersze z dwóch tabel, które niedokładnie dopasowują się na podstawie podanych kluczy.
Table.FuzzyNestedJoin Wykonuje sprzężenia rozmyte między tabelami w podanych kolumnach i generuje wynik sprzężenia w nowej kolumnie.
Table.Group Grupuje wiersze w tabeli, które mają ten sam klucz.
Table.Join Łączy wiersze z dwóch tabel, które są zgodne na podstawie podanych kluczy.
Table.Keys Zwraca klucze określonej tabeli.
Table.NestedJoin Wykonuje sprzężenia między tabelami w podanych kolumnach i generuje wynik sprzężenia w nowej kolumnie.
Table.ReplaceErrorValues Zamienia wartości błędów w określonych kolumnach na odpowiednią określoną wartość.
Table.ReplaceKeys Zastępuje klucze określonej tabeli.
Table.ReplaceRelationshipIdentity Ta funkcja jest przeznaczona tylko do użytku wewnętrznego.
Table.ReplaceValue Zamienia jedną wartość na inną w określonych kolumnach.
Table.Split Dzieli określoną tabelę na listę tabel przy użyciu określonego rozmiaru strony.
Table.SplitColumn Dzieli określone kolumny na zestaw dodatkowych kolumn przy użyciu określonej funkcji rozdzielającej.
Table.TransformColumns Przekształca wartości co najmniej jednej kolumny.
Table.TransformColumnTypes Stosuje przekształcenia typów w formie { column, type } przy użyciu określonej kultury.
Table.TransformRows Przekształca wiersze tabeli przy użyciu określonej funkcji przekształcania.
Table.Transpose Przekształca kolumny w wiersze i wiersze w kolumny.

Członkostwo

Nazwa Opis
Table.Contains Wskazuje, czy określony rekord jest wyświetlany jako wiersz w tabeli.
Table.ContainsAll Wskazuje, czy wszystkie określone rekordy są wyświetlane jako wiersze w tabeli.
Table.ContainsAny Wskazuje, czy którykolwiek z określonych rekordów jest wyświetlany jako wiersz w tabeli.
Table.Distinct Usuwa z tabeli zduplikowane wiersze.
Table.IsDistinct Wskazuje, czy tabela zawiera tylko odrębne wiersze (bez duplikatów).
Table.PositionOf Zwraca położenie lub pozycje wiersza w tabeli.
Table.PositionOfAny Zwraca położenie lub pozycje dowolnego z określonych wierszy w tabeli.
Table.RemoveMatchingRows Usuwa wszystkie wystąpienia określonych wierszy z tabeli.
Table.ReplaceMatchingRows Zamienia wszystkie określone wiersze na podany wiersz lub wiersze.

Zamówienie

Nazwa Opis
Table.AddRankColumn Dołącza kolumnę z klasyfikacją co najmniej jednej innej kolumny.
Table.Max Zwraca największą wartość wiersza lub wartości domyślnej przy użyciu podanych kryteriów.
Table.MaxN Zwraca największy wiersz lub wiersze przy użyciu podanych kryteriów.
Table.Min Zwraca najmniejszy wiersz lub wartość domyślną przy użyciu podanych kryteriów.
Table.MinN Zwraca najmniejszy wiersz lub wiersze przy użyciu podanych kryteriów.
Table.Sort Sortuje tabelę przy użyciu co najmniej jednej nazwy kolumn i kryteriów porównania.

Pozostałe

Nazwa Opis
Table.Buffer Buforuje tabelę w pamięci, izolując ją od zmian zewnętrznych podczas oceny.
Table.StopFolding Zapobiega uruchamianiu żadnych operacji podrzędnych względem oryginalnego źródła danych.

Wartości parametrów

Nazewnictwo kolumn wyjściowych

Ten parametr jest listą wartości tekstowych określających nazwy kolumn wynikowej tabeli. Ten parametr jest zwykle używany w funkcjach budowy tabeli , takich jak Table.FromRows i Table.FromList.

Kryteria porównania

Kryterium porównania można podać jako jedną z następujących wartości:

  • Wartość liczbowa określająca kolejność sortowania. Więcej informacji: Kolejność sortowania

  • Aby obliczyć klucz używany do sortowania, można użyć funkcji jednego argumentu.

  • Aby wybrać zarówno klucz, jak i kolejność sterowania, kryterium porównania może być lista zawierająca klucz i kolejność.

  • Aby całkowicie kontrolować porównanie, można użyć funkcji dwóch argumentów, która zwraca wartość -1, 0 lub 1, biorąc pod uwagę relację między danymi wejściowymi po lewej i prawej stronie. Value.Compare można użyć do delegowania tej logiki.

Aby uzyskać przykłady, przejdź do opisu Table.Sort.

Kryteria dotyczące liczby lub warunku

Te kryteria są zwykle używane w operacjach porządkowania lub wierszy. Określa liczbę wierszy zwracanych w tabeli i może przyjmować dwie formy: liczbę lub warunek.

  • Liczba wskazuje, ile wartości należy zwrócić zgodnie z odpowiednią funkcją.

  • Jeśli określono warunek, zwracane są wiersze zawierające wartości, które początkowo spełniają warunek. Gdy wartość zakończy się niepowodzeniem warunku, nie są brane pod uwagę żadne dalsze wartości.

Więcej informacji: Table.FirstN, Table.MaxN

Obsługa dodatkowych wartości

Dodatkowe wartości służą do wskazywania, jak funkcja powinna obsługiwać dodatkowe wartości w wierszu. Ten parametr jest określany jako liczba, która jest mapowana na następujące opcje:

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

Więcej informacji: Table.FromList, ExtraValues.Type

Brak obsługi kolumn

Ten parametr służy do wskazywania, jak funkcja powinna obsługiwać brakujące kolumny. Ten parametr jest określany jako liczba, która jest mapowana na następujące opcje:

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

Ten parametr jest używany w operacjach kolumn lub transformacji, na przykład w Table.TransformColumns. Więcej informacji: MissingField.Type

Kolejność sortowania

Kolejność sortowania służy do wskazywania sposobu sortowania wyników. Ten parametr jest określany jako liczba, która jest mapowana na następujące opcje:

Order.Ascending = 0
Order.Descending = 1

Więcej informacji: Order.Type

Kryteria równania

Kryteria równania dla tabel można określić jako:

  • Wartość funkcji, która jest jedną z następujących wartości:

    • Selektor kluczy, który określa kolumnę w tabeli w celu zastosowania kryteriów równości.

    • Funkcja porównująca, która służy do określania rodzaju porównania do zastosowania. Można określić wbudowane funkcje porównujące. Więcej informacji: funkcje Comparer

  • Lista kolumn w tabeli w celu zastosowania kryteriów równości.

Aby uzyskać przykłady, przejdź do opisu Table.Distinct.