Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Funkcje tabeli

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

Konstrukcja tabeli

Nazwa 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 zagnieżdżone listy, które zawierają nazwy kolumn i ich wartości.
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 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.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 wyzwala rezerwowego, gdy zostanie zgłoszony przez procedurę obsługi zdefiniowaną w interfejsie (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 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 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 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ę zawierającą listę wierszy wstawionych do tabeli pod określonym indeksem. 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 określoną liczbę grup tabel, na podstawie wartości kolumny każdego wiersza oraz funkcji skrótu. Funkcja skrótu jest stosowana do wartości kolumny danego wiersza w celu uzyskania wartości skrótu dla wiersza. Wartość skrótu modulo grupy określa, w której z zwracanych tabel zostanie umieszczony wiersz.
Table.PartitionValues Zwraca informacje o sposobie partycjonowania tabeli.
Table.Range Zwraca określoną liczbę wierszy z tabeli, zaczynając od podanego 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 tej tabeli powtórzone określoną liczbę razy.
Table.ReplaceRows Zwraca tabelę, w której wiersze zaczynające się od określonego przesunięcia i obejmujące określoną liczbę są zastępowane przez podane wiersze.
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 ani pierwszych wierszy.
Table.SplitAt Zwraca listę zawierającą określone pierwsze wiersze zliczania i pozostałe wiersze.

Operacje na kolumnach

Nazwa 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 Przekształca pierwszy wiersz tabeli w nagłówki 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ę ze zmienionymi nazwami kolumn zgodnie z określoną specyfikacją.
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, oprócz określonego zestawu, na pary atrybut-wartość, łącząc je z pozostałymi wartościami w każdym wierszu.

Przekształcenie

Nazwa Opis
Table.AddColumn Dodaje kolumnę o nazwie newColumnName do tabeli.
Table.AddFuzzyClusterColumn Dodaje nową kolumnę z reprezentatywnymi wartościami uzyskanymi przez grupowanie rozmyte wartości 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ężenie zagnieżdżone między tabelą Table1 i tabelą Table2 z określonych kolumn i generuje wynik sprzężenia jako kolumnę o nazwie nowaNazwaKolumny 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 Table.CombineColumns scala kolumny przy użyciu funkcji łączenia w celu utworzenia nowej kolumny. Table.CombineColumns jest odwrotnością 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 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 Zamienia wartości null w określonej kolumnie lub kolumnach tabeli na najnowszą dostępną wartość inną niż null w tej kolumnie.
Table.FillUp Zwraca tabelę na podstawie określonej tabeli, w której wartość kolejnej komórki jest propagowana do komórek o wartości null znajdujących się powyżej w podanej 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 tabelę 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 starą wartość na nową wartość w określonych kolumnach tabeli, używając podanej funkcji zastępowania, takiej jak text.Replace 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.Transpose Zwraca tabelę z kolumnami przekonwertowanymi na wiersze i wiersze przekonwertowane na kolumny z tabeli wejściowej.

Członkostwo

Nazwa 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 dowolnego z wskazanych wierszy w tabeli.
Table.RemoveMatchingRows Usuwa wszystkie wystąpienia wierszy z tabeli.
Table.ReplaceMatchingRows Zamienia określone wiersze z tabeli na nowe wiersze.

Zamówienie

Nazwa Opis
Table.Max Zwraca największy wiersz lub wiersze z tabeli przy użyciu kryterium porównania.
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 kryteriów porównania.
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 za pomocą kryteriów porównawczych lub domyślnego porządku, jeśli nie zostanie określony.

Pozostałe

Nazwa 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: 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.