Taulukkofunktiot

Nämä funktiot luovat ja käsittelevät taulukkoarvoja.

Taulukon luominen

Nimi	Kuvaus
ItemExpression.From	Palauttaa funktion rungolle abstraktin syntaksipuun (AST).
ItemExpression.Item	Abstrakti syntaksipuu (AST) -solmu, joka edustaa kohdetta kohdelausekkeessa.
RowExpression.Column	Palauttaa abstraktin syntaksipuun (AST), joka edustaa pääsyä sarakkeeseen rivilausekkeen sisällä.
RowExpression.From	Palauttaa funktion rungolle abstraktin syntaksipuun (AST).
RowExpression.Row	Abstrakti syntaksipuu (AST) -solmu, joka edustaa rivilausekkeen riviä.
Table.FromColumns	Palauttaa taulukon luettelosta, joka sisältää sarakkeiden nimiä ja arvoja sisältäviä sisäkkäisiä luetteloita.
Table.FromList	Muuntaa luettelon taulukoksi käyttämällä määritettyä jakofunktiota kuhunkin luettelon kohteeseen.
Table.FromRecords	Palauttaa taulukon tietueluettelosta.
Table.FromRows	Luo taulukon luettelosta, jossa luettelon jokainen osa on luettelo, joka sisältää yksittäisen rivin sarakearvot.
Table.FromValue	Palauttaa taulukon, jossa on sarake, joka sisältää annetun arvon tai arvoluettelon.
Table.FuzzyGroup	Ryhmittelee taulukon rivit täsmäämällä jokaisen rivin määritetyn sarakkeen arvot sumeasti.
Table.FuzzyJoin	Liittää yhteen kahdesta taulukosta rivit, jotka täsmäävät sumeasti annettujen avainten perusteella.
Table.FuzzyNestedJoin	Suorittaa sumean liitoksen taulukoiden välillä annetuille sarakkeille ja tuottaa liitostuloksen uuteen sarakkeeseen.
Table.Split	Jakaa määritetyn taulukon taulukoiden luetteloksi käyttäen määritettyä sivun kokoa.
Table.WithErrorContext	Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
Table.View	Luo tai laajentaa taulukkoa käyttäjän määrittämien käsittelytoimintojen avulla kysely- ja toimintotoimintoja varten.
Table.ViewError	Luo muokatun virhetietueen, joka ei käynnistä varatoimintoa, kun näkymään määritetty käsittelijä heittää sen (Table.View).
Table.ViewFunction	Luo funktion, jonka näkymälle määritetty käsittelijä voi kaapata (Table.Viewkautta).

Tuloksia

Nimi	Kuvaus
Table.ToColumns	Palauttaa syötetaulukon arvojen saraketta edustavien sisäkkäisten luetteloiden luettelon.
Table.ToList	Palauttaa taulukon luetteloksi käyttämällä määritettyä yhdistämisfunktiota kullekin taulukon arvoriville.
Table.ToRecords	Palauttaa syötetaulukon tietueluettelon.
Table.ToRows	Palauttaa syötetaulukon sisäkkäisen riviarvoluettelon.

Informaatio

Nimi	Kuvaus
Table.ApproximateRowCount	Palauttaa taulukon rivien likimääräisen määrän.
Table.ColumnCount	Palauttaa taulukon sarakkeiden määrän.
Table.IsEmpty	Palauttaa arvon true, jos taulukko ei sisällä rivejä.
Table.Profile	Palauttaa taulukon sarakkeiden profiilin.
Table.RowCount	Palauttaa taulukon rivien määrän.
Table.Schema	Palauttaa taulukon, joka sisältää määritetyn taulukon sarakkeiden kuvauksen (eli rakenteen).
Tables.GetRelationships	Palauttaa taulukkojoukon väliset suhteet.

Rivitoiminnot

Nimi	Kuvaus
Table.AlternateRows	Palauttaa taulukon, joka sisältää taulukon rivien vuorottelevan mallin.
Table.Combine	Palauttaa taulukon, joka on taulukkoluettelon yhdistämisen tulos. Kaikilla taulukoilla on oltava sama rivityyppirakenne.
Table.FindText	Palauttaa taulukon, joka sisältää vain rivit, joilla on määritetty teksti jossakin solussa tai solun osassa.
Table.First	Palauttaa taulukon ensimmäisen rivin.
Table.FirstN	Palauttaa taulukon ensimmäiset rivit countOrCondition-parametrin mukaan.
Table.FirstValue	Palauttaa taulukon ensimmäisen rivin ensimmäisen sarakkeen tai määritetyn oletusarvon.
Table.FromPartitions	Palauttaa taulukon, joka on osioitujen taulukoiden joukon uusiin sarakkeisiin yhdistämisen tulos. Sarakkeen tyyppi voidaan valinnaisesti määrittää, oletusarvo on mikä tahansa.
Table.InsertRows	Palauttaa taulukon, jossa on riviluettelo, joka on asetettu taulukkoon indeksinä. Jokaisen lisättävän rivin on vastattava taulukon rivityyppiä.
Table.Last	Palauttaa taulukon viimeisen rivin.
Table.LastN	Palauttaa taulukon viimeiset rivit countOrCondition-parametrin mukaan.
Table.MatchesAllRows	Palauttaa arvon true, jos kaikki taulukon rivit täyttävät ehdon.
Table.MatchesAnyRows	Palauttaa arvon true, jos jokin taulukon riveistä täyttää ehdon.
Table.Partition	Osioi taulukon ryhmäluetteloksi, joka perustuu kunkin rivin sarakkeen arvoon ja hajautusfunktioon. Hajautusfunktiota käytetään rivin sarakkeen arvolle, jotta saadaan rivin hajautusarvo. Hajautusarvon jakojääneryhmät määrittävät, mihin palautetuista taulukoista rivi sijoitetaan.
Table.PartitionValues	Palauttaa tietoja siitä, miten taulukko on osioitu.
Table.Range	Palauttaa määritetyn määrän rivejä taulukosta alkaen siirtymästä.
Table.RemoveFirstN	Palauttaa taulukon, josta on poistettu määritetty määrä rivejä ensimmäisestä rivistä alkaen. Poistettujen rivien määrä määräytyy valinnaisen countOrCondition-parametrin mukaan.
Table.RemoveLastN	Palauttaa taulukon, josta on poistettu määritetty määrä rivejä viimeisestä rivistä alkaen. Poistettujen rivien määrä määräytyy valinnaisen countOrCondition-parametrin mukaan.
Table.RemoveRows	Palauttaa taulukon, josta on poistettu määritetty määrä rivejä alkaen siirtymästä.
Table.RemoveRowsWithErrors	Palauttaa taulukon, josta on poistettu kaikki ne rivit, jotka sisältävät virheen vähintään yhdessä rivin solussa.
Table.Repeat	Palauttaa taulukon, joka sisältää taulukon rivit toistettuna määrä-ajankohdalla.
Table.ReplaceRows	Palauttaa taulukon, jossa annetuilla riveillä on korvattu rivit alkaen siirtymästä ja jatkuen määrän mukaan.
Table.ReverseRows	Palauttaa taulukon, jonka rivit ovat käänteisessä järjestyksessä.
Table.SelectRows	Palauttaa taulukon, joka sisältää vain ehtoja vastaavat rivit.
Table.SelectRowsWithErrors	Palauttaa taulukon, joka sisältää vain ne taulukon rivit, jotka sisältävät virheen vähintään yhdessä rivin solussa.
Table.SingleRow	Palauttaa yksittäisen rivin taulukosta.
Table.Skip	Palauttaa taulukon, joka ei sisällä taulukon ensimmäistä tai ensimmäisiä rivejä.
Table.SplitAt	Palauttaa luettelon, joka sisältää ensimmäiset määritetyt määrärivit ja jäljellä olevat rivit.

Saraketoiminnot

Nimi	Kuvaus
Table.Column	Palauttaa taulukon sarakkeen arvot.
Table.ColumnNames	Palauttaa taulukon sarakkeiden nimet.
Table.ColumnsOfType	Palauttaa luettelon niiden sarakkeiden nimillä, jotka vastaavat määritettyjä tyyppejä.
Table.DemoteHeaders	Alentaa otsikkorivin taulukon ensimmäiseksi riviksi.
Table.DuplicateColumn	Monistaa sarakkeen, jolla on määritetty nimi. Arvot ja tyyppi kopioidaan lähdesarakkeesta.
Table.HasColumns	Ilmaisee, sisältääkö taulukko määritetyt sarakkeet.
Table.Pivot	Kun annetaan taulukko ja ominaisuussarake, joka sisältää pivot-arvoja, luo uudet sarakkeet kullekin pivot-arvolle ja määrittää niille arvot valueColumn-kohteesta. Valinnainen aggregationFunction voidaan antaa käsittelemään saman avainarvon useita esiintymiä ominaisuussarakkeessa.
Table.PrefixColumns	Palauttaa taulukon, jossa kaikille sarakkeille on lisätty etuliitteeksi tekstiarvo.
Table.PromoteHeaders	Korottaa taulukon ensimmäisen rivin otsikoksi tai sarakenimeksi.
Table.RemoveColumns	Palauttaa taulukon, jossa ei ole tiettyä saraketta tai sarakkeita.
Table.ReorderColumns	Palauttaa taulukon, jossa on tietyt sarakkeet tietyssä järjestyksessä toisiinsa nähden.
Table.RenameColumns	Palauttaa taulukon, jonka sarakkeet on nimetty uudelleen määritetyn mukaisesti.
Table.SelectColumns	Palauttaa taulukon, joka sisältää vain tietyt sarakkeet.
Table.TransformColumnNames	Muuntaa sarakkeiden nimet käyttäen annettua funktiota.
Table.Unpivot	Annettu taulukkosarakkeiden luettelo muuntaa nämä sarakkeet määrite–arvo-pareiksi.
Table.UnpivotOtherColumns	Kääntää määritettyä joukkoa lukuun ottamatta kaikki sarakkeet määrite–arvo-pareiksi yhdistettynä kunkin rivin muiden arvojen kanssa.

Muunnos

Nimi	Kuvaus
Table.AddColumn	Lisää taulukkoon sarakkeen, jonka nimi on newColumnName.
Table.AddFuzzyClusterColumn	Lisää uuden sarakkeen, jonka edustavat arvot on hankittu taulukon määritetyn sarakkeen arvojen sumean ryhmittelyn avulla.
Table.AddIndexColumn	Palauttaa taulukon, jossa on tietty nimi oleva uusi sarake, joka sisältää kullekin riville taulukon rivin indeksin.
Table.AddJoinColumn	Suorittaa sisäkkäisen liitoksen taulukon 1 ja taulukon 2 välillä tietyistä sarakkeista ja tuottaa liitoksen tuloksen newColumnName-sarakkeeksi kullekin taulukon 1 riville.
Table.AddKey	Lisää avaimen taulukkoon.
Table.AggregateTableColumn	Koostaa tiettyyn sarakkeeseen upotetut taulukot useiksi sarakkeiksi, jotka sisältävät kyseisten taulukoiden koostearvot.
Table.CombineColumns	Table.CombineColumns yhdistää sarakkeet yhdistämistoimintofunktiolla uuden sarakkeen tuottamiseksi. Table.CombineColumns käänteinen Table.SplitColumn.
Table.CombineColumnsToRecord	Yhdistää määritetyt sarakkeet uudeksi tietuearvoiseksi sarakkeeksi, jossa kullakin tietueella on kenttien nimet ja arvot, jotka vastaavat yhdistettyjen sarakkeiden nimiä ja arvoja.
Table.ConformToPageReader	Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
Table.ExpandListColumn	Kun annetaan taulukon sarakeluettelo, luo kopio rivistä kullekin arvolle sen luettelossa.
Table.ExpandRecordColumn	Laajentaa tietuesarakkeen sarakkeisiin kunkin arvon kanssa.
Table.ExpandTableColumn	Laajentaa saraketaulukon tietuesarakkeen useiksi sarakkeiksi sisältävässä taulukossa.
Table.FillDown	Korvaa taulukon määritetyn sarakkeen tai sarakkeiden tyhjäarvot sarakkeen viimeisimmillä muilla kuin tyhjäarvoilla.
Table.FillUp	Palauttaa määritetystä taulukosta taulukon, jossa seuraavan solun arvo levitetään määritetyssä sarakkeessa yläpuolella oleviin tyhjäarvosoluihin.
Table.FilterWithDataTable	Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
Table.Group	Ryhmittelee taulukon rivit kunkin rivin avainsarakkeiden arvojen mukaan.
Table.Join	Liittää taulukon 1 rivit taulukon 2 riveihin perustuen avainsarakkeiden arvojen yhdenvertaisuuteen, valitsijat table1, key1 ja table2, key2.
Table.Keys	Palauttaa määritetyn taulukon avaimet.
Table.NestedJoin	Liittää taulukoiden rivit avainten yhdenvertaisuuden perusteella. Tulokset lisätään uuteen sarakkeeseen.
Table.ReplaceErrorValues	Korvaa määritettyjen sarakkeiden virhearvot vastaavalla määritetyllä arvolla.
Table.ReplaceKeys	Korvaa määritetyn taulukon avaimet.
Table.ReplaceRelationshipIdentity	Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
Table.ReplaceValue	Korvaa oldValue-arvon newValue-arvolla taulukon tietyissä sarakkeissa käyttämällä annettua korvaustoimintofunktiota, kuten tekstiä. Replace tai Value.Replace.
Table.SplitColumn	Palauttaa uuden sarakejoukon yksittäisestä sarakkeesta käyttäen jakofunktiota kuhunkin arvoon.
Table.TransformColumns	Muuntaa yhden tai useamman sarakkeen arvot.
Table.TransformColumnTypes	Muuntaa taulukon saraketyypit käyttäen tyyppiä.
Table.TransformRows	Muuntaa taulukon rivit käyttämällä muunnosfunktiota.
Table.Transpose	Palauttaa taulukon, jossa syötetaulukon sarakkeet on muunnettu riveiksi ja rivit sarakkeiksi.

Jäsenyys

Nimi	Kuvaus
Table.Contains	Määrittää, näkyykö tietue taulukon rivinä.
Table.ContainsAll	Määrittää, näkyvätkö kaikki määritetyt tietueet taulukon riveinä.
Table.ContainsAny	Määrittää, näkyykö jokin määritetyistä tietueista taulukon riveinä.
Table.Distinct	Poistaa rivien kaksoiskappaleet taulukosta ja varmistaa, että kaikki jäljellä olevat rivit ovat erillisiä.
Table.IsDistinct	Määrittää, sisältääkö taulukko vain erillisiä rivejä.
Table.PositionOf	Määrittää rivin sijainnin tai sijainnit taulukon sisällä.
Table.PositionOfAny	Määrittää minkä tahansa määritetyn rivin sijainnin tai sijainnit taulukon sisällä.
Table.RemoveMatchingRows	Poistaa kaikki rivien esiintymät taulukosta.
Table.ReplaceMatchingRows	Korvaa tietyt rivit taulukosta uusilla riveillä.

Järjestys

Nimi	Kuvaus
Table.Max	Palauttaa taulukon suurimman rivin tai rivit käyttämällä comparisonCriteria-ehtoa.
Table.MaxN	Palauttaa taulukon suurimmat N riviä. Kun rivit on lajiteltu, countOrCondition-parametri on määritettävä, jotta tulosta voidaan suodattaa edelleen.
Table.Min	Palauttaa taulukon pienimmän rivin tai rivit käyttämällä comparisonCriteria-ehtoa.
Table.MinN	Palauttaa annetun taulukon pienimmät N riviä. Kun rivit on lajiteltu, countOrCondition-parametri on määritettävä, jotta tulosta voidaan suodattaa edelleen.
Table.AddRankColumn	Liittää sarakkeen, jossa on vähintään yksi muu sarake.
Table.Sort	Lajittelee taulukon rivit käyttämällä comparisonCriteria-ehtoa tai oletusjärjestystä, jos sellaista ei ole määritetty.

Toinen

Nimi	Kuvaus
Table.Buffer	Puskuroi taulukon muistiin eristäen sen ulkoisilta muutoksilta arvioinnin aikana.

Parametriarvojen

Tulossarakkeiden nimeäminen

Tämä parametri on luettelo tekstiarvoista, jotka määrittävät tuloksena saatavan taulukon sarakkeiden nimet. Tätä parametria käytetään yleensä taulukon rakennefunktioissa, kuten Table.FromRows ja Table.FromList.

Vertailuehdot

Vertailukriteeri voidaan antaa jommankumman seuraavista arvoista:

• Numeroarvona lajittelujärjestyksen määrittämiseksi. Lisätietoja: Lajittelujärjestys-

• Lajitteluun käytettävän avaimen laskemiseen voidaan käyttää yhden argumentin funktiota.

• Jos haluat valita sekä avaimen että hallintajärjestyksen, vertailukriteeri voi olla avaimen ja järjestyksen sisältävä luettelo.

• Vertailun täydelliseen hallintaan voidaan käyttää kahden argumentin funktiota, joka palauttaa arvon -1, 0 tai 1, kun otetaan huomioon vasemman- ja oikeanpuoleisten syötteiden välinen suhde. Value.Compare voidaan delegoida tämä logiikka.

Katso esimerkkejä artikkelista Table.Sortkuvaus.

Määrä- tai Ehto-ehdot

Näitä ehtoja käytetään yleensä järjestys- tai rivitoiminnoissa. Se määrittää taulukossa palautettujen rivien määrän, ja se voi olla muodoltaan joko luku tai ehto.

• Luku ilmaisee, kuinka monta arvoa palautetaan sopivalla funktiolla.

• Jos määritetään ehto, palautetaan alun perin ehdon täyttävät arvot sisältävät rivit. Kun yksi arvo ei täytä ehtoa, sen jälkeen mitään lisäarvoja ei oteta huomioon.

Lisätietoja: Table.FirstN, Table.MaxN

Ylimääräisten arvojen käsittely

Lisäarvojen avulla ilmaistaan, miten funktion pitäisi käsitellä ylimääräisiä arvoja rivillä. Tämä parametri on määritetty luvuksi, joka liittyy seuraaviin asetuksiin:

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

Lisätietoja: Table.FromList, ExtraValues.Type

Puuttuvan sarakkeen käsittely

Tämän parametrin avulla ilmaistaan, miten funktion pitäisi käsitellä puuttuvia sarakkeita. Tämä parametri on määritetty luvuksi, joka liittyy seuraaviin asetuksiin:

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

Tätä parametria käytetään sarake- tai muunnostoiminnoissa, esimerkiksi Table.TransformColumns. Lisätietoja: MissingField.Type

Lajittelujärjestys

Lajittelujärjestyksen avulla ilmaistaan, miten tulokset lajitellaan. Tämä parametri on määritetty luvuksi, joka liittyy seuraaviin asetuksiin:

Order.Ascending = 0 Order.Descending = 1

Lisätietoja: Order.Type

Kaavaehdot

Taulukoiden kaavaehdot voidaan määrittää joko seuraavasti:

• Funktioarvo, joka on joko:

  • Avainvalitsin, joka määrittää taulukon sarakkeen, jossa yhtäläisyysehtoja käytetään.

  • Vertailutoimintofunktio, jonka avulla määritetään käytettävä vertailutyyppi. Valmiita vertailutoimintofunktioita voidaan määrittää. Lisätietoja: Comparer-funktiot

• Luettelo taulukon sarakkeista, joita käytetään yhtäläisyysehtojen soveltamiseen.

Katso esimerkkejä artikkelista Table.Distinctkuvaus.