Udostępnij za pośrednictwem

Funkcje tabeli

  • Artykuł

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

Konstrukcja tabeli

Nazwa/nazwisko opis
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 Zwraca tabelę z listy zawierającej listy zagnieżdżone z nazwami kolumn i wartościami.
Table.FromList Konwertuje listę na tabelę, stosując określoną funkcję podziału do każdego elementu na liście.
Table.FromRecords Zwraca tabelę z listy rekordów.
Table.FromRows Tworzy tabelę z listy, gdzie każdy element listy jest listą zawierającą wartości kolumn dla jednego wiersza.
Table.FromValue Zwraca tabelę z kolumną zawierającą podaną wartość lub listę wartości.
Table.FuzzyGroup Grupuje wiersze tabeli przez rozmyte dopasowywanie wartości w określonej kolumnie dla każdego wiersza.
Table.FuzzyJoin Łączy wiersze z dwóch tabel, które pasują rozmyte 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.Split Dzieli określoną tabelę na listę tabel przy użyciu określonego rozmiaru strony.
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 tabeli.View).
Table.ViewFunction Tworzy funkcję, która może zostać przechwycona przez procedurę obsługi zdefiniowaną w widoku (za pośrednictwem funkcji Table.View).

Konwersje

Nazwa/nazwisko opis
Table.ToColumns Zwraca listę zagnieżdżonych list, z których każda reprezentuje kolumnę wartości w tabeli wejściowej.
Table.ToList Zwraca tabelę do listy, stosując określoną funkcję łączącą do każdego wiersza wartości w tabeli.
Table.ToRecords Zwraca listę rekordów z tabeli wejściowej.
Table.ToRows Zwraca listę zagnieżdżonych wartości wierszy z tabeli wejściowej.

Informacja

Nazwa/nazwisko opis
Table.ApproximateRowCount Zwraca przybliżoną liczbę wierszy w tabeli.
Table.ColumnCount Zwraca liczbę kolumn w tabeli.
Table.IsEmpty Zwraca wartość true, jeśli tabela nie zawiera żadnych wierszy.
Table.Profile Zwraca profil kolumn tabeli.
Table.RowCount Zwraca liczbę wierszy w tabeli.
Table.Schema Zwraca tabelę zawierającą opis kolumn (tj. schemat) określonej tabeli.
Tables.GetRelationships Zwraca relacje między zestawem tabel.

Operacje na wierszach

Nazwa/nazwisko opis
Table.AlternateRows Zwraca tabelę zawierającą naprzemienny wzorzec wierszy z tabeli.
Table.Combine Zwraca tabelę, która jest wynikiem scalania listy tabel. Wszystkie tabele muszą mieć taką samą strukturę typu wiersza.
Table.FindText Zwraca tabelę zawierającą tylko wiersze, które mają określony tekst w jednej z ich komórek lub dowolnej jego części.
Table.First Zwraca pierwszy wiersz z tabeli.
Table.FirstN Zwraca pierwsze wiersze tabeli w zależności od parametru countOrCondition.
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 partycjonowanych tabel w nowe kolumny. Typ kolumny można opcjonalnie określić, a wartość domyślna to dowolna.
Table.InsertRows Zwraca tabelę z listą wierszy wstawionych do tabeli w indeksie. Każdy wiersz do wstawienia musi być zgodny z typem wiersza tabeli.
Table.Last Zwraca ostatni wiersz tabeli.
Table.LastN Zwraca ostatnie wiersze z tabeli w zależności od parametru countOrCondition.
Table.MatchesAllRows Zwraca wartość true, jeśli wszystkie wiersze w tabeli spełniają warunek.
Table.MatchesAnyRows Zwraca wartość true, jeśli którykolwiek z wierszy w tabeli spełnia warunek.
Table.Partition Dzieli tabelę na listę grup liczby tabel na podstawie wartości kolumny każdego wiersza i funkcji skrótu. Funkcja skrótu jest stosowana do wartości kolumny wiersza w celu uzyskania wartości skrótu dla wiersza. Grupy modulo wartości skrótu określają, w których z zwracanych tabel zostanie umieszczony wiersz.
Table.PartitionValues Zwraca informacje o sposobie partycjonowania tabeli.
Table.Range Zwraca określoną liczbę wierszy z tabeli rozpoczynającej się od przesunięcia.
Table.RemoveFirstN Zwraca tabelę z określoną liczbą wierszy usuniętych z tabeli, zaczynając od pierwszego wiersza. Liczba usuniętych wierszy zależy od opcjonalnego parametru countOrCondition.
Table.RemoveLastN Zwraca tabelę z określoną liczbą wierszy usuniętych z tabeli, zaczynając od ostatniego wiersza. Liczba usuniętych wierszy zależy od opcjonalnego parametru countOrCondition.
Table.RemoveRows Zwraca tabelę z określoną liczbą wierszy usuniętych z tabeli rozpoczynającej się od przesunięcia.
Table.RemoveRowsWithErrors Zwraca tabelę ze wszystkimi wierszami usuniętymi z tabeli, które zawierają błąd w co najmniej jednej komórce w wierszu.
Table.Repeat Zwraca tabelę zawierającą wiersze tabeli powtórzone liczby razy.
Table.ReplaceRows Zwraca tabelę, w której wiersze rozpoczynające się od przesunięcia i kontynuujące liczbę są zastępowane podanymi wierszami.
Table.ReverseRows Zwraca tabelę z wierszami w odwrotnej kolejności.
Table.SelectRows Zwraca tabelę zawierającą tylko wiersze zgodne z warunkiem.
Table.SelectRowsWithErrors Zwraca tabelę zawierającą tylko wiersze z tabeli, które zawierają błąd w co najmniej jednej komórce w wierszu.
Table.SingleRow Zwraca pojedynczy wiersz z tabeli.
Table.Skip Zwraca tabelę, która nie zawiera pierwszego wiersza ani wierszy tabeli.
Table.SplitAt Zwraca listę zawierającą określone pierwsze wiersze zliczania i pozostałe wiersze.

Operacje na kolumnach

Nazwa/nazwisko opis
Table.Column Zwraca wartości z kolumny w tabeli.
Table.ColumnNames Zwraca nazwy kolumn z tabeli.
Table.ColumnsOfType Zwraca listę z nazwami kolumn, które są zgodne z określonymi typami.
Table.DemoteHeaders Obniża wiersz nagłówka w dół do pierwszego wiersza tabeli.
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ślone kolumny.
Table.Pivot Biorąc pod uwagę kolumnę tabeli i atrybutu zawierającą wartości przestawne, tworzy nowe kolumny dla każdej z wartości przestawnych i przypisuje im wartości z kolumny valueColumn. Opcjonalna funkcja agregacji może być udostępniana w celu obsługi wielu wystąpień tej samej wartości klucza w kolumnie atrybutu.
Table.PrefixColumns Zwraca tabelę, w której wszystkie kolumny zostały poprzedzone wartością tekstową.
Table.PromoteHeaders Podwyższa poziom pierwszego wiersza tabeli do nazw nagłówków lub kolumn.
Table.RemoveColumns Zwraca tabelę bez określonej kolumny lub kolumn.
Table.ReorderColumns Zwraca tabelę z określonymi kolumnami w kolejności względem siebie.
Table.RenameColumns Zwraca tabelę z kolumnami o zmienionej nazwie zgodnie z określoną.
Table.SelectColumns Zwraca tabelę zawierającą tylko określone kolumny.
Table.TransformColumnNames Przekształca nazwy kolumn przy użyciu danej funkcji.
Table.Unpivot Biorąc pod uwagę listę kolumn tabeli, przekształca te kolumny w pary atrybut-wartość.
Table.UnpivotOtherColumns Tłumaczy wszystkie kolumny inne niż określony zestaw na pary atrybut-wartość w połączeniu z resztą wartości w każdym wierszu.

Przekształcenie

Nazwa/nazwisko opis
Table.AddColumn Dodaje kolumnę o nazwie newColumnName do tabeli.
Table.AddFuzzyClusterColumn Dodaje nową kolumnę z reprezentatywnymi wartościami uzyskanymi przez rozmyte wartości grupowania określonej kolumny w tabeli.
Table.AddIndexColumn Zwraca tabelę z nową kolumną o określonej nazwie, która dla każdego wiersza zawiera indeks wiersza w tabeli.
Table.AddJoinColumn Wykonuje sprzężenia zagnieżdżone między tabelą Table1 i table2 z określonych kolumn i generuje wynik sprzężenia jako nową kolumnęColumnName dla każdego wiersza tabeli Table1.
Table.AddKey Dodaje klucz do tabeli.
Table.AggregateTableColumn Agreguje tabele zagnieżdżone w określonej kolumnie do wielu kolumn zawierających wartości agregujące dla tych tabel.
Table.CombineColumns Funkcja Table.CombineColumns scala kolumny przy użyciu funkcji łączenia w celu utworzenia nowej kolumny. Funkcja Table.CombineColumns jest odwrotnością funkcji Table.SplitColumns.
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 Biorąc pod uwagę kolumnę list w tabeli, utwórz kopię wiersza dla każdej wartości na liście.
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 Zamienia wartości null w określonej kolumnie lub kolumnach tabeli na najnowszą wartość inną niż null w kolumnie.
Table.FillUp Zwraca tabelę z tabeli określonej, w której wartość następnej komórki jest propagowana do komórek wartości null powyżej w określonej kolumnie.
Table.FilterWithDataTable Ta funkcja jest przeznaczona tylko do użytku wewnętrznego.
Table.Group Grupuje wiersze tabeli według wartości kolumn kluczy dla każdego wiersza.
Table.Join Łączy wiersze tabeli Table1 z wierszami tabeli Table2 na podstawie równości wartości kolumn kluczy wybranych przez tabelę Table1, key1 i table2, key2.
Table.Keys Zwraca klucze określonej tabeli.
Table.NestedJoin Łączy wiersze tabel na podstawie równości kluczy. Wyniki są wprowadzane 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 Zastępuje wartość oldValue wartością newValue w określonych kolumnach tabeli przy użyciu podanej funkcji zastępowania, takiej jak tekst. Zastąp lub Value.Replace.
Table.SplitColumn Zwraca nowy zestaw kolumn z pojedynczej kolumny stosującej funkcję rozdzielającą do każdej wartości.
Table.TransformColumns Przekształca wartości co najmniej jednej kolumny.
Table.TransformColumnTypes Przekształca typy kolumn z tabeli przy użyciu typu.
Table.TransformRows Przekształca wiersze z tabeli przy użyciu funkcji transform.
Table.Transponuj Zwraca tabelę z kolumnami przekonwertowanymi na wiersze i wiersze przekonwertowane na kolumny z tabeli wejściowej.

Członkostwo

Nazwa/nazwisko opis
Table.Contains Określa, czy rekord jest wyświetlany jako wiersz w tabeli.
Table.ContainsAll Określa, czy wszystkie określone rekordy są wyświetlane jako wiersze w tabeli.
Table.ContainsAny Określa, czy którykolwiek z określonych rekordów jest wyświetlany jako wiersz w tabeli.
Table.Distinct Usuwa zduplikowane wiersze z tabeli, zapewniając, że wszystkie pozostałe wiersze są odrębne.
Table.IsDistinct Określa, czy tabela zawiera tylko odrębne wiersze.
Table.PositionOf Określa położenie lub pozycje wiersza w tabeli.
Table.PositionOfAny Określa położenie lub położenie dowolnego z określonych wierszy w tabeli.
Table.RemoveMatchingRows Usuwa wszystkie wystąpienia wierszy z tabeli.
Table.ReplaceMatchingRows Zamienia określone wiersze z tabeli na nowe wiersze.

Zamawianie

Nazwa/nazwisko opis
Table.Max Zwraca największy wiersz lub wiersze z tabeli przy użyciu elementu comparisonCriteria.
Table.MaxN Zwraca największe N wierszy z tabeli. Po posortowania wierszy należy określić parametr countOrCondition w celu dalszego filtrowania wyniku.
Table.Min Zwraca najmniejszy wiersz lub wiersze z tabeli przy użyciu elementu comparisonCriteria.
Table.MinN Zwraca najmniejsze N wierszy w danej tabeli. Po posortowania wierszy należy określić parametr countOrCondition w celu dalszego filtrowania wyniku.
Table.AddRankColumn Dołącza kolumnę z klasyfikacją co najmniej jednej innej kolumny.
Table.Sort Sortuje wiersze w tabeli przy użyciu elementu comparisonCriteria lub domyślnego porządkowania, jeśli nie zostanie określony.

Inne

Nazwa/nazwisko opis
Table.Buffer Buforuje tabelę do pamięci, izolując ją od zmian zewnętrznych podczas oceny.

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: Sortowanie kolejności

  • 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. Funkcja Value.Compare może służyć do delegowania tej logiki.

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

Kryteria 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 formularze, liczbę lub warunek.

  • Liczba wskazuje, ile wartości ma być zwracanych w tekście 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 tabeli 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 porównujące

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

Przykłady można znaleźć w opisie obiektu Table.Distinct.