Leggere in inglese

Condividi tramite


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 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 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 colonne usando una funzione combinatore 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 di tabelle, 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 gli esempi, vai alla descrizione di Table.Distinct.