Sdílet prostřednictvím

Tabulkové funkce

  • Článek

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

Konstrukce tabulek

Název Popis
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 ve výrazu položky.
RowExpression.Column Vrátí abstraktní strom syntaxe (AST), který představuje přístup ke sloupci ve výrazu řádku.
RowExpression.From Vrátí abstraktní strom syntaxe (AST) pro tělo funkce.
RowExpression.Row Uzel abstraktního stromu syntaxe (AST) představující řádek ve výrazu řádku.
Table.FromColumns Vrátí tabulku ze seznamu obsahujícího vnořené seznamy s názvy sloupců a hodnotami.
Table.FromList Převede seznam na tabulku použitím zadané funkce rozdělení na každou položku v seznamu.
Table.FromRecords Vrátí tabulku ze seznamu záznamů.
Table.FromRows Vytvoří tabulku ze seznamu, kde každý prvek seznamu je seznam obsahující hodnoty sloupců pro jeden řádek.
Table.FromValue Vrátí tabulku se sloupcem obsahujícím zadanou hodnotu nebo seznam hodnot.
Table.FuzzyGroup Seskupí řádky tabulky podle přibližné shody hodnot v zadaném sloupci pro každý řádek.
Table.FuzzyJoin Spojí řádky ze dvou tabulek, které přibližné shody odpovídají na základě daný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.Split Rozdělí zadanou tabulku do seznamu tabulek pomocí zadané velikosti stránky.
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 zachytit obslužná rutina definovaná v zobrazení (prostřednictvím Table.View).

Převody

Název Popis
Table.ToColumns Vrátí seznam vnořených seznamů, z nichž každý představuje sloupec hodnot ve vstupní tabulce.
Table.ToList Vrátí tabulku do seznamu použitím zadané funkce kombinování na každý řádek hodnot v tabulce.
Table.ToRecords Vrátí seznam záznamů ze vstupní tabulky.
Table.ToRows Vrátí vnořený seznam hodnot řádků ze vstupní tabulky.

Informace

Název Popis
Table.ApproximateRowCount Vrátí přibližný počet řádků v tabulce.
Table.ColumnCount Vrátí počet sloupců v tabulce.
Table.IsEmpty Vrátí hodnotu true, pokud tabulka neobsahuje žádné řádky.
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éma) zadané tabulky.
Tables.GetRelationships Vrátí relace mezi sadou tabulek.

Operace řádků

Název Popis
Table.AlternateRows Vrátí tabulku obsahující střídavý vzor řádků z tabulky.
Table.Combine Vrátí tabulku, která je výsledkem sloučení seznamu tabulek. Všechny tabulky musí mít stejnou strukturu typu řádku.
Table.FindText Vrátí tabulku obsahující pouze řádky, které mají zadaný text v jedné z buněk nebo jejich části.
Table.First Vrátí první řádek z tabulky.
Table.FirstN Vrátí první řádky tabulky v závislosti na parametru countOrCondition.
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 do nových sloupců. Volitelně lze zadat typ sloupce, výchozí hodnota je libovolná.
Table.InsertRows Vrátí tabulku se seznamem řádků vložených do tabulky v indexu. Každý řádek, který chcete vložit, musí odpovídat typu řádku tabulky.
Table.Last Vrátí poslední řádek tabulky.
Table.LastN Vrátí poslední řádky z tabulky v závislosti na parametru countOrCondition.
Table.MatchesAllRows Vrátí hodnotu true, pokud všechny řádky v tabulce splňují podmínku.
Table.MatchesAnyRows Vrátí hodnotu true, pokud některý z řádků v tabulce splňuje podmínku.
Table.Partition Rozdělí tabulku na seznam skupin s počtem tabulek na základě hodnoty sloupce každého řádku a funkce hash. Funkce hash se použije na hodnotu sloupce řádku, aby získala hodnotu hash pro řádek. Skupiny modulo hodnot hash určují, do kterých vrácených tabulek bude řádek umístěn.
Table.PartitionValues Vrátí informace o rozdělení tabulky.
Table.Range Vrátí zadaný počet řádků z tabulky začínající posunem.
Table.RemoveFirstN Vrátí tabulku se zadaným počtem řádků odebraných z tabulky počínaje prvním řádkem. Počet odebraných řádků závisí na volitelném parametru countOrCondition.
Table.RemoveLastN Vrátí tabulku se zadaným počtem řádků odebraných z tabulky počínaje posledním řádkem. Počet odebraných řádků závisí na volitelném parametru countOrCondition.
Table.RemoveRows Vrátí tabulku se zadaným počtem řádků odebraných z tabulky počínaje posunem.
Table.RemoveRowsWithErrors Vrátí tabulku se všemi řádky odebranými z tabulky, které obsahují chybu v alespoň jedné z buněk v řádku.
Table.Repeat Vrátí tabulku obsahující řádky tabulky, která opakuje počet opakování.
Table.ReplaceRows Vrátí tabulku, kde jsou řádky začínající posunem a pokračování pro počet nahrazeny zadanými řádky.
Table.ReverseRows Vrátí tabulku s řádky v obráceném pořadí.
Table.SelectRows Vrátí tabulku obsahující pouze řádky, které splňují podmínku.
Table.SelectRowsWithErrors Vrátí tabulku pouze s řádky z tabulky, které obsahují chybu v alespoň jedné z buněk v řádku.
Table.SingleRow Vrátí jeden řádek z tabulky.
Table.Skip Vrátí tabulku, která neobsahuje první řádek nebo řádky tabulky.
Table.SplitAt Vrátí seznam obsahující první zadané řádky s počtem a zbývajícími řádky.

Operace se sloupci

Název Popis
Table.Column Vrátí hodnoty ze sloupce v tabulce.
Table.ColumnNames Vrátí názvy sloupců z tabulky.
Table.ColumnsOfType Vrátí seznam s názvy sloupců, které odpovídají zadaným typům.
Table.DemoteHeaders Sníží řádek záhlaví dolů na první řádek tabulky.
Table.DuplicateColumn Duplikuje sloupec se zadaným názvem. Hodnoty a typ se zkopírují ze zdrojového sloupce.
Table.HasColumns Určuje, jestli tabulka obsahuje zadané sloupce.
Table.Pivot Vzhledem k tomu, že sloupec tabulky a atributu obsahující kontingenční hodnoty, vytvoří pro každou z hodnot kontingenční tabulky nové sloupce a přiřadí je z hodnoty valueColumn. Volitelnou agregační funkci lze poskytnout pro zpracování více výskytů stejné hodnoty klíče ve sloupci atributu.
Table.PrefixColumns Vrátí tabulku, ve které jsou všechny sloupce předponou textové hodnoty.
Table.PromoteHeaders Propaguje první řádek tabulky do záhlaví nebo názvů sloupců.
Table.RemoveColumns Vrátí tabulku bez konkrétního sloupce nebo sloupců.
Table.ReorderColumns Vrátí tabulku s konkrétními sloupci v pořadí relativním k sobě.
Table.RenameColumns Vrátí tabulku se sloupci přejmenovanými tak, jak je uvedeno.
Table.SelectColumns Vrátí tabulku, která obsahuje pouze konkrétní sloupce.
Table.TransformColumnNames Transformuje názvy sloupců pomocí dané funkce.
Table.Unpivot V seznamu sloupců tabulky transformuje tyto sloupce na páry atribut-hodnota.
Table.UnpivotOtherColumns Přeloží všechny sloupce kromě zadané sady do párů atribut-hodnota v kombinaci se zbytkem hodnot v každém řádku.

Transformace

Název Popis
Table.AddColumn Přidá sloupec s názvem newColumnName do tabulky.
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 Vrátí tabulku s novým sloupcem s konkrétním názvem, který pro každý řádek obsahuje index řádku v tabulce.
Table.AddJoinColumn Provede vnořené spojení mezi tabulkou1 a tabulkou2 z konkrétních sloupců a vytvoří výsledek spojení jako nový sloupecColumnName pro každý řádek tabulky1.
Table.AddKey Přidá klíč do tabulky.
Table.AggregateTableColumn Agreguje tabulky vnořené do konkrétního sloupce do více sloupců obsahujících agregované hodnoty pro tyto tabulky.
Table.CombineColumns Table.CombineColumns slučuje sloupce pomocí kombinační funkce k vytvoření nového sloupce. Table.CombineColumns je inverzní funkce Table.SplitColumns.
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 Nahradí hodnoty null v zadaném sloupci nebo sloupcích tabulky nejnovější hodnotou, která není null ve sloupci.
Table.FillUp Vrátí tabulku ze zadané tabulky, kde se hodnota další buňky rozšíří do buněk s hodnotami null nad zadaným sloupcem.
Table.FilterWithDataTable Tato funkce je určená pouze pro interní použití.
Table.Group Seskupí řádky tabulky podle hodnot klíčových sloupců pro každý řádek.
Table.Join Spojí řádky tabulky1 s řádky tabulky2 na základě rovnosti hodnot klíčových sloupců vybraných podle tabulky1, klíče1 a tabulky2, klíče2.
Table.Keys Vrátí klíče zadané tabulky.
Table.NestedJoin Spojí řádky tabulek na základě rovnosti klíčů. Výsledky se zadají do nového sloupce.
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í starou hodnotu newValue v konkrétních sloupcích tabulky pomocí poskytnuté funkce nahrazení, jako je například text. Nahradit nebo Value.Replace.
Table.SplitColumn Vrátí novou sadu sloupců z jednoho sloupce, který na každou hodnotu použije rozdělovací funkci.
Table.TransformColumns Transformuje hodnoty jednoho nebo více sloupců.
Table.TransformColumnTypes Transformuje typy sloupců z tabulky pomocí typu.
Table.TransformRows Transformuje řádky z tabulky pomocí transformační funkce.
Table.Transpone Vrátí tabulku se sloupci převedenými na řádky a řádky převedené na sloupce ze vstupní tabulky.

Členství

Název Popis
Table.Contains Určuje, zda se záznam zobrazí jako řádek v tabulce.
Table.ContainsAll Určuje, zda se všechny zadané záznamy zobrazují jako řádky v tabulce.
Table.ContainsAny Určuje, zda se některý ze zadaných záznamů zobrazí jako řádky v tabulce.
Table.Distinct Odebere duplicitní řádky z tabulky a zajistí, aby všechny zbývající řádky byly odlišné.
Table.IsDistinct Určuje, zda tabulka obsahuje pouze jedinečné řádky.
Table.PositionOf Určuje pozici nebo pozice řádku v tabulce.
Table.PositionOfAny Určuje pozici nebo pozice libovolného zadaného řádku v tabulce.
Table.RemoveMatchingRows Odebere všechny výskyty řádků z tabulky.
Table.ReplaceMatchingRows Nahradí konkrétní řádky z tabulky novými řádky.

Řazení

Název Popis
Table.Max Vrátí největší řádek nebo řádky z tabulky pomocí comparisonCriteria.
Table.MaxN Vrátí největší N řádků z tabulky. Po seřazení řádků je nutné zadat parametr countOrCondition pro další filtrování výsledku.
Table.Min Vrátí nejmenší řádek nebo řádky z tabulky pomocí comparisonCriteria.
Table.MinN Vrátí nejmenší N řádků v dané tabulce. Po seřazení řádků je nutné zadat parametr countOrCondition pro další filtrování výsledku.
Table.AddRankColumn Připojí sloupec s pořadím jednoho nebo více dalších sloupců.
Table.Sort Seřadí řádky v tabulce pomocí parametru comparisonCriteria nebo výchozího pořadí, pokud ho nezadáte.

Jiný důvod

Název Popis
Table.Buffer Uloží tabulku do paměti a během vyhodnocení ji izoluje od externích změn.

Hodnoty parametru

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 vytváření tabulek, 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 textu 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 podmínku selže, nebudou se brát 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

Zpracování 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á v operacích sloupců nebo transformací, 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. Předdefinované porovnávací funkce je možné zadat. Další informace: Funkce Compareru

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

Příklady najdete v popisu Table.Distinct.