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'n kautta). |
Table.ViewFunction | Luo funktion, jonka näkymälle määritetty käsittelijä voi kaapata (Table.View-kohteen kautta). |
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. |
Tietoja
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 palauttaa arvon Table.SplitColumns. |
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ä. |
Tilaaminen
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. |
Muut
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-funktion avulla tätä logiikkaa voidaan delegoida.
Katso esimerkkejä kohdasta Table.Sort.
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-tiedostossa. Lisätietoja: MissingField.Type
Lajittelujärjestyksen
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: Vertailutoimintofunktiot
Luettelo taulukon sarakkeista, joita käytetään yhtäläisyysehtojen soveltamiseen.
Katso esimerkkejä kohdasta Table.Distinct.