Čítať v angličtine

Zdieľať cez


Funkcie tabuľky

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

Tvorba tabuliek

Meno Popis
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 Vráti tabuľku zo zoznamu obsahujúceho vnorené zoznamy s názvami stĺpcov a hodnotami.
Table.FromList Konvertuje zoznam na tabuľku použitím zadanej funkcie rozdelenia na každú položku v zozname.
Table.FromRecords Vráti tabuľku zo zoznamu záznamov.
Table.FromRows Vytvorí tabuľku zo zoznamu, v ktorom každý prvok zoznamu je zoznam obsahujúci hodnoty stĺpca pre jeden riadok.
Table.FromValue Vráti tabuľku so stĺpcom obsahujúcim zadanú hodnotu alebo zoznam hodnôt.
Table.FuzzyGroup Zoskupí riadky tabuľky podľa približných zhôd s hodnotami v zadanom stĺpci pre každý riadok.
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.Split Rozdelí zadanú tabuľku na zoznam tabuliek pomocou zadanej veľkosti strany.
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 vyhodí obslužný program definovaný v zobrazení (prostredníctvom funkcie Table.View).
Table.ViewFunction Vytvorí funkciu, do akej môže zasahovať obslužný program definovaný v zobrazení (prostredníctvom funkcie Table.View).

Konverzie

Meno Popis
Table.ToColumns Vráti zoznam vnorených zoznamov, ktoré predstavujú stĺpec hodnôt vo vstupnej tabuľke.
Table.ToList Vráti tabuľku na zoznam použitím zadanej funkcie kombinovania na každý riadok hodnôt v tabuľke.
Table.ToRecords Vráti zoznam záznamov zo vstupnej tabuľky.
Table.ToRows Vráti vnorený zoznam hodnôt riadkov zo vstupnej tabuľky.

Informácie

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 Vráti hodnotu TRUE, ak tabuľka neobsahuje žiadne riadky.
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 (t. j. schému) zadanej tabuľky.
Tables.GetRelationships Vráti vzťahy v rámci množiny tabuliek.

Operácie s riadkom

Meno Popis
Table.AlternateRows Vráti tabuľku obsahujúcu striedavý vzor riadkov z tabuľky.
Table.Combine Vráti tabuľku, ktorá je výsledkom zlúčenia zoznamu tabuliek. Všetky tabuľky musia mať rovnakú štruktúru typu riadka.
Table.FindText Vráti tabuľku obsahujúcu iba riadky, ktoré majú zadaný text v rámci jednej z ich buniek alebo jej ľubovoľnej časti.
Table.First Vráti prvý riadok tabuľky.
Table.FirstN Vráti prvé riadky tabuľky v závislosti od parametra countOrCondition.
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 do nových stĺpcov. Typ stĺpca možno určiť voliteľne, predvolená hodnota je ľubovoľná.
Table.InsertRows Vráti tabuľku so zoznamom riadkov vložených do tabuľky v indexe. Každý riadok, ktorý sa má vložiť, sa musí zhodovať s typom riadka tabuľky..
Table.Last Vráti posledný riadok tabuľky.
Table.LastN Vráti posledné riadky tabuľky v závislosti od parametra countOrCondition.
Table.MatchesAllRows Vráti hodnotu TRUE, ak všetky riadky v tabuľke spĺňajú podmienku.
Table.MatchesAnyRows Vráti hodnotu TRUE, ak niektoré riadky v tabuľke spĺňajú podmienku.
Table.Partition Rozdelí tabuľku na zoznam skupín s počtom tabuliek na základe hodnoty stĺpca každého riadka a funkcie hash. Funkcia hash sa použije na hodnotu stĺpca riadka, aby sa získala hodnota hash pre riadok. Hodnota hash skupiny hodnôt modulo určuje, do ktorej z vrátených tabuliek sa riadok umiestni.
Table.PartitionValues Vráti informácie o spôsobe rozdelenia tabuľky.
Table.Range Vráti zadaný počet riadkov z tabuľky počnúc posunom.
Table.RemoveFirstN Vráti tabuľku so zadaným počtom riadkov odstránených z tabuľky počnúc prvým riadkom. Počet odstránených riadkov závisí od voliteľného parametra countOrCondition.
Table.RemoveLastN Vráti tabuľku so zadaným počtom riadkov odstránených z tabuľky počnúc posledným riadkom. Počet odstránených riadkov závisí od voliteľného parametra countOrCondition.
Table.RemoveRows Vráti tabuľku so zadaným počtom riadkov odstránených z tabuľky počnúc posunom.
Table.RemoveRowsWithErrors Vráti tabuľku, pričom odstráni všetky riadky z tabuľky, ktoré obsahujú chybu aspoň v jednej z buniek v riadku.
Table.Repeat Vráti tabuľku obsahujúcu riadky tabuľky opakovanú počet opakovaní počtu opakovaní počtu.
Table.ReplaceRows Vráti tabuľku, v ktorej sa riadky začínajúc na posune a pokračujúce v počte nahrádzajú zadanými riadkami.
Table.ReverseRows Vráti tabuľku s riadkami v opačnom poradí.
Table.SelectRows Vráti tabuľku obsahujúcu iba riadky, ktoré spĺňajú podmienku.
Table.SelectRowsWithErrors Vráti tabuľku iba s riadkami tabuľky, ktoré obsahujú chybu aspoň v jednej z buniek v riadku.
Table.SingleRow Vráti jeden riadok z tabuľky.
Table.Skip Vráti tabuľku, ktorá neobsahuje prvý riadok alebo riadky tabuľky.
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 hodnoty zo stĺpca v tabuľke.
Table.ColumnNames Vráti názvy stĺpcov z tabuľky.
Table.ColumnsOfType Vráti zoznam s názvami stĺpcov, ktoré zodpovedajú zadaným typom.
Table.DemoteHeaders Zníži počet riadkov hlavičky nadol na prvý riadok tabuľky.
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ĺpce.
Table.Pivot Vzhľadom na stĺpec tabuľky a atribútov obsahujúcich pivotValues sa pre každú z hodnôt kontingenčnej tabuľky vytvoria nové stĺpce a priradia sa im hodnoty z tabuľky valueColumn. S cieľom spracovať viaceré výskyty rovnakej hodnoty kľúča v stĺpci atribútu možno poskytnúť voliteľnú funkciu aggregationFunction.
Table.PrefixColumns Vráti tabuľku, v ktorej budú mať všetky stĺpce textovú hodnotu v rámci predpony.
Table.PromoteHeaders Zvýši úroveň prvého riadka tabuľky na názvy hlavičiek alebo stĺpcov.
Table.RemoveColumns Vráti tabuľku bez konkrétneho stĺpca alebo stĺpcov.
Table.ReorderColumns Vráti tabuľku so špecifickými stĺpcami v poradí, ktoré je navzájom relatívne.
Table.RenameColumns Vráti tabuľku so stĺpcami premenovanými podľa zadania.
Table.SelectColumns Vráti tabuľku, ktorá obsahuje iba konkrétne stĺpce.
Table.TransformColumnNames Transformuje názvy stĺpcov pomocou danej funkcie.
Table.Unpivot Vzhľadom na zoznam stĺpcov tabuľky transformuje tieto stĺpce 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 v kombinácii so zvyškom hodnôt v každom riadku.

Transformácia

Meno Popis
Table.AddColumn Pridá stĺpec s názvom newColumnName do tabuľky.
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 Vráti tabuľku s novým stĺpcom s konkrétnym názvom, ktorý pre každý riadok obsahuje index riadka v tabuľke.
Table.AddJoinColumn Vykoná vnorené spojenie medzi tabuľkami Tabuľka1 a Tabuľka2 zo špecifických stĺpcov a vytvorí výsledok spojenia ako stĺpec newColumnName pre každý riadok tabuľky Table1.
Table.AddKey Pridá kľúč do tabuľky.
Table.AggregateTableColumn Agregačné tabuľky sú vnorené v konkrétnom stĺpci do viacerých stĺpcov obsahujúcich agregované hodnoty pre tieto tabuľky.
Table.CombineColumns Table.CombineColumns zlučuje stĺpce pomocou funkcie kombinovania na vytvorenie nového stĺpca. Table.CombineColumns je inverzná hodnota pre Table.SplitColumns.
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 Nahradí hodnoty null v zadanom stĺpci alebo stĺpcoch tabuľky najnovšou hodnotou bez hodnoty null v stĺpci.
Table.FillUp Vráti tabuľku zo zadanej časti tabuľky, kde sa hodnota nasledujúcej bunky rozšíri do buniek s hodnotou null vyššie v zadanom stĺpci.
Table.FilterWithDataTable Táto funkcia je určená len na interné použitie.
Table.Group Zoskupí riadky tabuľky podľa hodnôt kľúčových stĺpcov pre každý riadok.
Table.Join Spojí riadky tabuľky1 s riadkami tabuľky2 na základe rovnosti hodnôt kľúčových stĺpcov vybratých podľa kľúča1 (pre tabuľku1) a kľúča2 (pre tabuľku2).
Table.Keys Vráti kľúče zadanej tabuľky.
Table.NestedJoin Spojí riadky tabuliek na základe rovnosti kľúčov. Výsledky sa vdajú do nového stĺpca.
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í hodnotu oldValue hodnotou newValue v konkrétnych stĺpcoch tabuľky pomocou zadanej funkcie nahrádzača, ako je napríklad text. Nahraďte alebo Value.Replace.
Table.SplitColumn Vráti novú množinu stĺpcov z jedného stĺpca s použitím funkcie rozdelenia na každú hodnotu.
Table.TransformColumns Transformuje hodnoty jedného alebo viacerých stĺpcov.
Table.TransformColumnTypes Transformuje typy stĺpcov z tabuľky pomocou typu.
Table.TransformRows Transformuje riadky z tabuľky pomocou funkcie transformácie.
Table.Transpose Vráti tabuľku so stĺpcami skonvertovanými na riadky a riadkami skonvertovanými na stĺpce zo vstupnej tabuľky.

Členstvo

Meno Popis
Table.Contains Určí, či sa záznam zobrazí ako riadok v tabuľke.
Table.ContainsAll Určí, či sa všetky zadané záznamy zobrazujú ako riadky v tabuľke.
Table.ContainsAny Určí, či sa nejaké zo zadaných záznamov zobrazujú ako riadky v tabuľke.
Table.Distinct Odstráni duplicitné riadky z tabuľky a zabezpečí, aby boli všetky zostávajúce riadky odlišné.
Table.IsDistinct Určuje, či tabuľka obsahuje iba rozdielne riadky.
Table.PositionOf Určí pozíciu alebo pozície riadka v rámci tabuľky.
Table.PositionOfAny Určí pozíciu alebo pozície niektorého zo zadaných riadkov v rámci tabuľky.
Table.RemoveMatchingRows Odstráni všetky výskyty riadkov z tabuľky.
Table.ReplaceMatchingRows Nahradí konkrétne riadky z tabuľky novými riadkami.

Objednávanie

Meno Popis
Table.Max Vráti najväčší riadok alebo riadky z tabuľky pomocou parametra comparisonCriteria.
Table.MaxN Vráti N najväčších riadkov z tabuľky. Po zoradení riadkov musí byť určený parameter countOrCondition na ďalšie filtrovanie výsledku.
Table.Min Vráti najmenší riadok alebo riadky z tabuľky pomocou parametra comparisonCriteria.
Table.MinN Vráti N najmenších riadkov v danej tabuľke. Po zoradení riadkov musí byť určený parameter countOrCondition na ďalšie filtrovanie výsledku.
Table.AddRankColumn Pripojí stĺpec k poradiu jedného alebo viacerých ďalších stĺpcov.
Table.Sort Zoradí riadky v tabuľke pomocou príkazu comparisonCriteria alebo predvoleného zoradenia, ak jedna z možností nie je zadaná.

Other

Meno Popis
Table.Buffer Uloží tabuľku do medzipamäte, pričom ju izoluje od externých zmien počas hodnotenia.

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 sú 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. Funkciu Value.Compare možno použiť na delegovanie tejto logiky.

Príklady nájdete v popise funkcie 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 a 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 tabuľke 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 funkcie Table.Distinct.