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 abstract ast-knooppunt (syntaxisstructuur) dat het item in 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 abstract ast-knooppunt (syntaxisstructuur) 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	Hiermee worden de rijen uit de twee tabellen samengevoegd die fuzzy 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	Hiermee maakt u een gewijzigde foutrecord die geen terugval activeert wanneer deze wordt gegenereerd door een handler die is gedefinieerd in een weergave (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.

Gegevens

Naam	Beschrijving
Table.ApproximateRowCount	Retourneert het geschatte aantal rijen in de tabel.
Table.ColumnCount	Retourneert het aantal kolommen in een tabel.
Table.IsEmpty	Retourneert waar 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 waar als een van de rijen in een tabel aan een voorwaarde voldoet.
Table.Partition	Partitioneert de tabel in een lijst met groepen van het aantal tabellen, op basis van de waarde van de kolom van elke rij en een hash-functie. 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 met de rijen van de tabel die het aantal keren hebben 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 veldnamenrij omlaag verplaatst 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	Op basis van een tabel- en kenmerkkolom met pivotValues maakt u nieuwe kolommen voor elk van de draaitabelwaarden en wijst u deze waarden toe uit de valueColumn. Er kan een optionele aggregationFunction worden opgegeven voor het afhandelen van meerdere exemplaren van dezelfde sleutelwaarde in de kenmerkkolom.
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 naam van de kolommen die zijn gewijzigd 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 met tabelkolommen worden deze kolommen omgezet in kenmerk-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 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 voegt kolommen samen 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 tabel die de tabel bevat.
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 tekst. Vervangen 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.Transponeren	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	Hiermee verwijdert u alle exemplaren van rijen uit een tabel.
Table.ReplaceMatchingRows	Hiermee vervangt u specifieke rijen uit een tabel door de nieuwe rijen.

Ordenen

Naam	Beschrijving
Table.Max	Retourneert de grootste rij of rijen uit een tabel met behulp van een comparisonCriteria.
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.

Anders

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 doorgaans gebruikt in de functies Tabelconstructie, 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: Sorteervolgorde

• 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.

Voor voorbeelden gaat u 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 inline moeten worden geretourneerd met de juiste functie.

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

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

Ontbrekende kolomafhandeling

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: Comparer-functies

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

Voor voorbeelden gaat u naar de beschrijving van Table.Distinct.