Funzioni per le tabelle

Queste funzioni creano e manipolano valori di tabella.

Creazione di tabelle

Nome	Descrizione
#table	Crea un valore di tabella da colonne e righe.
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	Crea una tabella da un elenco di colonne e valori specificati.
Table.FromList	Converte un elenco in una tabella applicando la funzione di divisione specificata a ogni elemento nell'elenco.
Table.FromRecords	Converte un elenco di record in una tabella.
Table.FromRows	Crea una tabella da un elenco di valori di riga e colonne facoltative.
Table.FromValue	Crea una tabella con una colonna dal valore o dai valori specificati.
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 attiverà 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	Crea un elenco di elenchi annidati di valori di colonna da una tabella.
Table.ToList	Converte una tabella in un elenco applicando la funzione di combinazione specificata a ogni riga di valori nella tabella.
Table.ToRecords	Converte una tabella in un elenco di record.
Table.ToRows	Crea un elenco di elenchi annidati di valori di riga da una tabella.

Informazioni

Nome	Descrizione
Table.ApproximateRowCount	Restituisce il numero approssimativo di righe nella tabella.
Table.ColumnCount	Restituisce il numero di colonne nella tabella.
Table.IsEmpty	Indica se la tabella contiene alcune righe.
Table.PartitionValues	Restituisce le informazioni sulla modalità di partizionamento di una tabella.
Table.Profile	Restituisce un profilo delle colonne di una tabella.
Table.RowCount	Restituisce il numero di righe nella tabella.
Table.Schema	Restituisce una tabella contenente una descrizione delle colonne, ovvero lo schema, della tabella specificata.
Tables.GetRelationships	Ottiene le relazioni tra un set di tabelle.

Operazioni su righe

Nome	Descrizione
Table.AlternateRows	Mantiene l'offset iniziale, quindi alterna l'acquisizione e l'omissione delle righe seguenti.
Table.Combine	Restituisce una tabella che rappresenta il risultato dell'unione di un elenco di tabelle.
Table.FindText	Restituisce tutte le righe che contengono il testo specificato nella tabella.
Table.First	Restituisce la prima riga o un valore predefinito specificato.
Table.FirstN	Restituisce le prime righe conteggio specificate.
Table.FirstValue	Restituisce la prima colonna della prima riga della tabella o un valore predefinito specificato.
Table.FromPartitions	Restituisce una tabella risultante dalla combinazione di un set di tabelle partizionate.
Table.InsertRows	Inserisce un elenco di righe nella tabella nella posizione specificata.
Table.Last	Restituisce l'ultima riga o un valore predefinito specificato.
Table.LastN	Restituisce l'ultimo numero specificato di righe.
Table.MatchesAllRows	Indica se tutte le righe della tabella soddisfano la condizione specificata.
Table.MatchesAnyRows	Indica se le righe della tabella soddisfano la condizione specificata.
Table.Partition	Partiziona la tabella in un elenco di tabelle in base al numero di gruppi e colonna specificati.
Table.Range	Restituisce le righe che iniziano in corrispondenza dell'offset specificato.
Table.RemoveFirstN	Restituisce una tabella con il numero specificato di righe rimosse dalla tabella a partire dalla prima riga.
Table.RemoveLastN	Restituisce una tabella con il numero specificato di righe rimosse dalla tabella a partire dall'ultima riga.
Table.RemoveRows	Rimuove il numero specificato di righe.
Table.RemoveRowsWithErrors	Restituisce una tabella con le righe rimosse dalla tabella di input che contengono un errore in almeno una delle celle. Se viene specificato un elenco di colonne, vengono esaminate solo le celle nelle colonne specificate per individuare gli errori.
Table.Repeat	Ripete le righe delle tabelle un numero specificato di volte.
Table.ReplaceRows	Sostituisce l'intervallo specificato di righe con la riga o le righe specificate.
Table.ReverseRows	Restituisce una tabella con le righe nell'ordine inverso.
Table.SelectRows	Seleziona le righe che soddisfano la funzione condizione.
Table.SelectRowsWithErrors	Restituisce una tabella con solo le righe della tabella di input che contengono un errore in almeno una delle celle. Se viene specificato un elenco di colonne, vengono esaminate solo le celle nelle colonne specificate per individuare gli errori.
Table.SingleRow	Restituisce una singola riga nella tabella.
Table.Skip	Restituisce una tabella con il primo numero specificato di righe ignorate.
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 una colonna di dati specificata dalla tabella come elenco.
Table.ColumnNames	Restituisce i nomi delle colonne come elenco.
Table.ColumnsOfType	Restituisce un elenco con i nomi delle colonne corrispondenti ai tipi specificati.
Table.DemoteHeaders	Abbassa di livello le intestazioni di colonna alla prima riga di valori.
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 la colonna o le colonne specificate.
Table.Pivot	Data una coppia di colonne che rappresentano coppie attributo-valore, trasforma i dati della colonna degli attributi in intestazioni di colonna.
Table.PrefixColumns	Restituisce una tabella in cui tutte le colonne sono state precedute dal testo specificato.
Table.PromoteHeaders	Promuove la prima riga di valori come nuove intestazioni di colonna, ovvero come nomi di colonna.
Table.RemoveColumns	Rimuove le colonne specificate.
Table.ReorderColumns	Restituisce una tabella con le colonne nell'ordine specificato.
Table.RenameColumns	Restituisce una tabella con le colonne rinominate come specificato.
Table.SelectColumns	Restituisce una tabella con solo le colonne specificate.
Table.TransformColumnNames	Trasforma i nomi di colonna usando la funzione specificata.
Table.Unpivot	Converte un set di colonne in una tabella in coppie attributo-valore.
Table.UnpivotOtherColumns	Converte tutte le colonne diverse da un set specificato in coppie attributo-valore.

Trasformazione

Nome	Descrizione
Table.AddColumn	Aggiunge una colonna con il nome specificato. Il valore viene calcolato usando la funzione di selezione specificata con ogni riga presa come input.
Table.AddFuzzyClusterColumn	Aggiunge una nuova colonna con valori rappresentativi ottenuti dai valori di raggruppamento fuzzy della colonna specificata nella tabella.
Table.AddIndexColumn	Aggiunge una colonna con valori di posizione espliciti.
Table.AddJoinColumn	Esegue un join tra tabelle nelle colonne fornite e produce il risultato del join in una nuova colonna.
Table.AddKey	Aggiunge una chiave a una tabella.
Table.AggregateTableColumn	Aggrega una colonna di tabelle in più colonne della tabella contenitore.
Table.CombineColumns	Combina le colonne specificate in una nuova colonna usando la funzione combinatore specificata.
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	Propaga il valore di una cella precedente alle celle con valori Null sotto nella colonna.
Table.FillUp	Propaga il valore di una cella alle celle con valori Null sopra riportate nella colonna.
Table.FilterWithDataTable	Questa funzione è solo per uso interno.
Table.FuzzyGroup	Raggruppa le righe nella tabella in base alla corrispondenza fuzzy delle chiavi.
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.Group	Raggruppa le righe nella tabella con la stessa chiave.
Table.Join	Unisce le righe delle due tabelle corrispondenti in base alle chiavi indicate.
Table.Keys	Restituisce le chiavi della tabella specificata.
Table.NestedJoin	Esegue un join tra tabelle nelle colonne fornite e produce il risultato del join 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 un valore con un altro nelle colonne specificate.
Table.Split	Divide la tabella specificata in un elenco di tabelle usando le dimensioni di pagina specificate.
Table.SplitColumn	Suddivide le colonne specificate in un set di colonne aggiuntive usando la funzione splitter specificata.
Table.TransformColumns	Trasforma i valori di una o più colonne.
Table.TransformColumnTypes	Applica trasformazioni di tipo della forma { colonna, tipo } usando una cultura specifica.
Table.TransformRows	Trasforma le righe della tabella utilizzando la funzione di trasformazione specificata.
Table.Transpose	Trasforma le colonne in righe e righe in colonne.

Appartenenze

Nome	Descrizione
Table.Contains	Indica se il record specificato viene visualizzato come riga nella tabella.
Table.ContainsAll	Indica se tutti i record specificati vengono visualizzati come righe nella tabella.
Table.ContainsAny	Indica se uno dei record specificati viene visualizzato come righe nella tabella.
Table.Distinct	Rimuove le righe duplicate dalla tabella.
Table.IsDistinct	Indica se la tabella contiene solo righe distinte (nessun duplicato).
Table.PositionOf	Restituisce la posizione o le posizioni della riga all'interno della tabella.
Table.PositionOfAny	Restituisce la posizione o le posizioni di una delle righe specificate all'interno della tabella.
Table.RemoveMatchingRows	Rimuove tutte le occorrenze delle righe specificate dalla tabella.
Table.ReplaceMatchingRows	Sostituisce tutte le righe specificate con la riga o le righe specificate.

Creazione dell'ordine

Nome	Descrizione
Table.AddRankColumn	Aggiunge una colonna con la classificazione di una o più colonne.
Table.Max	Restituisce la riga più grande o il valore predefinito utilizzando i criteri specificati.
Table.MaxN	Restituisce la riga o le righe più grandi utilizzando i criteri specificati.
Table.Min	Restituisce la riga più piccola o un valore predefinito utilizzando i criteri specificati.
Table.MinN	Restituisce la riga o le righe più piccole utilizzando i criteri specificati.
Table.Sort	Ordina la tabella utilizzando uno o più nomi di colonna e criteri di confronto.

Altro

Nome	Descrizione
Table.Buffer	Bufferizza una tabella in memoria, isolandola da modifiche esterne durante la valutazione.
Table.StopFolding	Impedisce l'esecuzione di operazioni downstream sull'origine originale dei dati.

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 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, consulta la 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, consulta la descrizione di Table.Distinct.