Funzioni per le tabelle

Queste funzioni creano e manipolano valori di tabella.

Creazione di tabelle

Nome	Descrizione
ItemExpression.From	Restituisce l'albero della sintassi astratta (AST) per il corpo di una funzione.
ItemExpression.Item	Albero della sintassi astratta (AST) che rappresenta l’elemento in un'espressione di elemento.
RowExpression.Column	Restituisce un albero della sintassi astratta (AST) che rappresenta l'accesso a una colonna all'interno di un'espressione di riga.
RowExpression.From	Restituisce l'albero della sintassi astratta (AST) per il corpo di una funzione.
RowExpression.Row	Nodo AST (albero della sintassi astratta) che rappresenta la riga in un'espressione di riga.
Table.FromColumns	Restituisce una tabella da un elenco contenente elenchi annidati con i nomi e i valori delle colonne.
Table.FromList	Converte un elenco in una tabella applicando la funzione di divisione specificata a ogni elemento nell'elenco.
Table.FromRecords	Restituisce una tabella da un elenco di record.
Table.FromRows	Crea una tabella dall'elenco in cui ogni elemento dell'elenco è un elenco contenente i valori di colonna per una singola riga.
Table.FromValue	Restituisce una tabella con una colonna contenente il valore o l'elenco di valori specificato.
Table.FuzzyGroup	Raggruppa le righe di una tabella tramite corrispondenza fuzzy dei valori nella colonna specificata per ogni riga.
Table.FuzzyJoin	Unisce in join le righe di due tabelle in cui è stata rilevata una corrispondenza fuzzy in base alle chiavi specificate.
Table.FuzzyNestedJoin	Esegue un join fuzzy tra tabelle per le colonne specificate e fornisce il risultato del join in una nuova colonna.
Table.Split	Divide la tabella specificata in un elenco di tabelle usando le dimensioni di pagina specificate.
Table.WithErrorContext	Questa funzione è solo per uso interno.
Table.View	Crea o estende una tabella con gestori definiti dall'utente per operazioni di query e azione.
Table.ViewError	Crea un record di errore modificato che non attiva un fallback quando viene generato da un gestore definito in una vista (tramite Table.View).
Table.ViewFunction	Crea una funzione che può essere intercettata da un gestore definito in una vista (tramite Table.View).

Conversioni

Nome	Descrizione
Table.ToColumns	Restituisce un elenco di elenchi annidati, ognuno dei quali rappresenta una colonna di valori nella tabella di input.
Table.ToList	Restituisce una tabella in un elenco applicando la funzione di combinazione specificata a ogni riga di valori in una tabella.
Table.ToRecords	Restituisce un elenco di record da una tabella di input.
Table.ToRows	Restituisce un elenco annidato di valori di riga da una tabella di input.

Informazioni

Nome	Descrizione
Table.ApproximateRowCount	Restituisce il numero approssimativo di righe nella tabella.
Table.ColumnCount	Restituisce il numero di colonne in una tabella.
Table.IsEmpty	Restituisce true se la tabella non contiene righe.
Table.Profile	Restituisce un profilo delle colonne di una tabella.
Table.RowCount	Restituisce il numero di righe in una tabella.
Table.Schema	Restituisce una tabella contenente una descrizione delle colonne, ovvero lo schema, della tabella specificata.
Tables.GetRelationships	Restituisce le relazioni tra un set di tabelle.

Operazioni su righe

Nome	Descrizione
Table.AlternateRows	Restituisce una tabella contenente le righe di una tabella alternate in base a uno schema specificato.
Table.Combine	Restituisce una tabella che rappresenta il risultato dell'unione di un elenco di tabelle. Tutte le tabelle devono avere la stessa struttura del tipo di riga.
Table.FindText	Restituisce una tabella contenente solo le righe che hanno il testo specificato all'interno di una delle rispettive celle o di una parte di essa.
Table.First	Restituisce la prima riga di una tabella.
Table.FirstN	Restituisce la prima riga o le prime righe di una tabella, a seconda del parametro countOrCondition.
Table.FirstValue	Restituisce la prima colonna della prima riga della tabella o un valore predefinito specificato.
Table.FromPartitions	Restituisce una tabella che rappresenta il risultato della combinazione di un set di tabelle partizionate in nuove colonne. È possibile specificare facoltativamente il tipo della colonna. Il valore predefinito è any.
Table.InsertRows	Restituisce una tabella con l'elenco di righe inserite nella tabella in corrispondenza di un indice. Ogni riga da inserire deve corrispondere al tipo di riga della tabella.
Table.Last	Restituisce l'ultima riga di una tabella.
Table.LastN	Restituisce le ultime righe di una tabella, a seconda del parametro countOrCondition.
Table.MatchesAllRows	Restituisce true se tutte le righe in una tabella soddisfano una condizione.
Table.MatchesAnyRows	Restituisce true se qualsiasi riga in una tabella soddisfa una condizione.
Table.Partition	Esegue il partizionamento della tabella in un elenco di numero di tabelle (groups), in base al valore della colonna di ogni riga e a una funzione hash. La funzione hash viene applicata al valore della colonna di una riga per ottenere un valore hash per la riga. Il valore groups per il modulo del valore hash determina in quale delle tabelle restituite verrà posizionata la riga.
Table.PartitionValues	Restituisce le informazioni sulla modalità di partizionamento di una tabella.
Table.Range	Restituisce il numero specificato di righe da una tabella a partire da un offset.
Table.RemoveFirstN	Restituisce una tabella con il numero specificato di righe rimosse dalla tabella a partire dalla prima riga. Il numero di righe rimosse dipende dal parametro countOrCondition facoltativo.
Table.RemoveLastN	Restituisce una tabella con il numero specificato di righe rimosse dalla tabella a partire dall'ultima riga. Il numero di righe rimosse dipende dal parametro countOrCondition facoltativo.
Table.RemoveRows	Restituisce una tabella con il numero specificato di righe rimosse dalla tabella a partire da un offset.
Table.RemoveRowsWithErrors	Restituisce una tabella con tutte le righe rimosse dalla tabella che contengono un errore in almeno una delle celle in una riga.
Table.Repeat	Restituisce una tabella contenente le righe della tabella ripetute per il numero di volte specificato da count.
Table.ReplaceRows	Restituisce una tabella in cui le righe a partire da un offset e che continuano per il valore specificato da count vengono sostituite con le righe fornite.
Table.ReverseRows	Restituisce una tabella con le righe nell'ordine inverso.
Table.SelectRows	Restituisce una tabella contenente solo le righe che corrispondono a una condizione.
Table.SelectRowsWithErrors	Restituisce una tabella con solo le righe della tabella che contengono un errore in almeno una delle celle in una riga.
Table.SingleRow	Restituisce una singola riga da una tabella.
Table.Skip	Restituisce una tabella che non contiene la prima riga o le prime righe della tabella.
Table.SplitAt	Restituisce un elenco che contiene le prime righe del conteggio specificate e le righe rimanenti.

Operazioni su colonne

Nome	Descrizione
Table.Column	Restituisce i valori da una colonna in una tabella.
Table.ColumnNames	Restituisce i nomi delle colonne da una tabella.
Table.ColumnsOfType	Restituisce un elenco con i nomi delle colonne corrispondenti ai tipi specificati.
Table.DemoteHeaders	Abbassa la riga di intestazione nella prima riga di una tabella.
Table.DuplicateColumn	Duplica una colonna con il nome specificato. I valori e il tipo vengono copiati dalla colonna di origine.
Table.HasColumns	Indica se la tabella contiene le colonne specificate.
Table.Pivot	Data una tabella e una colonna attributo contenente pivotValues, crea nuove colonne per ogni valore pivot e assegna valori alle colonne da valueColumn. È possibile specificare il parametro aggregationFunction facoltativo per gestire più occorrenze dello stesso valore di chiave nella colonna attributo.
Table.PrefixColumns	Restituisce una tabella in cui a tutte le colonne è stato aggiunto un prefisso con il valore di testo specificato.
Table.PromoteHeaders	Promuove la prima riga della tabella nei nomi di intestazione o di colonna.
Table.RemoveColumns	Restituisce una tabella senza una colonna o colonne specifiche.
Table.ReorderColumns	Restituisce una tabella con colonne specifiche in un determinato ordine l'una rispetto all'altra.
Table.RenameColumns	Restituisce una tabella con le colonne rinominate come specificato.
Table.SelectColumns	Restituisce una tabella che contiene solo colonne specifiche.
Table.TransformColumnNames	Trasforma i nomi di colonna usando la funzione specificata.
Table.Unpivot	Dato un elenco di colonne della tabella, trasforma le colonne in coppie attributo-valore.
Table.UnpivotOtherColumns	Converte tutte le colonne ad eccezione di un set specificato in coppie attributo-valore, combinate con i valori restanti in ogni riga.

Trasformazione

Nome	Descrizione
Table.AddColumn	Aggiunge una colonna denominata newColumnName a una tabella.
Table.AddFuzzyClusterColumn	Aggiunge una nuova colonna con valori rappresentativi ottenuti dai valori di raggruppamento fuzzy della colonna specificata nella tabella.
Table.AddIndexColumn	Restituisce una tabella con una nuova colonna con un nome specifico che, per ogni riga, contiene un indice della riga nella tabella.
Table.AddJoinColumn	Esegue un join annidato tra table1 e table2 da colonne specifiche e produce il risultato del join come colonna newColumnName per ogni riga di table1.
Table.AddKey	Aggiunge una chiave alla tabella.
Table.AggregateTableColumn	Aggrega le tabelle annidate in una colonna specifica in più colonne contenenti i valori aggregati per tali tabelle.
Table.CombineColumns	Table.CombineColumns unisce le colonne usando una funzione di combinazione per produrre una nuova colonna. Table.CombineColumns è l'inverso di Table.SplitColumns.
Table.CombineColumnsToRecord	Combina le colonne specificate in una nuova colonna di record con valori in cui ogni record ha nomi di campo e valori corrispondenti ai nomi di colonna e ai valori delle colonne che sono state combinate.
Table.ConformToPageReader	Questa funzione è solo per uso interno.
Table.ExpandListColumn	Data una colonna di elenchi in una tabella, crea una copia di una riga per ogni valore nell'elenco.
Table.ExpandRecordColumn	Espande una colonna di record in colonne con ciascuno dei valori.
Table.ExpandTableColumn	Espande una colonna di record o una colonna di tabelle in più colonne nella tabella che la contiene.
Table.FillDown	Sostituisce i valori Null nella colonna o nelle colonne specificate della tabella con il valore non Null più recente nella colonna.
Table.FillUp	Restituisce una tabella dalla tabella specificata, dove il valore della cella successiva viene propagato alle celle con valori Null nella parte superiore nella colonna specificata.
Table.FilterWithDataTable	Questa funzione è solo per uso interno.
Table.Group	Raggruppa le righe della tabella in base ai valori delle colonne chiave per ogni riga.
Table.Join	Unisce le righe di table1 alle righe di table2 in base all'uguaglianza dei valori delle colonne chiave selezionate da table1, key1 e table2, key2.
Table.Keys	Restituisce le chiavi della tabella specificata.
Table.NestedJoin	Unisce in join le righe delle tabelle in base all'uguaglianza delle chiavi. I risultati vengono immessi in una nuova colonna.
Table.ReplaceErrorValues	Sostituisce i valori di errore nelle colonne specificate con il valore corrispondente specificato.
Table.ReplaceKeys	Sostituisce le chiavi della tabella specificata.
Table.ReplaceRelationshipIdentity	Questa funzione è solo per uso interno.
Table.ReplaceValue	Sostituisce oldValue con newValue in colonne specifiche di una tabella, usando la funzione di sostituzione specificata, ad esempio text.Replace o Value.Replace.
Table.SplitColumn	Restituisce un nuovo set di colonne di una singola colonna applicando una funzione di suddivisione a ogni valore.
Table.TransformColumns	Trasforma i valori di una o più colonne.
Table.TransformColumnTypes	Trasforma i tipi di colonna da una tabella usando un tipo.
Table.TransformRows	Trasforma le righe da una tabella usando una funzione di trasformazione.
Table.Transpose	Restituisce una tabella con le colonne convertite in righe e le righe convertite in colonne dalla tabella di input.

Appartenenze

Nome	Descrizione
Table.Contains	Determina se il record specificato viene visualizzato come riga nella tabella.
Table.ContainsAll	Determina se tutti i record specificati vengono visualizzati come righe nella tabella.
Table.ContainsAny	Determina se uno dei record specificati viene visualizzato come riga nella tabella.
Table.Distinct	Rimuove le righe duplicate da una tabella, assicurando che tutte le righe rimanenti siano distinte.
Table.IsDistinct	Determina se una tabella contiene solo righe distinte.
Table.PositionOf	Determina la posizione o le posizioni di una riga all'interno di una tabella.
Table.PositionOfAny	Determina la posizione o le posizioni di una delle righe specificate all'interno della tabella.
Table.RemoveMatchingRows	Rimuove tutte le occorrenze delle righe da una tabella.
Table.ReplaceMatchingRows	Sostituisce righe specifiche di una tabella con nuove righe.

Creazione dell'ordine

Nome	Descrizione
Table.Max	Restituisce la riga o le righe più grandi di una tabella usando un comparisonCriteria.
Table.MaxN	Restituisce il numero N di righe più grandi da una tabella. Dopo l'ordinamento delle righe è necessario specificare il parametro countOrCondition per filtrare ulteriormente il risultato.
Table.Min	Restituisce la riga o le righe più piccole di una tabella usando un comparisonCriteria.
Table.MinN	Restituisce il numero N di righe più piccole nella tabella specificata. Dopo l'ordinamento delle righe è necessario specificare il parametro countOrCondition per filtrare ulteriormente il risultato.
Table.AddRankColumn	Aggiunge una colonna con la classificazione di una o più colonne.
Table.Sort	Consente di ordinare le righe di una tabella usando comparisonCriteria o un ordinamento predefinito se non ne viene specificato uno.

Altro

Nome	Descrizione
Table.Buffer	Memorizza nel buffer una tabella in memoria, isolandola da modifiche esterne durante la valutazione.

Valori di parametri

Denominazione delle colonne di output

Questo parametro è un elenco di valori di testo che specificano i nomi di colonna della tabella risultante. Questo parametro viene in genere usato nelle funzioni di costruzione della tabella, ad esempio Table.FromRows e Table.FromList.

Criteri di confronto

Il criterio di confronto può essere specificato con uno dei valori seguenti:

• Valore numerico per specificare un ordinamento. Altre informazioni: Ordinamento

• Per calcolare una chiave da usare per l'ordinamento, è possibile usare una funzione di 1 argomento.

• Per selezionare sia una chiave che l'ordine, il criterio di confronto può essere un elenco contenente la chiave e l'ordine.

• Per controllare completamente il confronto, è possibile usare una funzione di due argomenti che restituisce -1, 0 o 1 in base alla relazione tra gli input sinistro e destro. Value.Compare può essere usato per delegare questa logica.

Per esempi, passare alla descrizione di Table.Sort.

Criteri di numero o condizione

Questi criteri vengono usati in genere nelle operazioni di ordinamento o sulle righe. Determinano il numero di righe restituite nella tabella e possono assumere due forme, un numero o una condizione:

• Un numero indica il numero di valori da restituire inline con la funzione appropriata

• Se viene specificata una condizione, vengono restituite le righe contenenti i valori che inizialmente soddisfano la condizione. Se un valore non soddisfa la condizione, non vengono considerati altri valori.

Altre informazioni: Table.FirstN, Table.MaxN

Gestione di valori aggiuntivi

I valori aggiuntivi vengono usati per indicare il modo in cui la funzione deve gestire i valori aggiuntivi in una riga. Questo parametro viene specificato come numero, che esegue il mapping alle opzioni seguenti:

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

Altre informazioni: Table.FromList, ExtraValues.Type

Gestione delle colonne mancanti

Questo parametro viene usato per indicare il modo in cui la funzione deve gestire le colonne mancanti. Questo parametro viene specificato come numero, che esegue il mapping alle opzioni seguenti:

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

Questo parametro viene usato nelle operazioni di colonna o trasformazione, ad esempio, in Table.TransformColumns. Altre informazioni: MissingField.Type

Ordinamento

Questo parametro viene usato per indicare il modo in cui devono essere ordinati i risultati. Questo parametro viene specificato come numero, che esegue il mapping alle opzioni seguenti:

Order.Ascending = 0 Order.Descending = 1

Altre informazioni: Order.Type

Criteri di uguaglianza

I criteri di uguaglianza per le tabelle possono essere specificati come:

• Valore di funzione che può essere:

  • Un selettore di chiave che determina la colonna della tabella a cui applicare i criteri di uguaglianza.

  • Una funzione di confronto usata per specificare il tipo di confronto da applicare. È possibile specificare funzioni di confronto predefinite. Altre informazioni: Funzioni di confronto

• Elenco delle colonne nella tabella a cui applicare i criteri di uguaglianza.

Per esempi, passare alla descrizione di Table.Distinct.