Funkcie tabuľky

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

Konštrukcia stola

Name	Description
#table	Vytvorí hodnotu tabuľky zo stĺpcov a riadkov.
ItemExpression.From	Vráti abstraktný strom syntaxe (AST) pre telo funkcie.
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.
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 vyvolá obslužný program definovaný v zobrazení (cez Table.View).
Table.ViewFunction	Vytvorí funkciu, do akej môže zasahovať obslužný program definovaný v zobrazení (prostredníctvom Table.View).

Conversions

Name	Description
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.

Information

Name	Description
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 riadkov

Name	Description
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

Name	Description
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.

Transformation

Name	Description
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.PartitionKľúč	Vráti kľúč oblasti zadanej tabuľky.
Table.ReplaceErrorValues	Nahradí chybové hodnoty v zadaných stĺpcoch zodpovedajúcou zadanou hodnotou.
Table.ReplaceKeys	Nahradí kľúče zadanej tabuľky.
Tabuľka.NahradiťPartitionKey	Nahradí kľúč oblasti 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ĺpec 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.

Membership

Name	Description
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.

Ordering

Name	Description
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.

Other

Name	Description
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: Poradie 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ávania

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

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