Táblafüggvények

Ezek a függvények táblaértékeket hoznak létre és kezelnek.

Táblaszerkezet

Name	Leírás
ItemExpression.From	Egy függvény törzsének absztrakt szintaxisfáját (AST) adja vissza.
ItemExpression.Item	Egy elemkifejezésben szereplő elemet képviselő absztrakt szintaxisfacsomópont (AST).
RowExpression.Column	Egy absztrakt szintaxisfát (AST) ad vissza, amely egy sorkifejezésen belüli oszlophoz való hozzáférést jelöli.
RowExpression.From	Egy függvény törzsének absztrakt szintaxisfáját (AST) adja vissza.
RowExpression.Row	Egy sorkifejezés sorát képviselő absztrakt szintaxisfacsomópont (AST).
Table.FromColumns	Egy táblázatot ad vissza egy olyan listából, amely beágyazott listákat tartalmaz az oszlopnevekkel és értékekkel.
Table.FromList	Egy listát táblázattá alakít úgy, hogy a megadott felosztási függvényt alkalmazza a lista minden elemére.
Table.FromRecords	Egy táblát ad vissza a rekordok listájából.
Table.FromRows	Létrehoz egy táblát a listából, amelyben a lista minden eleme egy olyan lista, amely egyetlen sor oszlopértékeit tartalmazza.
Table.FromValue	A megadott értéket vagy értéklistát tartalmazó oszlopot tartalmazó táblát ad vissza.
Table.FuzzyGroup	A táblázat sorait az egyes sorokhoz megadott oszlopban lévő, rejtélyesen egyező értékek szerint csoportosítja.
Table.FuzzyJoin	Összekapcsolja a két tábla sorait, amelyek a megadott kulcsok alapján egyeznek.
Table.FuzzyNestedJoin	Homályos illesztés végrehajtása a megadott oszlopok táblái között, és új oszlopban hozza létre az illesztés eredményét.
Table.Split	A megadott táblázatot felosztja egy táblázatlistára a megadott oldalméret használatával.
Table.WithErrorContext	Ez a függvény csak belső használatra készült.
Table.View	Létrehoz vagy kibővít egy táblát a lekérdezési és műveletműveletek felhasználó által definiált kezelőivel.
Table.ViewError	Létrehoz egy módosított hibarekordot, amely nem vált ki tartalékot, amikor egy nézeten definiált kezelő dobja (a Table.View segítségével).
Table.ViewFunction	Olyan függvényt hoz létre, amelyet egy nézeten definiált kezelő (a Table.View segítségével) foghat el.

Konverziók

Name	Leírás
Table.ToColumns	A beágyazott listák listáját adja vissza, amelyek mindegyike a bemeneti tábla értékeinek oszlopát jelöli.
Table.ToList	Egy táblát ad vissza egy listába úgy, hogy a megadott egyesítési függvényt alkalmazza a tábla minden egyes értéksorára.
Table.ToRecords	Egy bemeneti tábla rekordlistáját adja vissza.
Table.ToRows	Egy bemeneti tábla sorértékeinek beágyazott listáját adja vissza.

Tájékoztatás

Name	Leírás
Table.ApproximateRowCount	A tábla sorainak hozzávetőleges számát adja vissza.
Table.ColumnCount	A tábla oszlopainak számát adja vissza.
Table.IsEmpty	Igaz értéket ad vissza, ha a tábla nem tartalmaz sorokat.
Table.Profile	Egy tábla oszlopainak profilját adja vissza.
Table.RowCount	Egy tábla sorainak számát adja vissza.
Table.Schema	Egy táblát ad vissza, amely a megadott tábla oszlopainak (azaz sémájának) leírását tartalmazza.
Tables.GetRelationships	A táblák egy halmaza közötti kapcsolatokat adja vissza.

Sorműveletek

Name	Leírás
Table.AlternateRows	Egy táblázat sorainak váltakozó mintáját tartalmazó táblát ad vissza.
Table.Combine	Egy táblázatot ad vissza, amely a táblák listájának egyesítésének eredménye. A tábláknak azonos sortípusú szerkezettel kell rendelkezniük.
Table.FindText	Olyan táblázatot ad vissza, amely csak azokat a sorokat tartalmazza, amelyek a megadott szöveget az egyik cellában vagy annak bármely részén belül tartalmazzák.
Table.First	Egy tábla első sorát adja vissza.
Table.FirstN	Egy tábla első sorát adja vissza a countOrCondition paramétertől függően.
Table.FirstValue	A tábla első sorának első oszlopát vagy egy megadott alapértelmezett értéket adja vissza.
Table.FromPartitions	Olyan táblát ad vissza, amely a particionált táblák egy készletének új oszlopokba való kombinálásának eredménye. Az oszlop típusa opcionálisan megadható, az alapértelmezett érték bármelyik.
Table.InsertRows	Egy táblázatot ad vissza, amely az index táblájába beszúrt sorok listáját tartalmazza. Minden beszúrandó sornak meg kell egyeznie a táblázat sortípusával.
Table.Last	Egy tábla utolsó sorát adja vissza.
Table.LastN	Egy tábla utolsó sorát adja vissza a countOrCondition paramétertől függően.
Table.MatchesAllRows	Igaz értéket ad vissza, ha egy tábla összes sora megfelel egy feltételnek.
Table.MatchesAnyRows	Igaz értéket ad vissza, ha a tábla bármelyik sora megfelel egy feltételnek.
Table.Partition	A táblázatot az egyes sorok oszlopának és egy kivonatfüggvénynek az értéke alapján particionálja a táblák csoportszámának listájára. A kivonatfüggvény a sor oszlopának értékére lesz alkalmazva a sor kivonatértékének lekéréséhez. A kivonatértékmodulo-csoportok határozzák meg, hogy a visszaadott táblák közül melyik sor legyen elhelyezve.
Table.PartitionValues	A táblák particionálásának módját adja vissza.
Table.Range	Egy táblázat adott számú sorát adja vissza eltoláskor kezdődően.
Table.RemoveFirstN	Egy táblát ad vissza, amely az első sortól kezdődően eltávolítja a táblából a megadott számú sort. Az eltávolított sorok száma az opcionális countOrCondition paramétertől függ.
Table.RemoveLastN	Olyan táblát ad vissza, amely az utolsó sortól kezdődően eltávolítja a táblából a megadott számú sort. Az eltávolított sorok száma az opcionális countOrCondition paramétertől függ.
Table.RemoveRows	Egy táblázatot ad vissza, amely a megadott számú sort eltávolítja a táblából egy eltoláskor kezdődően.
Table.RemoveRowsWithErrors	Olyan táblázatot ad vissza, amely eltávolítja a táblából azokat a sorokat, amelyek egy sor legalább egyik cellájának hibáját tartalmazzák.
Table.Repeat	A tábla sorait tartalmazó táblát ad vissza, amely többször ismétlődik.
Table.ReplaceRows	Olyan táblázatot ad vissza, amelyben az eltoláskor kezdődő és a darabszámmal folytatódó sorokat a megadott sorok helyettesítik.
Table.ReverseRows	Egy táblázatot ad vissza, amelynek sorai fordított sorrendben állnak.
Table.SelectRows	Olyan táblát ad vissza, amely csak a feltételnek megfelelő sorokat tartalmazza.
Table.SelectRowsWithErrors	Olyan táblázatot ad vissza, amely csak a táblázat azon sorait tartalmazza, amelyek egy sor legalább egyik cellában hibát tartalmaznak.
Table.SingleRow	Egyetlen sort ad vissza egy táblából.
Table.Skip	Olyan táblát ad vissza, amely nem tartalmazza a tábla első sorát vagy sorait.
Table.SplitAt	Egy listát ad vissza, amely tartalmazza a megadott első darabsorokat és a többi sort.

Oszlopműveletek

Name	Leírás
Table.Column	Egy tábla egyik oszlopának értékeit adja vissza.
Table.ColumnNames	Egy tábla oszlopainak nevét adja vissza.
Table.ColumnsOfType	A megadott típusoknak megfelelő oszlopok nevét tartalmazó listát ad vissza.
Table.DemoteHeaders	A fejlécsort lefokozza a táblázat első sorába.
Table.DuplicateColumn	Duplikál egy oszlopot a megadott névvel. Az értékek és a típus a forrásoszlopból lesznek átmásolva.
Table.HasColumns	Azt jelzi, hogy a tábla tartalmazza-e a megadott oszlop(ok)t.
Table.Pivot	A kimutatásÉrtékeket tartalmazó táblázat és attribútum oszlop alapján minden egyes kimutatásértékhez új oszlopokat hoz létre, és azokat a ValueColumn értékből rendeli hozzá. Opcionális aggregationFunction is megadható, amely kezeli ugyanazon kulcsérték többszörös előfordulását az attribútumoszlopban.
Table.PrefixColumns	Olyan táblázatot ad vissza, amelyben az oszlopok mindegyike előtaggal rendelkezik egy szöveges értékkel.
Table.PromoteHeaders	A táblázat első sorát előlépteti az élőfej vagy oszlopnevek közé.
Table.RemoveColumns	Adott oszlop vagy oszlop nélküli táblát ad vissza.
Table.ReorderColumns	Egy olyan táblát ad vissza, amelynek adott oszlopai egymáshoz viszonyított sorrendben láthatók.
Table.RenameColumns	A megadott módon átnevezett oszlopokat tartalmazó táblát ad vissza.
Table.SelectColumns	Olyan táblát ad vissza, amely csak adott oszlopokat tartalmaz.
Table.TransformColumnNames	Az oszlopneveket a megadott függvény használatával alakítja át.
Table.Unpivot	A táblázatoszlopok listája alapján ezeket az oszlopokat attribútum-érték párokká alakítja át.
Table.UnpivotOtOtherColumns	A megadott készleten kívüli összes oszlopot attribútum-érték párokká fordítja le, az egyes sorok többi értékével kombinálva.

Átalakítás

Name	Leírás
Table.AddColumn	ÚjColumnName nevű oszlopot ad hozzá egy táblához.
Table.AddFuzzyClusterColumn	Új oszlopot ad hozzá a tábla megadott oszlopának fuzzy csoportosítási értékeiből kapott reprezentatív értékekkel.
Table.AddIndexColumn	Egy új oszlopot tartalmazó táblát ad vissza egy adott névvel, amely minden sorhoz a tábla sorának indexét tartalmazza.
Table.AddJoinColumn	Beágyazott illesztés végrehajtása a tábla1 és a tábla2 között adott oszlopokból, és az illesztés eredményét egy újColumnName oszlopként állítja elő az 1. táblázat minden sorához.
Table.AddKey	Hozzáad egy kulcsot a táblához.
Table.AggregateTableColumn	Az adott oszlopban beágyazott táblákat több oszlopba összesíti, amelyek összesítő értékeket tartalmaznak az adott táblákhoz.
Table.CombineColumns	A Table.CombineColumns összevonja az oszlopokat egy összevonási függvénnyel egy új oszlop létrehozásához. A Table.CombineColumns a Table.SplitColumns inverze.
Table.CombineColumnsToRecord	A megadott oszlopokat egy új rekordértékű oszlopba egyesíti, amelyben minden rekord mezőnevekkel és értékekkel rendelkezik, amelyek az egyesített oszlopok oszlopneveinek és értékeinek felelnek meg.
Table.ConformToPageReader	Ez a függvény csak belső használatra készült.
Table.ExpandListColumn	Ha egy táblában egy listaoszlopot tartalmaz, hozzon létre egy sor másolatát a lista minden egyes értékéhez.
Table.ExpandRecordColumn	A rekordok oszlopait az egyes értékekkel rendelkező oszlopokra bontja.
Table.ExpandTableColumn	Egy rekordoszlopot vagy egy táblaoszlopot több oszlopra bont a benne lévő táblában.
Table.FillDown	A tábla megadott oszlopában vagy oszlopában lévő null értékeket az oszlop legutóbbi nem null értékére cseréli.
Table.FillUp	Egy táblát ad vissza a megadott táblából, ahol a következő cella értékét propagálja a megadott oszlopban lévő null értékű cellákba.
Table.FilterWithDataTable	Ez a függvény csak belső használatra készült.
Table.Group	Táblázatsorok csoportosítása az egyes sorokhoz tartozó kulcsoszlopok értékei alapján.
Table.Join	Összekapcsolja a táblázat1 sorait a tábla2 soraival az 1. táblázat, a kulcs1 és a tábla2, kulcs2 által kiválasztott kulcsoszlopok értékeinek egyenlősége alapján.
Table.Keys	A megadott tábla kulcsait adja vissza.
Table.NestedJoin	A táblák sorait a kulcsok egyenlősége alapján illeszti össze. Az eredmények új oszlopba kerülnek.
Table.ReplaceErrorValues	A megadott oszlopokban lévő hibaértékeket a megfelelő megadott értékre cseréli.
Table.ReplaceKeys	Lecseréli a megadott tábla kulcsait.
Table.ReplaceRelationshipIdentity	Ez a függvény csak belső használatra készült.
Table.ReplaceValue	Az oldValue helyére a tábla adott oszlopaiban lévő newValue értéket írja be a megadott cserefüggvény( például szöveg) használatával. Csere vagy Érték.Csere.
Table.SplitColumn	Egy oszlopból származó új oszlopkészletet ad vissza, amely minden értékre alkalmaz egy elválasztófüggvényt.
Table.TransformColumns	Egy vagy több oszlop értékeinek átalakítása.
Table.TransformColumnTypes	Az oszloptípusokat egy táblázatból alakítja át egy típus használatával.
Table.TransformRows	Átalakítja a táblázat sorait egy átalakítási függvény használatával.
Table.Transzponálás	Olyan táblázatot ad vissza, amely sorokat és sorokat alakít át a bemeneti tábla oszlopaivá.

Tagság

Name	Leírás
Table.Contains	Meghatározza, hogy a rekord sorként jelenik-e meg a táblában.
Table.ContainsAll	Meghatározza, hogy az összes megadott rekord sorként jelenik-e meg a táblában.
Table.ContainsAny	Meghatározza, hogy a megadott rekordok bármelyike sorokként jelenjen-e meg a táblában.
Table.Distinct	Eltávolítja az ismétlődő sorokat egy táblából, biztosítva, hogy az összes többi sor külön legyen.
Table.IsDistinct	Meghatározza, hogy egy tábla csak különálló sorokat tartalmaz-e.
Table.PositionOf	A táblázaton belüli sorok pozícióját vagy pozícióit határozza meg.
Table.PositionOfAny	Meghatározza a tábla bármely megadott sorának pozícióját vagy pozícióját.
Table.RemoveMatchingRows	Eltávolítja a sorok összes előfordulását egy táblából.
Table.ReplaceMatchingRows	A táblázat adott sorait lecseréli az új sorokra.

Rendezés

Name	Leírás
Table.Max	Egy tábla legnagyobb sorát vagy sorait adja vissza egy comparisonCriteria használatával.
Table.MaxN	Egy tábla legnagyobb N sorait adja vissza. A sorok rendezése után meg kell adni a countOrCondition paramétert az eredmény további szűréséhez.
Table.Min	Egy tábla legkisebb sorát vagy sorát adja vissza összehasonlítóCriteria használatával.
Table.MinN	Az adott tábla legkisebb N sorait adja vissza. A sorok rendezése után meg kell adni a countOrCondition paramétert az eredmény további szűréséhez.
Table.AddRankColumn	Hozzáfűz egy oszlopot egy vagy több másik oszlop rangsorolásával.
Table.Sort	A táblázat sorait összehasonlítóCriteria vagy alapértelmezett sorrend alapján rendezi, ha nincs megadva.

Egyéb

Name	Leírás
Table.Buffer	Pufferel egy táblát a memóriába, és elkülöníti a külső változásoktól a kiértékelés során.

Paraméterértékek

Kimeneti oszlopok elnevezése

Ez a paraméter az eredményként kapott tábla oszlopnevét megadó szöveges értékek listája. Ezt a paramétert általában a Table.FromRows és a Table.FromList függvények használják.

Összehasonlítási feltételek

Az összehasonlítási feltétel az alábbi értékek valamelyikeként adható meg:

• Számérték a rendezési sorrend megadásához. További információ: Rendezési sorrend

• A rendezéshez használandó kulcs kiszámításához egy argumentum függvénye használható.

• A kulcs és a vezérlési sorrend kiválasztásához az összehasonlítási feltétel lehet a kulcsot és a sorrendet tartalmazó lista.

• Az összehasonlítás teljes szabályozásához két argumentumból álló függvény használható, amelyek -1, 0 vagy 1 értéket adnak vissza a bal és a jobb oldali bemenetek közötti kapcsolat alapján. A Value.Compare használatával delegálhatja ezt a logikát.

Példaként tekintse meg a Table.Sort leírását.

Darabszám vagy feltétel feltétel

Ez a feltétel általában a rendezési vagy sorműveletek során használatos. Meghatározza a táblában visszaadott sorok számát, és két űrlapot, számot vagy feltételt tartalmazhat.

• A szám azt jelzi, hogy hány értéket ad vissza beágyazottan a megfelelő függvénnyel.

• Ha egy feltétel meg van adva, a függvény visszaadja a feltételnek kezdetben megfelelő értékeket tartalmazó sorokat. Ha egy érték nem felel meg a feltételnek, a rendszer nem veszi figyelembe a további értékeket.

További információ: Table.FirstN, Table.MaxN

További értékek kezelése

Az extra értékek azt jelzik, hogy a függvény hogyan kezelje a soron belüli extra értékeket. Ez a paraméter számként van megadva, amely a következő beállításokhoz lesz megfeleltetve:

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

További információ: Table.FromList, ExtraValues.Type

Hiányzó oszlopkezelés

Ez a paraméter azt jelzi, hogy a függvény hogyan kezelje a hiányzó oszlopokat. Ez a paraméter számként van megadva, amely a következő beállításokhoz lesz megfeleltetve:

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

Ezt a paramétert használják például a Table.TransformColumns oszlop- vagy átalakítási műveleteiben. További információ: MissingField.Type

Rendezés iránya

A rendezési sorrend azt jelzi, hogy az eredményeket hogyan kell rendezni. Ez a paraméter számként van megadva, amely a következő beállításokhoz lesz megfeleltetve:

Order.Ascending = 0 Order.Descending = 1

További információ: Order.Type

Egyenletfeltételek

A táblák egyenletfeltétele a következőképpen adható meg:

• Függvényérték, amely a következő:

  • Egy kulcsválasztó, amely meghatározza a tábla oszlopát az egyenlőségi feltételek alkalmazásához.

  • Egy összehasonlító függvény, amely az alkalmazandó összehasonlítás típusának megadására szolgál. A beépített összehasonlító függvények megadhatók. További információ: Összehasonlító függvények

• A táblázat oszlopainak listája az egyenlőségi feltételek alkalmazásához.

Példaként tekintse meg a Table.Distinct leírását.