Lezen in het Engels

Delen via


Tabelfuncties

Met deze functies worden tabelwaarden gemaakt en bewerkt.

Tabelconstructie

Naam Beschrijving
ItemExpression.From Retourneert de abstracte syntaxisstructuur (AST) voor de hoofdtekst van een functie.
ItemExpression.Item Een abstracte syntaxisboomknooppunt (AST) dat het item binnen een itemexpressie vertegenwoordigt.
RowExpression.Column Hiermee wordt een abstracte syntaxisstructuur (AST) geretourneerd die toegang tot een kolom in een rijexpressie vertegenwoordigt.
RowExpression.From Retourneert de abstracte syntaxisstructuur (AST) voor de hoofdtekst van een functie.
RowExpression.Row Een knooppunt van een abstracte syntaxisboom (AST) dat de rij in een rijexpressie vertegenwoordigt.
Table.FromColumns Retourneert een tabel uit een lijst met geneste lijsten met de kolomnamen en -waarden.
Table.FromList Converteert een lijst naar een tabel door de opgegeven splitsfunctie toe te passen op elk item in de lijst.
Table.FromRecords Retourneert een tabel uit een lijst met records.
Table.FromRows Hiermee maakt u een tabel uit de lijst waarin elk element van de lijst een lijst is die de kolomwaarden voor één rij bevat.
Table.FromValue Retourneert een tabel met een kolom met de opgegeven waarde of lijst met waarden.
Table.FuzzyGroup Hiermee worden de rijen van een tabel gegroepeerd op basis van overeenkomende waarden in de opgegeven kolom voor elke rij.
Table.FuzzyJoin De rijen van de twee tabellen worden samengevoegd die ongeveer overeenkomen op basis van de opgegeven sleutels.
Table.FuzzyNestedJoin Voert een fuzzy join uit tussen tabellen in opgegeven kolommen en produceert het joinresultaat in een nieuwe kolom.
Table.Split Hiermee wordt de opgegeven tabel gesplitst in een lijst met tabellen met behulp van het opgegeven paginaformaat.
Table.WithErrorContext Deze functie is alleen bedoeld voor intern gebruik.
Table.View Hiermee maakt of breidt u een tabel uit met door de gebruiker gedefinieerde handlers voor query- en actiebewerkingen.
Table.ViewError Creëert een gewijzigde foutrecord die geen terugval activeert als deze wordt opgeworpen door een handler die is gedefinieerd op een view (via Table.View).
Table.ViewFunction Hiermee maakt u een functie die kan worden onderschept door een handler die is gedefinieerd in een weergave (via Table.View).

Conversies

Naam Beschrijving
Table.ToColumns Retourneert een lijst met geneste lijsten die elk een kolom met waarden in de invoertabel vertegenwoordigen.
Table.ToList Retourneert een tabel in een lijst door de opgegeven combinatiefunctie toe te passen op elke rij met waarden in een tabel.
Table.ToRecords Retourneert een lijst met records uit een invoertabel.
Table.ToRows Retourneert een geneste lijst met rijwaarden uit een invoertabel.

Informatie

Naam Beschrijving
Table.ApproximateRowCount Retourneert het geschatte aantal rijen in de tabel.
Table.ColumnCount Retourneert het aantal kolommen in een tabel.
Table.IsEmpty Retouneert "true" als de tabel geen rijen bevat.
Table.Profile Retourneert een profiel van de kolommen van een tabel.
Table.RowCount Retourneert het aantal rijen in een tabel.
Table.Schema Retourneert een tabel met een beschrijving van de kolommen (dat wil bijvoorbeeld het schema) van de opgegeven tabel.
Tables.GetRelationships Retourneert de relaties tussen een set tabellen.

Rijbewerkingen

Naam Beschrijving
Table.AlternateRows Retourneert een tabel met een afwisselend patroon van de rijen uit een tabel.
Table.Combine Retourneert een tabel die het resultaat is van het samenvoegen van een lijst met tabellen. De tabellen moeten allemaal dezelfde rijtypestructuur hebben.
Table.FindText Retourneert een tabel met alleen de rijen met de opgegeven tekst in een van de cellen of een deel daarvan.
Table.First Retourneert de eerste rij uit een tabel.
Table.FirstN Retourneert de eerste rij(en) van een tabel, afhankelijk van de parameter countOrCondition.
Table.FirstValue Retourneert de eerste kolom van de eerste rij van de tabel of een opgegeven standaardwaarde.
Table.FromPartitions Retourneert een tabel die het resultaat is van het combineren van een set gepartitioneerde tabellen in nieuwe kolommen. Het type van de kolom kan eventueel worden opgegeven, de standaardwaarde is een.
Table.InsertRows Retourneert een tabel met de lijst met rijen die zijn ingevoegd in de tabel in een index. Elke rij die moet worden ingevoegd, moet overeenkomen met het rijtype van de tabel..
Table.Last Retourneert de laatste rij van een tabel.
Table.LastN Retourneert de laatste rij(en) uit een tabel, afhankelijk van de parameter countOrCondition.
Table.MatchesAllRows Retourneert waar als alle rijen in een tabel voldoen aan een voorwaarde.
Table.MatchesAnyRows Retourneert true als een rij in een tabel aan een voorwaarde voldoet.
Table.Partition Partitioneert de tabel in een lijst van groepen tabellen, gebaseerd op de waarde van de kolom in elke rij en een hashfunctie. De hash-functie wordt toegepast op de waarde van de kolom van een rij om een hash-waarde voor de rij te verkrijgen. De modulogroepen van de hash-waarde bepalen in welke van de geretourneerde tabellen de rij wordt geplaatst.
Table.PartitionValues Retourneert informatie over hoe een tabel wordt gepartitioneerd.
Table.Range Retourneert het opgegeven aantal rijen uit een tabel vanaf een offset.
Table.RemoveFirstN Retourneert een tabel met het opgegeven aantal rijen dat uit de tabel is verwijderd, beginnend bij de eerste rij. Het aantal rijen dat wordt verwijderd, is afhankelijk van de optionele parameter countOrCondition.
Table.RemoveLastN Retourneert een tabel met het opgegeven aantal rijen dat uit de tabel is verwijderd, beginnend bij de laatste rij. Het aantal rijen dat wordt verwijderd, is afhankelijk van de optionele parameter countOrCondition.
Table.RemoveRows Retourneert een tabel met het opgegeven aantal rijen dat uit de tabel is verwijderd, beginnend bij een offset.
Table.RemoveRowsWithErrors Retourneert een tabel met alle rijen die zijn verwijderd uit de tabel die een fout bevatten in ten minste één van de cellen in een rij.
Table.Repeat Retourneert een tabel waarin de rijen van de tabel het opgegeven aantal keren worden herhaald.
Table.ReplaceRows Retourneert een tabel waarbij de rijen die beginnen bij een offset en doorgaan voor het aantal, worden vervangen door de opgegeven rijen.
Table.ReverseRows Retourneert een tabel met de rijen in omgekeerde volgorde.
Table.SelectRows Retourneert een tabel die alleen de rijen bevat die overeenkomen met een voorwaarde.
Table.SelectRowsWithErrors Retourneert een tabel met alleen de rijen uit de tabel die een fout bevatten in ten minste één van de cellen in een rij.
Table.SingleRow Retourneert één rij uit een tabel.
Table.Skip Retourneert een tabel die niet de eerste rij of rijen van de tabel bevat.
Table.SplitAt Retourneert een lijst met de eerste aantal rijen die zijn opgegeven en de resterende rijen.

Kolombewerkingen

Naam Beschrijving
Table.Column Retourneert de waarden uit een kolom in een tabel.
Table.ColumnNames Retourneert de namen van kolommen uit een tabel.
Table.ColumnsOfType Retourneert een lijst met de namen van de kolommen die overeenkomen met de opgegeven typen.
Table.DemoteHeaders Hiermee wordt de koprij verlaagd naar de eerste rij van een tabel.
Table.DuplicateColumn Hiermee wordt een kolom met de opgegeven naam gedupliceerd. Waarden en typen worden gekopieerd uit de bronkolom.
Table.HasColumns Geeft aan of de tabel de opgegeven kolom(en) bevat.
Table.Pivot Gegeven een tabel met een attribuutkolom die draaitabelwaarden bevat, worden nieuwe kolommen gemaakt voor elk van de draaitabelwaarden en worden hieraan waarden toegewezen uit de waardekolom. Er kan een optionele aggregatiefunctie worden opgegeven om meerdere voorkomen van dezelfde sleutelwaarde in de kenmerkkolom te verwerken.
Table.PrefixColumns Retourneert een tabel waarin alle kolommen zijn voorafgegaan door een tekstwaarde.
Table.PromoteHeaders Bevordert de eerste rij van de tabel in de kop- of kolomnamen.
Table.RemoveColumns Retourneert een tabel zonder een specifieke kolom of kolommen.
Table.ReorderColumns Retourneert een tabel met specifieke kolommen in een volgorde ten opzichte van elkaar.
Table.RenameColumns Retourneert een tabel met de kolommen hernoemd zoals opgegeven.
Table.SelectColumns Retourneert een tabel die alleen specifieke kolommen bevat.
Table.TransformColumnNames Transformeert kolomnamen met behulp van de opgegeven functie.
Table.Unpivot Met een lijst van tabelkolommen worden deze kolommen omgezet in attribuut-waardeparen.
Table.UnpivotOtherColumns Hiermee worden alle andere kolommen dan een opgegeven set omgezet in kenmerk-waardeparen, gecombineerd met de rest van de waarden in elke rij.

Transformatie

Naam Beschrijving
Table.AddColumn Voegt een kolom met de naam newColumnName toe aan een tabel.
Table.AddFuzzyClusterColumn Voegt een nieuwe kolom toe met representatieve waarden die zijn verkregen door fuzzy groeperingswaarden van de opgegeven kolom in de tabel.
Table.AddIndexColumn Retourneert een tabel met een nieuwe kolom met een specifieke naam die voor elke rij een index van de rij in de tabel bevat.
Table.AddJoinColumn Voert een geneste join uit tussen tabel1 en tabel2 op basis van specifieke kolommen en produceert het joinresultaat als een newColumnName-kolom voor elke rij van tabel1.
Table.AddKey Voegt een sleutel toe aan een tabel.
Table.AggregateTableColumn Hiermee worden tabellen die in een specifieke kolom zijn genest, samengevoegd in meerdere kolommen met geaggregeerde waarden voor deze tabellen.
Table.CombineColumns Table.CombineColumns kolommen samenvoegt met behulp van een combinatiefunctie om een nieuwe kolom te produceren. Table.CombineColumns is de inverse van Table.SplitColumns.
Table.CombineColumnsToRecord Combineert de opgegeven kolommen in een nieuwe kolom met recordwaarden, waarbij elke record veldnamen en waarden bevat die overeenkomen met de kolomnamen en waarden van de kolommen die zijn gecombineerd.
Table.ConformToPageReader Deze functie is alleen bedoeld voor intern gebruik.
Table.ExpandListColumn Als u een kolom met lijsten in een tabel hebt, maakt u een kopie van een rij voor elke waarde in de lijst.
Table.ExpandRecordColumn Breidt een kolom met records uit in kolommen met elk van de waarden.
Table.ExpandTableColumn Hiermee breidt u een kolom met records of een kolom met tabellen uit naar meerdere kolommen in de huidige tabel.
Table.FillDown Vervangt null-waarden in de opgegeven kolom of kolommen van de tabel door de meest recente niet-null-waarde in de kolom.
Table.FillUp Retourneert een tabel uit de tabel die is opgegeven waar de waarde van de volgende cel wordt doorgegeven aan de cellen met null-waarden hierboven in de opgegeven kolom.
Table.FilterWithDataTable Deze functie is alleen bedoeld voor intern gebruik.
Table.Group Groepeert tabelrijen op basis van de waarden van sleutelkolommen voor elke rij.
Table.Join Hiermee worden de rijen van tabel1 samengevoegd met de rijen van tabel2 op basis van de gelijkheid van de waarden van de sleutelkolommen die zijn geselecteerd door tabel1, key1 en table2, key2.
Table.Keys Retourneert de sleutels van de opgegeven tabel.
Table.NestedJoin Hiermee worden de rijen van de tabellen samengevoegd op basis van de gelijkheid van de sleutels. De resultaten worden ingevoerd in een nieuwe kolom.
Table.ReplaceErrorValues Vervangt de foutwaarden in de opgegeven kolommen door de bijbehorende opgegeven waarde.
Table.ReplaceKeys Vervangt de sleutels van de opgegeven tabel.
Table.ReplaceRelationshipIdentity Deze functie is alleen bedoeld voor intern gebruik.
Table.ReplaceValue Vervangt oldValue door newValue in specifieke kolommen van een tabel, met behulp van de opgegeven vervangingsfunctie, zoals Text.Replace of Value.Replace.
Table.SplitColumn Retourneert een nieuwe set kolommen van één kolom die een splitsfunctie toepast op elke waarde.
Table.TransformColumns Hiermee worden de waarden van een of meer kolommen getransformeerd.
Table.TransformColumnTypes Transformeert de kolomtypen uit een tabel met behulp van een type.
Table.TransformRows Transformeert de rijen uit een tabel met behulp van een transformatiefunctie.
Table.Transpose Retourneert een tabel met kolommen die zijn geconverteerd naar rijen en rijen die zijn geconverteerd naar kolommen uit de invoertabel.

Lidmaatschap

Naam Beschrijving
Table.Contains Bepaalt of een record wordt weergegeven als een rij in de tabel.
Table.ContainsAll Bepaalt of alle opgegeven records worden weergegeven als rijen in de tabel.
Table.ContainsAny Bepaalt of een van de opgegeven records wordt weergegeven als rijen in de tabel.
Table.Distinct Hiermee verwijdert u dubbele rijen uit een tabel, zodat alle resterende rijen uniek zijn.
Table.IsDistinct Bepaalt of een tabel alleen afzonderlijke rijen bevat.
Table.PositionOf Bepaalt de positie of posities van een rij in een tabel.
Table.PositionOfAny Bepaalt de positie of posities van een van de opgegeven rijen in de tabel.
Table.RemoveMatchingRows Verwijdert alle rijen uit een tabel.
Table.ReplaceMatchingRows Hiermee vervangt u specifieke rijen uit een tabel door de nieuwe rijen.

Bestellen

Naam Beschrijving
Table.Max Retourneert de grootste rij of rijen uit een tabel met behulp van een vergelijkingscriterium.
Table.MaxN Retourneert de grootste N rijen uit een tabel. Nadat de rijen zijn gesorteerd, moet de parameter countOrCondition worden opgegeven om het resultaat verder te filteren.
Table.Min Retourneert de kleinste rij of rijen uit een tabel met behulp van een comparisonCriteria.
Table.MinN Retourneert de kleinste N rijen in de opgegeven tabel. Nadat de rijen zijn gesorteerd, moet de parameter countOrCondition worden opgegeven om het resultaat verder te filteren.
Table.AddRankColumn Voegt een kolom toe met de rangschikking van een of meer andere kolommen.
Table.Sort Sorteert de rijen in een tabel met behulp van een comparisonCriteria of een standaardvolgorde als deze niet is opgegeven.

Ander

Naam Beschrijving
Table.Buffer Buffert een tabel in het geheugen, waarbij deze wordt geïsoleerd van externe wijzigingen tijdens de evaluatie.

Parameterwaarden

Uitvoerkolommen een naam geven

Deze parameter is een lijst met tekstwaarden die de kolomnamen van de resulterende tabel opgeven. Deze parameter wordt over het algemeen gebruikt in de tabelconstructiefuncties, zoals Table.FromRows en Table.FromList.

Vergelijkingscriteria

Het vergelijkingscriterium kan worden opgegeven als een van de volgende waarden:

  • Een getalwaarde om een sorteervolgorde op te geven. Meer informatie: volgorde van sorteren

  • Als u een sleutel wilt berekenen die moet worden gebruikt voor sorteren, kunt u een functie van één argument gebruiken.

  • Als u zowel een sleutel als een controlevolgorde wilt selecteren, kan het vergelijkingscriterium een lijst met de sleutel en volgorde zijn.

  • Om de vergelijking volledig te beheren, kan een functie van twee argumenten worden gebruikt die -1, 0 of 1 retourneert op basis van de relatie tussen de linker- en rechterinvoer. Value.Compare kan worden gebruikt om deze logica te delegeren.

Ga voor voorbeelden naar de beschrijving van Table.Sort.

Criteria voor aantal of voorwaarde

Deze criteria worden over het algemeen gebruikt bij volgorde- of rijbewerkingen. Het bepaalt het aantal rijen dat in de tabel wordt geretourneerd en kan twee vormen hebben, een getal of een voorwaarde.

  • Een getal geeft aan hoeveel waarden in lijn met de juiste functie moeten worden geretourneerd.

  • Als er een voorwaarde is opgegeven, worden de rijen met waarden die in eerste instantie voldoen aan de voorwaarde geretourneerd. Zodra een waarde niet voldoet aan de voorwaarde, worden er geen verdere waarden in aanmerking genomen.

Meer informatie: Table.FirstN, Table.MaxN

Verwerking van extra waarden

Extra waarden worden gebruikt om aan te geven hoe de functie extra waarden in een rij moet verwerken. Deze parameter wordt opgegeven als een getal, dat wordt toegewezen aan de volgende opties:

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

Meer informatie: Table.FromList, ExtraValues.Type

Afhandeling van ontbrekende kolommen

Deze parameter wordt gebruikt om aan te geven hoe de functie ontbrekende kolommen moet verwerken. Deze parameter wordt opgegeven als een getal, dat wordt toegewezen aan de volgende opties:

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

Deze parameter wordt gebruikt in kolom- of transformatiebewerkingen, bijvoorbeeld in Table.TransformColumns. Meer informatie: MissingField.Type

Sorteervolgorde

Sorteervolgorde wordt gebruikt om aan te geven hoe de resultaten moeten worden gesorteerd. Deze parameter wordt opgegeven als een getal, dat wordt toegewezen aan de volgende opties:

Order.Ascending = 0 Order.Descending = 1

Meer informatie: Order.Type

Vergelijkingscriteria

Vergelijkingscriteria voor tabellen kunnen worden opgegeven als:

  • Een functiewaarde die een van de volgende is:

    • Een sleutelkiezer die de kolom in de tabel bepaalt om de gelijkheidscriteria toe te passen.

    • Een vergelijkingsfunctie die wordt gebruikt om het soort vergelijking op te geven dat moet worden toegepast. Ingebouwde vergelijkingsfuncties kunnen worden opgegeven. Meer informatie: Vergelijkingsfuncties

  • Een lijst met de kolommen in de tabel om de gelijkheidscriteria toe te passen.

Ga voor voorbeelden naar de beschrijving van Table.Distinct.