Zdieľať cez

Funkcie tabuľky

  • Článok

Tieto funkcie umožňujú vytvoriť a upraviť hodnoty tabuliek.

Tvorba tabuliek

Meno Popis
#table Vytvorí hodnotu tabuľky zo stĺpcov a riadkov.
ItemExpression.From Vráti abstraktný strom syntaxe (AST) pre telo funkcie.
ItemExpression.Item Abstraktný uzol syntaxe stromu (AST) predstavujúci položku vo výraze položky.
RowExpression.Column Vráti abstraktný strom syntaxe (AST), ktorý predstavuje prístup k stĺpcu vo výraze riadka.
RowExpression.From Vráti abstraktný strom syntaxe (AST) pre telo funkcie.
RowExpression.Row Abstraktný uzol syntaxe stromu (AST) predstavujúci riadok vo výraze riadka.
Table.FromColumns Vytvorí tabuľku zo zoznamu stĺpcov a zadaných hodnôt.
Table.FromList Konvertuje zoznam na tabuľku použitím zadanej funkcie rozdelenia na každú položku v zozname.
Table.FromRecords Konvertuje zoznam záznamov na tabuľku.
Table.FromRows Vytvorí tabuľku zo zoznamu hodnôt riadkov a voliteľných stĺpcov.
Table.FromValue Vytvorí tabuľku so stĺpcom z uvedenej hodnoty alebo hodnôt.
Table.WithErrorContext Táto funkcia je určená len na interné použitie.
Table.View Vytvorí alebo rozšíri tabuľku s obslužnými programami definovanými používateľom pre operácie dotazu a akcií.
Table.ViewError Vytvorí upravený záznam chyby, ktorý nespustí záložný , keď ho vhodí obslužný program definovaný v zobrazení (prostredníctvom Table.View).
Table.ViewFunction Vytvorí funkciu, do akej môže zasahovať obslužný program definovaný v zobrazení (prostredníctvom Table.View).

Konverzie

Meno Popis
Table.ToColumns Vytvorí zoznam vnorených zoznamov hodnôt stĺpcov z tabuľky.
Table.ToList Konvertuje tabuľku na zoznam použitím zadanej funkcie kombinovania na každý riadok hodnôt v tabuľke.
Table.ToRecords Konvertuje tabuľku na zoznam záznamov.
Table.ToRows Vytvorí zoznam vnorených zoznamov hodnôt riadkov z tabuľky.

Informácia

Meno Popis
Table.ApproximateRowCount Vráti približný počet riadkov v tabuľke.
Table.ColumnCount Vráti počet stĺpcov v tabuľke.
Table.IsEmpty Udáva, či tabuľka obsahuje nejaké riadky.
Table.PartitionValues Vráti informácie o spôsobe rozdelenia tabuľky.
Table.Profile Vráti profil stĺpcov tabuľky.
Table.RowCount Vráti počet riadkov v tabuľke.
Table.Schema Vráti tabuľku obsahujúcu popis stĺpcov (čiže schému) zadanej tabuľky.
Tables.GetRelationships Načíta vzťahy v rámci množiny tabuliek.

Operácie s riadkom

Meno Popis
Table.AlternateRows Zachovať počiatočný posun, potom striedavo brať a vynecháva nasledujúce riadky.
Table.Combine Vráti tabuľku, ktorá je výsledkom zlúčenia zoznamu tabuliek.
Table.FindText Vráti všetky riadky, ktoré obsahujú daný text v tabuľke.
Table.First Vráti prvý riadok alebo zadanú predvolenú hodnotu.
Table.FirstN Vráti zadaný počet prvých riadkov.
Table.FirstValue Vráti prvý stĺpec prvého riadka tabuľky alebo zadanú predvolenú hodnotu.
Table.FromPartitions Vráti tabuľku, ktorá je výsledkom kombinácie množiny rozdelených tabuliek.
Table.InsertRows Vloží zoznam riadkov do tabuľky na zadanej pozícii.
Table.Last Vráti posledný riadok alebo zadanú predvolenú hodnotu.
Table.LastN Vráti posledný zadaný počet riadkov.
Table.MatchesAllRows Udáva, či všetky riadky v tabuľke spĺňajú danú podmienku.
Table.MatchesAnyRows Udáva, či niektoré riadky v tabuľke spĺňajú danú podmienku.
Table.Partition Rozdelí tabuľku na zoznam tabuliek na základe počtu skupín a zadaného stĺpca.
Table.Range Vráti riadky začínajúc na zadanom posune.
Table.RemoveFirstN Vráti tabuľku so zadaným počtom riadkov odstránených z tabuľky počnúc prvým riadkom.
Table.RemoveLastN Vráti tabuľku so zadaným počtom riadkov odstránených z tabuľky počnúc posledným riadkom.
Table.RemoveRows Odstráni zadaný počet riadkov.
Table.RemoveRowsWithErrors Vráti tabuľku s odstránenými riadkami zo vstupnej tabuľky, ktoré obsahujú chybu aspoň v jednej z buniek. Ak je zadaný zoznam stĺpcov, chyby sa kontrolujú iba v bunkách v zadaných stĺpcoch.
Table.Repeat Zopakuje riadky tabuliek zadaný počet ráz.
Table.ReplaceRows Nahradí zadaný rozsah riadkov zadaným riadkom alebo riadkami.
Table.ReverseRows Vráti tabuľku s riadkami v opačnom poradí.
Table.SelectRows Vyberie riadky, ktoré spĺňajú funkciu podmienky.
Table.SelectRowsWithErrors Vráti tabuľku iba s tými riadkami vstupnej tabuľky, ktoré obsahujú chybu aspoň v jednej z buniek. Ak je zadaný zoznam stĺpcov, chyby sa kontrolujú iba v bunkách v zadaných stĺpcoch.
Table.SingleRow Vráti jeden riadok v tabuľke.
Table.Skip Vráti tabuľku s prvým zadaným počtom vynechaných riadkov.
Table.SplitAt Vráti zoznam obsahujúci prvý zadaný počet riadkov a zostávajúce riadky.

Operácie stĺpcov

Meno Popis
Table.Column Vráti zadaný stĺpec údajov z tabuľky ako zoznam.
Table.ColumnNames Vráti názvy stĺpcov ako zoznam.
Table.ColumnsOfType Vráti zoznam s názvami stĺpcov, ktoré zodpovedajú zadaným typom.
Table.DemoteHeaders Zníži úrovne hlavičiek stĺpcov na prvý riadok hodnôt.
Table.DuplicateColumn Skopíruje stĺpec so zadaným názvom. Hodnoty a typ sa skopírujú zo zdrojového stĺpca.
Table.HasColumns Udáva, či tabuľka obsahuje zadaný stĺpec alebo stĺpce.
Table.Pivot Ak je zadaný pár stĺpcov predstavujúcich páry atribút – hodnota, otočí údaje v stĺpci atribútu do hlavičiek stĺpcov.
Table.PrefixColumns Vráti tabuľku, v ktorej budú mať všetky stĺpce daný text v rámci predpony.
Table.PromoteHeaders Zvýši úroveň prvého riadka hodnôt na nové hlavičky stĺpcov (čiže ako názvy stĺpcov).
Table.RemoveColumns Odstráni zadané stĺpce.
Table.ReorderColumns Vráti tabuľku so stĺpcami v zadanom poradí.
Table.RenameColumns Vráti tabuľku so stĺpcami premenovanými podľa zadania.
Table.SelectColumns Vráti tabuľku iba so zadanými stĺpcami.
Table.TransformColumnNames Transformuje názvy stĺpcov pomocou danej funkcie.
Table.Unpivot Preloží množinu stĺpcov v tabuľke na páry atribút – hodnota.
Table.UnpivotOtherColumns Preloží všetky stĺpce iné ako zo zadanej množiny na páry atribút – hodnota.

Zmena

Meno Popis
Table.AddColumn Pridá stĺpec so zadaným názvom. Hodnota sa vypočíta pomocou zadanej funkcie výberu, pričom každý riadok sa použije ako vstup.
Table.AddFuzzyClusterColumn Pridá nový stĺpec s reprezentatívnymi hodnotami získanými hodnotami fuzzy zoskupenia zadaného stĺpca v tabuľke.
Table.AddIndexColumn Pripojí stĺpec s explicitnými hodnotami pozície.
Table.AddJoinColumn Vykoná spojenie medzi tabuľkami na zadaných stĺpcoch a vytvorí výsledok spojenia v novom stĺpci.
Table.AddKey Pridá kľúč do tabuľky.
Table.AggregateTableColumn Agreguje stĺpec tabuliek do viacerých stĺpcov v tabuľke, ktorá obsahuje.
Table.CombineColumns Kombinuje zadané stĺpce do nového stĺpca pomocou zadanej funkcie kombinovania.
Table.CombineColumnsToRecord Kombinuje zadané stĺpce do nového stĺpca s hodnotou záznamu, v ktorom má každý záznam názvy polí a hodnoty zodpovedajúce názvom stĺpcov a hodnotám stĺpcov, ktoré boli skombinované.
Table.ConformToPageReader Táto funkcia je určená len na interné použitie.
Table.ExpandListColumn Vzhľadom na stĺpec zoznamov v tabuľke vytvorte kópiu riadka pre každú hodnotu v jeho zozname.
Table.ExpandRecordColumn Rozbalí stĺpec záznamov na stĺpce s každou z hodnôt.
Table.ExpandTableColumn Rozbalí stĺpec záznamov alebo stĺpec tabuliek do viacerých stĺpcov v tabuľke, ktorá obsahuje.
Table.FillDown Rozšíri hodnotu predchádzajúcej bunky do buniek s hodnotou null nižšie v stĺpci.
Table.FillUp Rozšíri hodnotu bunky do buniek s hodnotou null vyššie v stĺpci.
Table.FilterWithDataTable Táto funkcia je určená len na interné použitie.
Table.FuzzyGroup Zoskupí riadky v tabuľke na základe približnej zhody kľúčov.
Table.FuzzyJoin Spojí riadky z dvoch tabuliek, ktoré sa približne zhodujú na základe daných kľúčov.
Table.FuzzyNestedJoin Vykoná približné spojenie medzi tabuľkami na zadaných stĺpcoch a vytvorí výsledok spojenia v novom stĺpci.
Table.Group Zoskupí riadky v tabuľke, ktoré majú rovnaký kľúč.
Table.Join Spojí riadky z dvoch tabuliek, ktoré sa zhodujú na základe daných kľúčov.
Table.Keys Vráti kľúče zadanej tabuľky.
Table.NestedJoin Vykoná spojenie medzi tabuľkami na zadaných stĺpcoch a vytvorí výsledok spojenia v novom stĺpci.
Table.ReplaceErrorValues Nahradí chybové hodnoty v zadaných stĺpcoch zodpovedajúcou zadanou hodnotou.
Table.ReplaceKeys Nahradí kľúče zadanej tabuľky.
Table.ReplaceRelationshipIdentity Táto funkcia je určená len na interné použitie.
Table.ReplaceValue Nahradí jednu hodnotu inou v zadaných stĺpcoch.
Table.Split Rozdelí zadanú tabuľku na zoznam tabuliek pomocou zadanej veľkosti strany.
Table.SplitColumn Rozdelí zadané stĺpce na množinu ďalších stĺpcov pomocou zadanej funkcie rozdelenia.
Table.TransformColumns Transformuje hodnoty jedného alebo viacerých stĺpcov.
Table.TransformColumnTypes Použije transformácie typu formulára { stĺpec, typ } pomocou konkrétnej jazykovej verzie.
Table.TransformRows Transformuje riadky tabuľky pomocou zadanej funkcie transformácie.
Table.Transpose Zo stĺpcov urobí riadky a z riadkov urobí stĺpce.

Členstvo

Meno Popis
Table.Contains Udáva, či sa zadaný záznam zobrazí ako riadok v tabuľke.
Table.ContainsAll Udáva, či sa všetky zadané záznamy zobrazujú ako riadky v tabuľke.
Table.ContainsAny Udáva, či sa nejaké zo zadaných záznamov zobrazujú ako riadky v tabuľke.
Table.Distinct Odstráni duplicitné riadky z tabuľky.
Table.IsDistinct Udáva, či tabuľka obsahuje iba rozdielne riadky (bez duplikátov).
Table.PositionOf Vráti pozíciu alebo pozície riadka v rámci tabuľky.
Table.PositionOfAny Vráti pozíciu alebo pozície niektorého zo zadaných riadkov v rámci tabuľky.
Table.RemoveMatchingRows Odstráni všetky výskyty zadaných riadkov z tabuľky.
Table.ReplaceMatchingRows Nahradí všetky zadané riadky zadaným riadkom alebo riadkami.

Objednávanie

Meno Popis
Table.AddRankColumn Pripojí stĺpec k poradiu jedného alebo viacerých ďalších stĺpcov.
Table.Max Vráti najväčšiu alebo predvolenú hodnotu riadka podľa daných kritérií.
Table.MaxN Vráti najväčší riadok alebo riadky podľa daných kritérií.
Table.Min Vráti najmenší riadok alebo predvolenú hodnotu podľa daných kritérií.
Table.MinN Vráti najmenší riadok alebo riadky podľa daných kritérií.
Table.Sort Zoradí tabuľku pomocou jedného alebo viacerých názvov stĺpcov a kritérií porovnania.

Iný

Meno Popis
Table.Buffer Uloží tabuľku do medzipamäte, pričom ju izoluje od externých zmien počas hodnotenia.
Table.StopFolding Zabraňuje spusteniu akýchkoľvek následných operácií s pôvodným zdrojom údajov.

Hodnoty parametrov

Pomenovanie výstupných stĺpcov

Tento parameter je zoznam textových hodnôt určujúcich názvy stĺpcov výslednej tabuľky. Tento parameter sa vo všeobecnosti používa v konštrukčných funkciách tabuliek, ako napríklad Table.FromRows a Table.FromList.

Kritériá porovnania

Kritérium porovnania možno zadať ako jednu z nasledujúcich hodnôt:

  • Číselná hodnota na zadanie poradia zoradenia. Ďalšie informácie: Spôsob zoradenia

  • Ak chcete vypočítať kľúč, ktorý sa má použiť na zoradenie, možno použiť funkciu jedného argumentu.

  • Ak chcete vybrať kľúč aj ovládať poradie, kritériom porovnania môže byť zoznam obsahujúci kľúč a poradie.

  • Ak chcete úplne ovládať porovnanie, môžete použiť funkciu dvoch argumentov, ktoré vrátia hodnotu -1, 0 alebo 1 vzhľadom na vzťah medzi ľavým a pravým vstupom. Value.Compare môžete použiť na delegovanie tejto logiky.

Príklady nájdete v popise Table.Sort.

Kritériá počtu alebo podmienky

Tieto kritériá sa vo všeobecnosti používajú v rámci operácií zoradenia alebo riadkov. Určuje počet riadkov vrátených v tabuľke a môže mať dve formy, číslo alebo podmienku.

  • Číslo udáva, koľko hodnôt sa vráti v rámci riadkov s príslušnou funkciou.

  • Ak je zadaná podmienka, vrátia sa riadky obsahujúce hodnoty, ktoré na začiatku spĺňajú podmienku. Keď hodnota nespĺňa podmienku, žiadne ďalšie hodnoty sa už neberajú do úvahy.

Ďalšie informácie: Table.FirstN, Table.MaxN

Manipulácia s ďalšími hodnotami

Extra hodnoty sa používajú na označenie toho, ako by funkcia mala spracovať ďalšie hodnoty v riadku. Tento parameter je zadaný ako číslo, ktoré mapuje na nasledujúce možnosti:

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

Ďalšie informácie: Table.FromList, ExtraValues.Type

Spracovanie chýbajúceho stĺpca

Tento parameter sa používa na označenie toho, ako by funkcia mala spracovať chýbajúce stĺpce. Tento parameter je zadaný ako číslo, ktoré mapuje na nasledujúce možnosti:

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

Tento parameter sa používa v operáciách stĺpca alebo transformácie, napríklad v Table.TransformColumns. Ďalšie informácie: MissingField.Type

Zoradenia

Na označenie spôsobu zoradenia výsledkov sa používa zoradenie. Tento parameter je zadaný ako číslo, ktoré mapuje na nasledujúce možnosti:

Order.Ascending = 0
Order.Descending = 1

Ďalšie informácie: Order.Type

Kritériá rovnice

Kritériá rovnice pre tabuľky možno zadať napríklad takto:

  • Hodnota funkcie, ktorá je buď:

    • Selektor kľúča, ktorý určuje stĺpec v tabuľke na použitie kritérií rovnosti.

    • Funkcia porovnávača, ktorá sa používa na určenie druhu porovnania, ktorý sa má použiť. Môžete zadať vstavané funkcie porovnávača. Ďalšie informácie: funkcie porovnávača

  • Zoznam stĺpcov v tabuľke na použitie kritérií rovnosti.

Príklady nájdete v popise Table.Distinct.