Tabelfuncties

Met deze functies worden tabelwaarden gemaakt en bewerkt.

Tabelconstructie

Naam	Beschrijving
#table	Hiermee maakt u een tabelwaarde op basis van kolommen en rijen.
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	Hiermee maakt u een tabel op basis van een lijst met kolommen en opgegeven waarden.
Table.FromList	Converteert een lijst naar een tabel door de opgegeven splitsfunctie toe te passen op elk item in de lijst.
Table.FromRecords	Converteert een lijst met records naar een tabel.
Table.FromRows	Hiermee maakt u een tabel op basis van een lijst met rijwaarden en optionele kolommen.
Table.FromValue	Hiermee maakt u een tabel met een kolom op basis van de opgegeven waarde of waarden.
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	Hiermee maakt u een lijst met nestlijsten van kolomwaarden uit een tabel.
Table.ToList	Converteert een tabel naar een lijst door de opgegeven combinatiefunctie toe te passen op elke rij met waarden in de tabel.
Table.ToRecords	Converteert een tabel naar een lijst met records.
Table.ToRows	Hiermee maakt u een geneste lijst van lijsten met rijwaarden uit een tabel.

Informatie

Naam	Beschrijving
Table.ApproximateRowCount	Retourneert het geschatte aantal rijen in de tabel.
Table.ColumnCount	Retourneert het aantal kolommen in de tabel.
Table.IsEmpty	Geeft aan of de tabel rijen bevat.
Table.PartitionValues	Retourneert informatie over hoe een tabel wordt gepartitioneerd.
Table.Profile	Retourneert een profiel van de kolommen van een tabel.
Table.RowCount	Retourneert het aantal rijen in de tabel.
Table.Schema	Retourneert een tabel met een beschrijving van de kolommen (dat wil gezegd het schema) van de opgegeven tabel.
Tables.GetRelationships	Verkrijgt de relaties tussen een reeks tabellen.

Rijbewerkingen

Naam	Beschrijving
Table.AlternateRows	Houdt de initiële offset aan en wisselt vervolgens het nemen en overslaan van de volgende rijen af.
Table.Combine	Retourneert een tabel die het resultaat is van het samenvoegen van een lijst met tabellen.
Table.FindText	Retourneert alle rijen die de opgegeven tekst in de tabel bevatten.
Table.First	Retourneert de eerste rij of een opgegeven standaardwaarde.
Table.FirstN	Retourneert de eerste aantal rijen die zijn opgegeven.
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.
Table.InsertRows	Hiermee voegt u een lijst met rijen in de tabel in op de opgegeven positie.
Table.Last	Retourneert de laatste rij of een opgegeven standaardwaarde.
Table.LastN	Retourneert het laatst opgegeven aantal rijen.
Table.MatchesAllRows	Geeft aan of alle rijen in de tabel voldoen aan de opgegeven voorwaarde.
Table.MatchesAnyRows	Geeft aan of de rijen in de tabel voldoen aan de opgegeven voorwaarde.
Table.Partition	Partitioneert de tabel in een lijst met tabellen op basis van het aantal groepen en de opgegeven kolom.
Table.Range	Retourneert de rijen die beginnen bij de opgegeven offset.
Table.RemoveFirstN	Retourneert een tabel met het opgegeven aantal rijen dat uit de tabel is verwijderd, beginnend bij de eerste rij.
Table.RemoveLastN	Retourneert een tabel met het opgegeven aantal rijen dat uit de tabel is verwijderd, beginnend bij de laatste rij.
Table.RemoveRows	Hiermee verwijdert u het opgegeven aantal rijen.
Table.RemoveRowsWithErrors	Retourneert een tabel met de rijen die zijn verwijderd uit de invoertabel die een fout bevatten in ten minste één van de cellen. Als er een lijst met kolommen is opgegeven, worden alleen de cellen in de opgegeven kolommen gecontroleerd op fouten.
Table.Repeat	Herhaalt de rijen van de tabellen een opgegeven aantal keren.
Table.ReplaceRows	Vervangt het opgegeven bereik van rijen door de opgegeven rij of rijen.
Table.ReverseRows	Retourneert een tabel met de rijen in omgekeerde volgorde.
Table.SelectRows	Selecteert de rijen die voldoen aan de voorwaardefunctie.
Table.SelectRowsWithErrors	Retourneert een tabel met alleen de rijen van de invoertabel die een fout bevatten in ten minste één van de cellen. Als er een lijst met kolommen is opgegeven, worden alleen de cellen in de opgegeven kolommen gecontroleerd op fouten.
Table.SingleRow	Retourneert één rij in de tabel.
Table.Skip	Retourneert een tabel met het eerste opgegeven aantal rijen dat is overgeslagen.
Table.SplitAt	Retourneert een lijst met de eerste aantal rijen die zijn opgegeven en de resterende rijen.

Kolombewerkingen

Naam	Beschrijving
Table.Column	Retourneert een opgegeven kolom met gegevens uit de tabel als een lijst.
Table.ColumnNames	Retourneert de kolomnamen als een lijst.
Table.ColumnsOfType	Retourneert een lijst met de namen van de kolommen die overeenkomen met de opgegeven typen.
Table.DemoteHeaders	De kolomkoppen degraderen naar de eerste rij met waarden.
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 of kolommen bevat.
Table.Pivot	Met een paar kolommen die kenmerk-waardeparen vertegenwoordigen, zet u de gegevens in de kenmerkkolom om naar kolomkoppen.
Table.PrefixColumns	Retourneert een tabel waarin alle kolommen zijn voorafgegaan door de opgegeven tekst.
Table.PromoteHeaders	Bevordert de eerste rij met waarden als de nieuwe kolomkoppen (dat wil gezegd, als kolomnamen).
Table.RemoveColumns	Hiermee verwijdert u de opgegeven kolommen.
Table.ReorderColumns	Retourneert een tabel met de kolommen in de opgegeven volgorde.
Table.RenameColumns	Retourneert een tabel met de kolommen hernoemd zoals opgegeven.
Table.SelectColumns	Retourneert een tabel met alleen de opgegeven kolommen.
Table.TransformColumnNames	Transformeert kolomnamen met behulp van de opgegeven functie.
Table.Unpivot	Hiermee wordt een set kolommen in een tabel omgezet in kenmerk-waardeparen.
Table.UnpivotOtherColumns	Hiermee worden alle andere kolommen dan een opgegeven set omgezet in kenmerk-waardeparen.

Transformatie

Naam	Beschrijving
Table.AddColumn	Hiermee voegt u een kolom met de opgegeven naam toe. De waarde wordt berekend met behulp van de opgegeven selectiefunctie, waarbij elke rij als invoer wordt genomen.
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	Voegt een kolom toe met expliciete positiewaarden.
Table.AddJoinColumn	Voert een join uit tussen tabellen in opgegeven kolommen en produceert het joinresultaat in een nieuwe kolom.
Table.AddKey	Voegt een sleutel toe aan een tabel.
Table.AggregateTableColumn	Hiermee wordt een kolom van tabellen verkleind tot meerdere kolommen in de omvattende tabel.
Table.CombineColumns	Combineert de opgegeven kolommen in een nieuwe kolom met behulp van de opgegeven combinatiefunctie.
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	Hiermee wordt de waarde van een vorige cel doorgegeven aan de cellen met null-waarden eronder in de kolom.
Table.FillUp	Hiermee wordt de waarde van een cel doorgegeven aan de cellen met null-waarden hierboven in de kolom.
Table.FilterWithDataTable	Deze functie is alleen bedoeld voor intern gebruik.
Table.FuzzyGroup	Groepeert rijen in de tabel op basis van fuzzy overeenkomsten van sleutels.
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.Group	Groepeert rijen in de tabel die dezelfde sleutel hebben.
Table.Join	Hiermee worden de rijen uit de twee tabellen samengevoegd die overeenkomen op basis van de opgegeven sleutels.
Table.Keys	Retourneert de sleutels van de opgegeven tabel.
Table.NestedJoin	Voert een join uit tussen tabellen in opgegeven kolommen en produceert het joinresultaat 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	Hiermee vervangt u de ene waarde door een andere waarde in de opgegeven kolommen.
Table.Split	Hiermee wordt de opgegeven tabel gesplitst in een lijst met tabellen met behulp van het opgegeven paginaformaat.
Table.SplitColumn	Splitst de opgegeven kolommen in een set extra kolommen met behulp van de opgegeven splitsfunctie.
Table.TransformColumns	Hiermee worden de waarden van een of meer kolommen getransformeerd.
Table.TransformColumnTypes	Hiermee past u typetransformatie(s) van het formulier { kolom, type } toe met behulp van een specifieke cultuur.
Table.TransformRows	Transformeert de rijen van de tabel met behulp van de opgegeven transformatiefunctie.
Table.Transpose	Hiermee maakt u kolommen in rijen en rijen in kolommen.

Lidmaatschap

Naam	Beschrijving
Table.Contains	Geeft aan of de opgegeven record wordt weergegeven als een rij in de tabel.
Table.ContainsAll	Geeft aan of alle opgegeven records worden weergegeven als rijen in de tabel.
Table.ContainsAny	Geeft aan of een van de opgegeven records wordt weergegeven als rijen in de tabel.
Table.Distinct	Hiermee verwijdert u dubbele rijen uit de tabel.
Table.IsDistinct	Geeft aan of de tabel alleen afzonderlijke rijen bevat (geen duplicaten).
Table.PositionOf	Retourneert de positie of posities van de rij in de tabel.
Table.PositionOfAny	Retourneert de positie of posities van een van de opgegeven rijen in de tabel.
Table.RemoveMatchingRows	Hiermee verwijdert u alle voorkomens van de opgegeven rijen uit de tabel.
Table.ReplaceMatchingRows	Vervangt alle opgegeven rijen door de opgegeven rij of rijen.

Bestellen

Naam	Beschrijving
Table.AddRankColumn	Voegt een kolom toe met de rangschikking van een of meer andere kolommen.
Table.Max	Retourneert de grootste rij of standaardwaarde met behulp van de opgegeven criteria.
Table.MaxN	Retourneert de grootste rij of rijen met behulp van de opgegeven criteria.
Table.Min	Retourneert de kleinste rij of een standaardwaarde met behulp van de opgegeven criteria.
Table.MinN	Retourneert de kleinste rij of rijen met behulp van de opgegeven criteria.
Table.Sort	Hiermee sorteert u de tabel met behulp van een of meer kolomnamen en vergelijkingscriteria.

Ander

Naam	Beschrijving
Table.Buffer	Buffert een tabel in het geheugen, waarbij deze wordt geïsoleerd van externe wijzigingen tijdens de evaluatie.
Table.StopFolding	Hiermee voorkomt u dat downstreamprocessen tegen de oorspronkelijke bron van de gegevens worden uitgevoerd.

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.