Jaa

Taulukkofunktiot

  • Artikkeli

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

Taulukon luominen

Nimi Kuvaus
#table Luo taulukon arvon sarakkeista ja riveistä.
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 Luo taulukon sarakkeiden ja määritettyjen arvojen luettelosta.
Table.FromList Muuntaa luettelon taulukoksi käyttämällä määritettyä jakofunktiota kuhunkin luettelon kohteeseen.
Table.FromRecords Muuntaa tietueluettelon taulukoksi.
Table.FromRows Luo taulukon riviarvojen ja valinnaisten sarakkeiden luettelosta.
Table.FromValue Luo taulukon, jossa on sarake annetusta arvosta tai arvoista.
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 Luo taulukon sisäkkäisten sarakearvoluetteloiden luettelon.
Table.ToList Muuntaa taulukon luetteloksi käyttämällä määritettyä yhdistämisfunktiota kullekin taulukon arvoriville.
Table.ToRecords Muuntaa taulukon tietueluetteloksi.
Table.ToRows Luo taulukon sisäkkäisten riviarvoluetteloiden luettelon.

Informaatio

Nimi Kuvaus
Table.ApproximateRowCount Palauttaa taulukon rivien likimääräisen määrän.
Table.ColumnCount Palauttaa taulukon sarakkeiden määrän.
Table.IsEmpty Ilmaisee, sisältääkö taulukko rivejä.
Table.PartitionValues Palauttaa tietoja siitä, miten taulukko on osioitu.
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 Hakee taulukkojoukon väliset suhteet.

Rivitoiminnot

Nimi Kuvaus
Table.AlternateRows Säilyttää alkusiirtymisen ja ottaa ja ohittaa seuraavat rivit vuorotellen.
Table.Combine Palauttaa taulukon, joka on taulukkoluettelon yhdistämisen tulos.
Table.FindText Palauttaa kaikki rivit, jotka sisältävät annetun tekstin taulukossa.
Table.First Palauttaa ensimmäisen rivin tai määritetyn oletusarvon.
Table.FirstN Palauttaa määritetyt ensimmäiset määrärivit.
Table.FirstValue Palauttaa taulukon ensimmäisen rivin ensimmäisen sarakkeen tai määritetyn oletusarvon.
Table.FromPartitions Palauttaa taulukon, joka on osioitujen taulukoiden joukon yhdistämisen tulos.
Table.InsertRows Lisää riviluettelon taulukkoon määritettyyn sijaintiin.
Table.Last Palauttaa viimeisen rivin tai määritetyn oletusarvon.
Table.LastN Palauttaa viimeisen määritetyn määrän rivejä.
Table.MatchesAllRows Ilmaisee, täyttävätkö taulukon kaikki rivit annetun ehdon.
Table.MatchesAnyRows Ilmaisee, täyttävätkö taulukon mitkään rivit annetun ehdon.
Table.Partition Osioi taulukon taulukoiden luetteloksi määritettyjen ryhmien ja sarakkeiden määrän perusteella.
Table.Range Palauttaa rivit alkaen määritetystä siirtymästä.
Table.RemoveFirstN Palauttaa taulukon, josta on poistettu määritetty määrä rivejä ensimmäisestä rivistä alkaen.
Table.RemoveLastN Palauttaa taulukon, josta on poistettu määritetty määrä rivejä viimeisestä rivistä alkaen.
Table.RemoveRows Poistaa määritetyn määrän rivejä.
Table.RemoveRowsWithErrors Palauttaa taulukon, jonka syötetaulukosta on poistettu rivit, jotka sisältävät virheen vähintään yhdessä solussa. Jos sarakeluettelo on määritetty, vain määritettyjen sarakkeiden solut tarkistetaan virheiden varalta.
Table.Repeat Toistaa taulukoiden rivit määritetyn määrän kertoja.
Table.ReplaceRows Korvaa määritetyn rivialueen annetulla rivillä tai riveillä.
Table.ReverseRows Palauttaa taulukon, jonka rivit ovat käänteisessä järjestyksessä.
Table.SelectRows Valitsee rivit, jotka täyttävät ehtofunktion.
Table.SelectRowsWithErrors Palauttaa taulukon, joka sisältää vain ne syötetaulukon rivit, jotka sisältävät virheen vähintään yhdessä solussa. Jos sarakeluettelo on määritetty, vain määritettyjen sarakkeiden solut tarkistetaan virheiden varalta.
Table.SingleRow Palauttaa yhden rivin taulukossa.
Table.Skip Palauttaa taulukon, jossa ensimmäinen määritetty määrä rivejä ohitetaan.
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 määritetyn tietosarakkeen taulukosta luettelona.
Table.ColumnNames Palauttaa sarakkeiden nimet luettelona.
Table.ColumnsOfType Palauttaa luettelon niiden sarakkeiden nimillä, jotka vastaavat määritettyjä tyyppejä.
Table.DemoteHeaders Alentaa sarakeotsikot ensimmäiselle arvoriville.
Table.DuplicateColumn Monistaa sarakkeen, jolla on määritetty nimi. Arvot ja tyyppi kopioidaan lähdesarakkeesta.
Table.HasColumns Ilmaisee, sisältääkö taulukko määritetyn sarakkeen vai sarakkeet.
Table.Pivot Kun annetaan määrite–arvo-pareja edustava sarakepari, kiertää määritesarakkeen tiedot sarakeotsikoiksi.
Table.PrefixColumns Palauttaa taulukon, jossa kaikille sarakkeille on lisätty etuliitteeksi annettu teksti.
Table.PromoteHeaders Ylentää ensimmäisen arvorivin uusiksi sarakeotsikoiksi (eli sarakkeiden nimiksi).
Table.RemoveColumns Poistaa määritetyt sarakkeet.
Table.ReorderColumns Palauttaa taulukon, jossa sarakkeet ovat määritetyssä järjestyksessä.
Table.RenameColumns Palauttaa taulukon, jonka sarakkeet on nimetty uudelleen määritetyn mukaisesti.
Table.SelectColumns Palauttaa taulukon, jossa on vain määritetyt sarakkeet.
Table.TransformColumnNames Muuntaa sarakkeiden nimet käyttäen annettua funktiota.
Table.Unpivot Kääntää taulukon sarakejoukon määrite–arvo-pareiksi.
Table.UnpivotOtherColumns Kääntää määritettyä joukkoa lukuun ottamatta kaikki sarakkeet määrite–arvo-pareiksi.

Muunnos

Nimi Kuvaus
Table.AddColumn Lisää sarakkeen, jolla on määritetty nimi. Arvo lasketaan käyttäen määritettyä valintafunktiota, ja kukin rivi otetaan syötteenä.
Table.AddFuzzyClusterColumn Lisää uuden sarakkeen, jonka edustavat arvot on hankittu taulukon määritetyn sarakkeen arvojen sumean ryhmittelyn avulla.
Table.AddIndexColumn Liittää sarakkeen, jossa on eksplisiittisiä sijaintiarvoja.
Table.AddJoinColumn Suorittaa liitoksen taulukoiden välillä annetuille sarakkeille ja tuottaa liitostuloksen uuteen sarakkeeseen.
Table.AddKey Lisää avaimen taulukkoon.
Table.AggregateTableColumn Koostaa taulukoiden sarakkeen useiksi sarakkeiksi sisältävässä taulukossa.
Table.CombineColumns Yhdistää määritetyt sarakkeet uudeksi sarakkeeksi käyttäen määritettyä yhdistämistoimintofunktiota.
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 Levittää edellisen solun arvon alla oleviin tyhjäarvoisiin soluihin.
Table.FillUp Levittää solun arvon sarakkeessa yläpuolella oleviisi tyhjäarvoisiin soluihin.
Table.FilterWithDataTable Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
Table.FuzzyGroup Ryhmittelee taulukon rivit avainten sumean vastaavuuden perusteella.
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.Group Ryhmittelee taulukon rivit, joilla on sama avain.
Table.Join Liittää yhteen kahdesta taulukosta rivit, jotka vastaavat annettujen avainten perusteella.
Table.Keys Palauttaa määritetyn taulukon avaimet.
Table.NestedJoin Suorittaa liitoksen taulukoiden välillä annetuille sarakkeille ja tuottaa liitostuloksen 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 yhden arvon toisella määritetyissä sarakkeissa.
Table.Split Jakaa määritetyn taulukon taulukoiden luetteloksi käyttäen määritettyä sivun kokoa.
Table.SplitColumn Jakaa määritetyt sarakkeet joukoksi muita sarakkeita käyttäen määritettyä jakotoimintoa.
Table.TransformColumns Muuntaa yhden tai useamman sarakkeen arvot.
Table.TransformColumnTypes Ottaa käyttöön lomakkeen { sarakkeen, tyypin } tyypin muunnokset käyttäen tiettyä maa-asetusta.
Table.TransformRows Muuntaa taulukon rivit käyttäen määritettyä muunnosfunktiota.
Table.Transpose Tekee sarakkeista rivejä ja riveistä sarakkeita.

Jäsenyys

Nimi Kuvaus
Table.Contains Ilmaisee, näkyykö määritetty tietue rivinä taulukossa.
Table.ContainsAll Ilmaisee, näkyvätkö kaikki määritetyt tietueet taulukon riveinä.
Table.ContainsAny Ilmaisee, näkyykö jokin määritetyistä tietueista taulukon riveinä.
Table.Distinct Poistaa rivien kaksoiskappaleet taulukosta.
Table.IsDistinct Ilmaisee, sisältääkö taulukko vain erillisiä rivejä (ei kaksoiskappaleita).
Table.PositionOf Palauttaa rivin sijainnin tai sijainnit taulukon sisällä.
Table.PositionOfAny Palauttaa minkä tahansa määritetyn rivin sijainnin tai sijainnit taulukon sisällä.
Table.RemoveMatchingRows Poistaa määritetyn rivin kaikki esiintymät taulukosta.
Table.ReplaceMatchingRows Korvaa kaikki määritetyt rivit annetulla rivillä tai riveillä.

Järjestys

Nimi Kuvaus
Table.AddRankColumn Liittää sarakkeen, jossa on vähintään yksi muu sarake.
Table.Max Palauttaa suurimman rivin tai oletusarvon käyttäen annettuja ehtoja.
Table.MaxN Palauttaa suurimman rivin tai rivit käyttäen annettuja ehtoja.
Table.Min Palauttaa pienimmän rivin tai oletusarvon käyttäen annettuja ehtoja.
Table.MinN Palauttaa pienimmän rivin tai rivit käyttäen annettuja ehtoja.
Table.Sort Lajittelee taulukon käyttäen yhtä tai useampaa sarakkeen nimeä ja vertailuehtoa.

Toinen

Nimi Kuvaus
Table.Buffer Puskuroi taulukon muistiin eristäen sen ulkoisilta muutoksilta arvioinnin aikana.
Table.StopFolding Estää jatkotoimintojen suorittamisen tietojen alkuperäiseen lähteeseen.

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.