Sdílet prostřednictvím

Tabulkové funkce

  • Článek

Tyto funkce vytvářejí hodnoty tabulek a manipulují s nimi.

Konstrukce tabulek

Jméno Popis
#table Vytvoří hodnotu tabulky ze sloupců a řádků.
ItemExpression.From Vrátí abstraktní strom syntaxe (AST) pro tělo funkce.
ItemExpression.Item Uzel abstraktního stromu syntaxe (AST) představující položku v položkovém výrazu.
RowExpression.Column Vrátí abstraktní syntaktický strom (AST), který reprezentuje přístup ke sloupci v rámci výrazu řádku.
RowExpression.From Vrátí abstraktní strom syntaxe (AST) pro tělo funkce.
RowExpression.Row Uzel abstraktního syntaktického stromu (AST) představující řádek v řádkovém výrazu.
Table.FromColumns Vytvoří tabulku ze seznamu sloupců a zadaných hodnot.
Table.FromList Převede seznam na tabulku použitím zadané funkce rozdělení na každou položku v seznamu.
Table.FromRecords Převede seznam záznamů na tabulku.
Table.FromRows Vytvoří tabulku ze seznamu hodnot řádků a volitelných sloupců.
Table.FromValue Vytvoří tabulku se sloupcem z zadané hodnoty nebo hodnot.
Table.WithErrorContext Tato funkce je určená pouze pro interní použití.
Table.View Vytvoří nebo rozšíří tabulku s uživatelsky definovanými obslužnými rutinami pro operace dotazů a akcí.
Table.ViewError Vytvoří upravený záznam chyby, který při vyvolání obslužnou rutinou definovanou v zobrazení (prostřednictvím Table.View) neaktivuje záložní záznam.
Table.ViewFunction Vytvoří funkci, kterou může intercepcovat obslužná rutina definovaná v zobrazení (prostřednictvím Table.View).

Konverzace

Jméno Popis
Table.ToColumns Vytvoří seznam vnořených seznamů hodnot sloupců z tabulky.
Table.ToList Převede tabulku na seznam použitím zadané funkce kombinování na každý řádek hodnot v tabulce.
Table.ToRecords Převede tabulku na seznam záznamů.
Table.ToRows Vytvoří seznam vnořených seznamů hodnot řádků z tabulky.

Informace

Jméno Popis
Table.ApproximateRowCount Vrátí přibližný počet řádků v tabulce.
Table.ColumnCount Vrátí počet sloupců v tabulce.
Table.IsEmpty Určuje, jestli tabulka obsahuje nějaké řádky.
Table.PartitionValues Vrátí informace o rozdělení tabulky.
Table.Profile Vrátí profil sloupců tabulky.
Table.RowCount Vrátí počet řádků v tabulce.
Table.Schema Vrátí tabulku obsahující popis sloupců (tj. schématu) zadané tabulky.
Tables.GetRelationships Získá relace mezi sadou tabulek.

Operace řádků

Jméno Popis
Table.AlternateRows Zachová počáteční posun a poté střídá výběr a přeskakování následujících řádků.
Table.Combine Vrátí tabulku, která je výsledkem sloučení seznamu tabulek.
Table.FindText Vrátí všechny řádky, které obsahují daný text v tabulce.
Table.First Vrátí první řádek nebo zadanou výchozí hodnotu.
Table.FirstN Vrátí zadaný první počet řádků.
Table.FirstValue Vrátí první sloupec prvního řádku tabulky nebo zadanou výchozí hodnotu.
Table.FromPartitions Vrátí tabulku, která je výsledkem kombinování sady dělených tabulek.
Table.InsertRows Vloží seznam řádků do tabulky na určené pozici.
Table.Last Vrátí poslední řádek nebo zadanou výchozí hodnotu.
Table.LastN Vrátí poslední zadaný počet řádků.
Table.MatchesAllRows Určuje, jestli všechny řádky v tabulce splňují danou podmínku.
Table.MatchesAnyRows Určuje, jestli některé řádky v tabulce splňují danou podmínku.
Table.Partition Rozdělí tabulku do seznamu tabulek na základě počtu zadaných skupin a sloupců.
Table.Range Vrátí řádky začínající zadaným posunem.
Table.RemoveFirstN Vrátí tabulku se zadaným počtem řádků odebraných z tabulky počínaje prvním řádkem.
Table.RemoveLastN Vrátí tabulku se zadaným počtem řádků odebraných z tabulky počínaje posledním řádkem.
Table.RemoveRows Odebere zadaný počet řádků.
Table.RemoveRowsWithErrors Vrátí tabulku s řádky odebranými ze vstupní tabulky, které obsahují chybu v alespoň jedné z buněk. Pokud je zadaný seznam sloupců, zkontrolují se chyby pouze v buňkách v zadaných sloupcích.
Table.Repeat Opakuje řádky tabulek zadaný početkrát.
Table.ReplaceRows Nahradí zadanou oblast řádků zadaným řádkem nebo řádky.
Table.ReverseRows Vrátí tabulku s řádky v obráceném pořadí.
Table.SelectRows Vybere řádky, které splňují funkci podmínky.
Table.SelectRowsWithErrors Vrátí tabulku pouze s řádky vstupní tabulky, které obsahují chybu alespoň v jedné z buněk. Pokud je zadaný seznam sloupců, zkontrolují se chyby pouze v buňkách v zadaných sloupcích.
Table.SingleRow Vrátí jeden řádek v tabulce.
Table.Skip Vrátí tabulku s prvním zadaným počtem vynechaných řádků.
Table.SplitAt Vrátí seznam obsahující zadaný počet prvních řádků a zbývající řádky.

Operace se sloupci

Jméno Popis
Table.Column Vrátí zadaný sloupec dat z tabulky jako seznam.
Table.ColumnNames Vrátí názvy sloupců jako seznam.
Table.ColumnsOfType Vrátí seznam s názvy sloupců, které odpovídají zadaným typům.
Table.DemoteHeaders Sníží záhlaví sloupců na první řádek hodnot.
Table.DuplicateColumn Duplikuje sloupec se zadaným názvem. Hodnoty a typ se zkopírují ze zdrojového sloupce.
Table.HasColumns Určuje, zda tabulka obsahuje zadaný sloupec nebo sloupce.
Table.Pivot Je-li k dispozici pár sloupců představujících páry atribut-hodnota, data ve sloupci atributu se otočí do podoby záhlaví sloupců.
Table.PrefixColumns Vrátí tabulku, ve které byly všechny sloupce opatřeny předponou daného textu.
Table.PromoteHeaders Propaguje první řádek hodnot jako záhlaví nových sloupců (to znamená jako názvy sloupců).
Table.RemoveColumns Odebere zadané sloupce.
Table.ReorderColumns Vrátí tabulku se sloupci v zadaném pořadí.
Table.RenameColumns Vrátí tabulku se sloupci přejmenovanými tak, jak je uvedeno.
Table.SelectColumns Vrátí tabulku pouze se zadanými sloupci.
Table.TransformColumnNames Transformuje názvy sloupců pomocí dané funkce.
Table.Unpivot Převede sadu sloupců v tabulce na páry atribut-hodnota.
Table.UnpivotOtherColumns Přeloží všechny sloupce kromě zadané sady do párů atribut-hodnota.

Transformace

Jméno Popis
Table.AddColumn Přidá sloupec se zadaným názvem. Hodnota se vypočítá pomocí zadané funkce výběru s každým řádkem pořízeným jako vstup.
Table.AddFuzzyClusterColumn Přidá nový sloupec s reprezentativními hodnotami získanými přibližným seskupením hodnot zadaného sloupce v tabulce.
Table.AddIndexColumn Připojí sloupec s explicitními hodnotami pozice.
Table.AddJoinColumn Provede spojení mezi tabulkami na zadaných sloupcích a vytvoří výsledek spojení v novém sloupci.
Table.AddKey Přidá klíč do tabulky.
Table.AggregateTableColumn Agreguje sloupec tabulek do více sloupců v tabulce obsahující tabulku.
Table.CombineColumns Zkombinuje zadané sloupce do nového sloupce pomocí zadané kombinační funkce.
Table.CombineColumnsToRecord Zkombinuje zadané sloupce do nového sloupce s hodnotou záznamu, kde každý záznam obsahuje názvy polí a hodnoty odpovídající názvům sloupců a hodnotám sloupců, které byly sloučeny.
Table.ConformToPageReader Tato funkce je určená pouze pro interní použití.
Table.ExpandListColumn Pokud je sloupec seznamů v tabulce, vytvořte kopii řádku pro každou hodnotu v seznamu.
Table.ExpandRecordColumn Rozšíří sloupec záznamů do sloupců s každou z hodnot.
Table.ExpandTableColumn Rozšíří sloupec záznamů nebo sloupce tabulek do více sloupců v tabulce obsahující tabulku.
Table.FillDown Rozšíří hodnotu předchozí buňky do buněk s hodnotou null níže ve sloupci.
Table.FillUp Rozšíří hodnotu buňky do buněk s hodnotou null výše ve sloupci.
Table.FilterWithDataTable Tato funkce je určená pouze pro interní použití.
Table.FuzzyGroup Seskupí řádky v tabulce na základě přibližných shod klíčů.
Table.FuzzyJoin Spojí řádky ze dvou tabulek, které se zhruba shodují na základě uvedených klíčů.
Table.FuzzyNestedJoin Provede přibližné spojení mezi tabulkami na zadaných sloupcích a vytvoří výsledek spojení v novém sloupci.
Table.Group Seskupí řádky v tabulce se stejným klíčem.
Table.Join Spojí řádky ze dvou tabulek, které odpovídají zadaným klíčům.
Table.Keys Vrátí klíče zadané tabulky.
Table.NestedJoin Provede spojení mezi tabulkami na zadaných sloupcích a vytvoří výsledek spojení v novém sloupci.
Table.ReplaceErrorValues Nahradí chybové hodnoty v zadaných sloupcích odpovídající zadanou hodnotou.
Table.ReplaceKeys Nahradí klíče zadané tabulky.
Table.ReplaceRelationshipIdentity Tato funkce je určená pouze pro interní použití.
Table.ReplaceValue Nahradí jednu hodnotu jinou v zadaných sloupcích.
Table.Split Rozdělí zadanou tabulku do seznamu tabulek pomocí zadané velikosti stránky.
Table.SplitColumn Rozdělí zadané sloupce do sady dalších sloupců pomocí zadané rozdělovací funkce.
Table.TransformColumns Transformuje hodnoty jednoho nebo více sloupců.
Table.TransformColumnTypes Použije transformace typů ve formátu { sloupec, typ } pomocí konkrétního kulturního nastavení.
Table.TransformRows Transformuje řádky tabulky pomocí zadané funkce transformace.
Table.Transpose Převede sloupce na řádky a řádky do sloupců.

Členství

Jméno Popis
Table.Contains Určuje, jestli se zadaný záznam zobrazí jako řádek v tabulce.
Table.ContainsAll Určuje, jestli se všechny zadané záznamy zobrazují jako řádky v tabulce.
Table.ContainsAny Určuje, jestli se některý ze zadaných záznamů zobrazuje jako řádky v tabulce.
Table.Distinct Odebere duplicitní řádky z tabulky.
Table.IsDistinct Určuje, jestli tabulka obsahuje pouze jedinečné řádky (žádné duplicity).
Table.PositionOf Vrací pozici nebo pozice řádku v tabulce.
Table.PositionOfAny Vrátí pozici nebo pozice libovolného zadaného řádku v tabulce.
Table.RemoveMatchingRows Odebere všechny výskyty zadaných řádků z tabulky.
Table.ReplaceMatchingRows Nahradí všechny zadané řádky zadaným řádkem nebo řádky.

Objednávání

Jméno Popis
Table.AddRankColumn Připojí sloupec s hodnocením jednoho nebo více dalších sloupců.
Table.Max Vrátí největší řádek nebo výchozí hodnotu pomocí daných kritérií.
Table.MaxN Vrátí největší řádek nebo řádky pomocí zadaných kritérií.
Table.Min Vrátí nejmenší řádek nebo výchozí hodnotu pomocí daných kritérií.
Table.MinN Vrátí nejmenší řádek nebo řádky pomocí zadaných kritérií.
Table.Sort Seřadí tabulku pomocí jednoho nebo více názvů sloupců a kritérií porovnání.

Jiný

Jméno Popis
Table.Buffer Uloží tabulku do vyrovnávací paměti a během vyhodnocení ji izoluje od externích změn.
Table.StopFolding Zabrání spuštění všech podřízených operací proti původnímu zdroji dat.

Hodnoty parametrů

Pojmenování výstupních sloupců

Tento parametr je seznam textových hodnot určující názvy sloupců výsledné tabulky. Tento parametr se obecně používá ve funkcích pro konstrukci tabulky , jako jsou Table.FromRows a Table.FromList.

Srovnávací kritéria

Kritérium porovnání lze zadat jako jednu z následujících hodnot:

  • Číselná hodnota pro zadání pořadí řazení. Další informace: pořadí řazení

  • K výpočtu klíče, který se má použít k řazení, lze použít funkci jednoho argumentu.

  • Pokud chcete vybrat klíč i pořadí ovládacích prvků, může být kritérium porovnání seznam obsahující klíč a pořadí.

  • K úplnému řízení porovnání lze použít funkci dvou argumentů, která vrátí hodnotu -1, 0 nebo 1 vzhledem k relaci mezi vstupy zleva a doprava. Value.Compare lze použít k delegování této logiky.

Příklady najdete v popisu Table.Sort.

Kritéria počtu nebo podmínky

Tato kritéria se obvykle používají v operacích řazení nebo řádků. Určuje počet řádků vrácených v tabulce a může mít dva tvary, číslo nebo podmínku.

  • Číslo určuje, kolik hodnot se má vrátit v souladu s příslušnou funkcí.

  • Pokud je zadaná podmínka, vrátí se řádky obsahující hodnoty, které původně splňují podmínku. Jakmile hodnota nesplňuje podmínku, nejsou brány v úvahu žádné další hodnoty.

Další informace: Table.FirstN, Table.MaxN

Zpracování dodatečných hodnot

Další hodnoty se používají k označení, jak by funkce měla zpracovávat nadbytečné hodnoty v řádku. Tento parametr se zadává jako číslo, které se mapuje na následující možnosti:

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

Další informace: Table.FromList, ExtraValues.Type

Řešení chybějících sloupců

Tento parametr se používá k označení, jak by funkce měla zpracovávat chybějící sloupce. Tento parametr se zadává jako číslo, které se mapuje na následující možnosti:

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

Tento parametr se používá ve sloupcových nebo transformačních operacích, například v Table.TransformColumns. Další informace: MissingField.Type

Pořadí řazení

Řazení se používá k označení způsobu řazení výsledků. Tento parametr se zadává jako číslo, které se mapuje na následující možnosti:

Order.Ascending = 0
Order.Descending = 1

Další informace: Order.Type

Kritéria rovnice

Kritéria rovnice pro tabulky lze zadat takto:

  • Hodnota funkce, která je buď:

    • Selektor klíčů, který určuje sloupec v tabulce, aby se použila kritéria rovnosti.

    • Porovnávací funkce, která se používá k určení druhu porovnání, který se má použít. Vestavěné porovnávací funkce lze určit. Další informace: porovnávací funkce

  • Seznam sloupců v tabulce pro použití kritérií rovnosti

Příklady najdete v popisu Table.Distinct.